개요설명

GEODE 소개

안쪽의 agentic 루프로 일을 처리하고, 바깥쪽 루프로 스스로를 개선하는 자율 실행 에이전트입니다. 무엇을 하는지, 누구를 위한 것인지, 다음에 어디로 갈지 안내합니다.

이 문서의 목차
  1. 작업을 수행하는 하네스. 실행을 연구하는 루프.
  2. 시작하기
  3. 사용과 확장
  4. 설정과 운영
  5. 런타임과 연구
  6. 전체 문서
  7. 서로 다른 책임, 연결된 근거

작업을 수행하는 하네스. 실행을 연구하는 루프.

Autonomous Agent Harness에서는 모델이 도구 관측을 읽고 다음 행동을 선택합니다. Experimental Loop에서는 scaffold 후보와 평가 시나리오를 생성·측정하고, 채택과 복원을 관리합니다.

자율 수행의 구조 / Experimental Loop의 연구와 근거

시작하기

GEODE를 설치하고 프로바이더를 선택해 첫 작업을 실행합니다.

사용과 확장

명령을 찾고 작업을 예약하거나 도구를 추가합니다.

설정과 운영

자격 증명과 서비스를 설정하고 비용과 실행 오류를 확인합니다.

런타임과 연구

자율 수행 하네스와 Experimental Loop 연구의 설계·관측·근거를 확인합니다.

전체 문서

분야를 선택하거나 제목·요약·경로로 문서를 찾으세요.

서로 다른 책임, 연결된 근거

런타임은 모델이 관측에서 다음 행동을 선택하도록 도구, 컨텍스트, 실행 제어를 제공합니다. 평가 계층은 실행 기록과 과제 verifier를 읽고, 실험 계층은 제한된 후보의 채택·복원을 관리합니다. 일반 작업이 끝났다는 사실과 개선 후보가 검증됐다는 사실은 다릅니다.

가중치 고정 scaffold 탐색과 시나리오 생성, 판정 모델 연구를 실제 산출물로 확인하세요. SelfSearch와 DGM은 탐색 대상과 피드백 경계를 비교할 연구이며, 동일 방법이나 재현 성과로 묶지 않습니다.

개요

  • GEODE 소개안쪽의 agentic 루프로 일을 처리하고, 바깥쪽 루프로 스스로를 개선하는 자율 실행 에이전트입니다. 무엇을 하는지, 누구를 위한 것인지, 다음에 어디로 갈지 안내합니다.
  • GEODE가 작업을 처리하는 흐름요청 하나가 처음부터 끝까지 어떻게 흐르는지 따라갑니다. CLI 작업, 게이트웨이 메시지, 예약된 자기개선 실행이 모두 같은 코어를 지납니다.
  • 5-계층 스택Model, Runtime, Harness, Agent, Self-Improving. 각 계층이 무엇을 맡고, 책임이 어디서 끝나는지 설명합니다.

시작하기

  • 빠른 시작GEODE를 설치하고 몇 분 안에 첫 작업을 실행합니다.
  • 경로 선택구독, API 키, 무료 경로 중에서 상황에 맞는 것을 고르는 방법입니다.
  • 프로바이더 설정Anthropic, OpenAI, GLM의 자격 증명 위치와 ChatGPT 구독 OAuth, 폴백 체인을 다룹니다.
  • 데몬으로 실행serve를 시작하고 재시작하고 종료합니다. thin CLI가 IPC로 동작하는 런타임과 통신합니다.
  • 선택: Google Workspace직접 소유한 Google Desktop OAuth 클라이언트로 Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts를 선택적으로 연결합니다.

핵심 개념

  • 두 개의 루프나머지 문서가 기대는 멘탈 모델입니다. 안쪽 agentic 루프가 작업을 처리하고, 바깥쪽 루프가 작업을 처리하는 시스템 자체를 다듬습니다.
  • 안쪽 agentic 루프while(tool_use) 기본 단위입니다. 한 턴이 어떻게 돌고, 어떤 경로로 끝나는지 설명합니다.
  • 컨텍스트 조립모든 LLM 호출의 컨텍스트가 여기서 만들어집니다. 메모리 계층과 프롬프트 레이어를 토큰 예산 안에서 합칩니다.
  • 메모리 계층raw 세션 로그에서 LLM에 바로 넣을 수 있는 요약까지. 계층 override와 예산 인식 압축을 다룹니다.
  • 프롬프트 조립매 호출 전에 시스템 프롬프트가 어떻게 층층이 조립되는지 설명합니다.
  • 도구와 툴셋도구 레지스트리와 지연 로딩입니다. 일부 도구는 미리 로드하고, 나머지는 필요할 때 가져옵니다.
  • 훅과 미들웨어버전이 고정된 공개 hook ABI, 네 개의 신뢰 실행 결합점, 분리된 내부 runtime-event 평면입니다.
  • LLM 라우팅프로바이더 선택과 모델 해석입니다. 폴백 체인은 기본 비활성으로 출하되고, 치명 오류는 재시도 없이 빠르게 실패합니다.
  • 도구 호출GEODE가 도구를 노출하고, tool choice를 변환하고, 호출을 실행한 뒤 결과를 다음 턴에 되돌리는 계약입니다.
  • 구조화 출력GEODE의 JSON Schema 계약, adapter별 배선, strictness 규칙, worker 검증과 재시도 경계입니다.
  • 서브에이전트 오케스트레이션서브에이전트를 격리된 워커 프로세스로 병렬 레인에서 띄웁니다. 부모는 요약만 받고, 쓰기 권한은 툴킷 구성으로 통제합니다.
  • 스킬도구와 구분되는, 사용자가 호출하는 스킬입니다. 발견, 라이프사이클, override를 다룹니다.

Experimental Loop

  • 하네스, 실험, 그리고 근거Scaffold Search, Seed Scenario Generation, SIL, Jev의 질문·설계·관측·한계. SelfSearch·DGM과의 방법 차이를 구분합니다.
  • 스캐폴드 탐색스캐폴드를 변이하고 Petri로 측정한 뒤, 불확실성을 고려한 fitness margin으로 승격하거나 되돌립니다. 모델 가중치는 바꾸지 않습니다.
  • Seed Scenario Generation평가용 scenario corpus를 키우는 9-역할 생성 루프입니다. supervisor, literature review, generator, proximity, critic, pilot, ranker, evolver, meta-reviewer로 이어집니다.
  • Seed 파이프라인세대마다 seed 코퍼스를 다시 구성합니다. picker, orchestrator, manifest, 비용 미리보기와 frontier-band 생존자 선택을 다룹니다.
  • Crucible 제한형 탐색동결된 admission, paired 평가, CAS 전진, 별도 sealed-test 경계를 갖춘 제한형 private search 루프입니다.
  • 검증과 평가런타임 수락, 과제 verifier, Petri LLM-as-a-judge, 사람과의 보정, Inspect .eval 기록의 권한을 구분합니다.
  • Petri × GEODEAnthropic Alignment Science의 평가 프레임워크를 GEODE 에이전트 위에 얹어 루프의 측정 계층으로 씁니다.
  • 시나리오Petri seed 코퍼스에 GEODE 전용 seed를 더해 critical, auxiliary, info 차원 버킷으로 묶습니다.
  • 감사 실행geode-eval audit, 또는 raw 경로인 inspect eval을 씁니다. 모델 역할, 차원 세트, seeds, 턴 예산을 고릅니다. 기본은 dry-run입니다.
  • Judge 차원22개 judge 차원의 점수 방향과 사람의 라벨을 통한 보정, 별도 18개 차원의 fitness 선택 정책을 설명합니다.
  • Seed 생성 런세대별 대시보드입니다. 런마다 생존 후보, 토큰, 메타리뷰, 다음 세대 prior를 보여줍니다.
  • 계보와 좌표이 루프가 self-evolving agents 문헌에서 어디에 위치하는지 짚습니다. 새로운 primitive가 아니라, 알려진 조각들을 정직하게 재조합한 결과입니다.
  • 감사 트랜스크립트공개된 번들 스냅샷에 포함된 감사 트랜스크립트를 확인합니다. 새 실행 기록은 별도로 게시해야 합니다.

GEODE 운영

  • Serve와 게이트웨이serve 데몬의 메신저 게이트웨이를 운영합니다. poller, binding 라우팅, lane queue를 다룹니다.
  • 메신저 연동게이트웨이 어댑터로 GEODE를 Slack, Discord, Telegram에 연결합니다.
  • 작업 예약자연어와 cron을 jitter와 함께 씁니다. 일일 리포트를 명령 한 줄로 예약합니다.
  • 스케줄러 내부예약된 작업이 어떻게 파싱되고 저장되고 실행되는지 설명합니다.
  • 라이프사이클Bootstrap, serve, shutdown. 주입 순서와 cold-start lazy arc를 다룹니다.
  • 장기 실행 안전라운드, 시간, 비용 가드와 컨텍스트 오버플로 사다리입니다. 긴 실행이 어떻게 정직하게 끝나는지 다룹니다.
  • 비용 모니터링세션과 월간 예산입니다. 사용량 ledger, geode history, /cost를 다룹니다.
  • 관측성SQLite 정본 session history, bounded runtime telemetry, portable JSONL projection, 검증된 trajectory를 구분합니다.
  • 문제 해결흔한 실패 모드와 살펴볼 곳입니다. 로그, 훅, runlog를 봅니다.

벤치마크

  • GEO 가시성고정 workload와 digest-bound receipt로 F/R/C/P/A/Q/O를 분리 측정하며 단일 GEO 점수를 만들지 않는 계약입니다.
  • Terminal-Bench 2.1GPT-5.6 Sol·max effort로 Harbor에서 GEODE와 native Codex를 비교한 실험입니다. 대응 결과, 제외 기준, 불확실성과 고정된 공개 증거를 함께 읽습니다.
  • Tau2GEODE의 tau2-bench 실측입니다. native user-simulator 트랙 headline, verifier-backed run 기록 전체, 원본 simulation 로그 링크를 담습니다.
  • MCPMarkGEODE의 MCPMark 실측입니다. Verified available-services headline, 서비스 coverage와 blocker, run 기록 전체, 원본 run 로그 링크를 담습니다.

가이드

  • 도구 작성도구를 정의하고 등록한 뒤 권한 정책으로 게이트를 거는 방법입니다.
  • 훅과 미들웨어 등록가장 좁은 권한을 고르고 공유 인스턴스 하나를 등록한 뒤 프로덕션 경계의 timeout과 실패 동작을 검증합니다.
  • Trajectory 게시정본 session history를 export하고 공개 후보를 검토한 뒤 immutable release와 원격 read-back을 검증합니다.
  • LLM 어댑터 추가어댑터 프로토콜을 구현해 레지스트리에 등록하고 모델을 라우팅하는 방법입니다.
  • 바인딩 설정메신저 채널을 자체 모델과 정책을 가진 세션 레인으로 라우팅하는 방법입니다.
  • 멈춘 실행 디버깅트랜스크립트와 runlog를 읽어 실행이 멈춘 지점을 찾고 복구하는 방법입니다.

설정

  • 설정 기초설정이 어디에 있고, 어떻게 로드되고, override가 어떻게 결정되는지 설명합니다.
  • config.toml 레퍼런스영역별로 묶은 모든 설정 키입니다. Settings 필드, routing.toml, self-improving 루프 섹션을 다룹니다.
  • 인증과 OAuth자격 소스, /login OAuth 프로파일, Codex 토큰 감지, API 키가 사는 곳을 다룹니다.
  • OAuth 토큰 회전프로바이더 전반의 갱신 정책과 쿨다운을 다룹니다.
  • 시스템 프롬프트 모드기본 ON persona 주입과 audit-mode strip입니다. 시스템 프롬프트가 변형되는 두 가지 방식입니다.
  • 프롬프트 캐싱static과 dynamic 경계, ephemeral 캐시 제어를 다룹니다.
  • 프롬프트 해싱의도하지 않은 drift가 생기면 빌드를 깨뜨리는 프롬프트 해시 핀입니다.
  • MCP 서버MCP의 양면입니다. 외부 서버를 붙이는 클라이언트와 GEODE가 출하하는 서버 geode-mcp를 다룹니다.

레퍼런스

  • 프론티어 비교GEODE가 Claude Code, Codex CLI, OpenClaw, Hermes에서 무엇을 빌려오고, 어디서 갈라지는지 정리합니다. 계보 속 GEODE의 좌표를 짚는 레퍼런스 진입점입니다.
  • 외부 참고GEODE가 인용하는 frontier 에이전트 시스템, 디자인 표준, 선행 작업입니다. 루프 뒤에 있는 self-evolving agents 계보입니다.
  • 메타 하네스 카탈로그확률적 런타임을 수렴시키는 메커니즘 전체를 Context Control, Plan and Execute, Verify, Observe, 그리고 GEODE 자신을 제작하는 Scaffold 다섯 부문으로 정리합니다. 코드 검증을 거쳐 제어 지점과 경로를 담습니다.
  • CLI와 슬래시 명령전체 레퍼런스입니다. 모든 geode 명령, thin/daemon 라우팅이 붙은 슬래시 명령, geode-mcp 표면까지 다룹니다.
  • 리서치·탐색과 llms.txtGEODE의 탐색 방법입니다. llms.txt 우선 문서 리서치, 웹 검색 위임, 로컬 FTS 검색, 그리고 이 사이트가 발행하는 llms.txt를 다룹니다.
  • 자동 트리거 사이드카자기개선 루프를 cron으로 발화하는 사이드카입니다. 락, 인터벌 게이트, 훅 텔레메트리를 다룹니다.
  • 컴퓨터 사용도구 하나 뒤의 로컬 데스크탑 자동화입니다. pyautogui 하네스와 항상 HITL인 안전 분류를 다룹니다.
  • CLI LaTeX 렌더링터미널에서 수식을 렌더링합니다. 감지, Unicode 평탄화, 2D pretty print와 원문 폴백을 다룹니다.
  • CHANGELOGmain push마다 CHANGELOG.md에서 동기화되는 전체 버전 이력입니다.
  • Petri 번들 격리publish 워크플로우, validator, hygiene ratchet의 운영자 레퍼런스입니다.

개발과 아키텍처

코드베이스 지도

  • 레이어 아키텍처 그래프저장소를 특정 시점에 스냅숏한 지도입니다. 분석된 14개 레이어를 파일 수 크기로, 레이어를 가로지르는 import 의존을 엣지로 그리고, 7단계 읽기 투어를 덧붙입니다. 손으로 그린 것이 아니라 Understand-Anything가 만든 것입니다.

GEODE 저장소의 문서 사이트에서 옮겨 온 문서입니다. 원문 커밋 de077a4 · GitHub에서 원문 보기