# GEODE

GEODE v0.99.87. A self-evolving autonomous execution agent.
스스로 진화하는 자율 실행 에이전트.

Last sync: 2026-05-29

---

### What GEODE is (GEODE 소개)
URL: https://mangowhoiscloud.github.io/geode/docs
EN: An autonomous execution agent that runs an inner agentic loop and improves itself through an outer loop. What it does, who it is for, where to go next.
KO: 안쪽의 agentic 루프로 일을 처리하고, 바깥쪽 루프로 스스로를 개선하는 자율 실행 에이전트입니다. 무엇을 하는지, 누구를 위한 것인지, 다음에 어디로 갈지 안내합니다.

### How GEODE runs a task (GEODE가 작업을 처리하는 흐름)
URL: https://mangowhoiscloud.github.io/geode/docs/overview/how-it-runs
EN: One request, traced end to end. The same core serves a CLI task, a gateway message, and a scheduled self-improving run.
KO: 요청 하나가 처음부터 끝까지 어떻게 흐르는지 따라갑니다. CLI 작업, 게이트웨이 메시지, 예약된 자기개선 실행이 모두 같은 코어를 지납니다.

### The 4-layer stack (4-계층 스택)
URL: https://mangowhoiscloud.github.io/geode/docs/architecture/overview
EN: Model, Runtime, Harness, Agent. What each layer owns, and where its responsibility ends.
KO: Model, Runtime, Harness, Agent. 각 계층이 무엇을 맡고, 책임이 어디서 끝나는지 설명합니다.

### Quick Start (빠른 시작)
URL: https://mangowhoiscloud.github.io/geode/docs/quick-start
EN: Install GEODE and run your first task in a few minutes.
KO: GEODE를 설치하고 몇 분 안에 첫 작업을 실행합니다.

### Pick a path (경로 선택)
URL: https://mangowhoiscloud.github.io/geode/docs/run/pick-path
EN: Subscription, API key, or free path. How to choose for your situation.
KO: 구독, API 키, 무료 경로 중에서 상황에 맞는 것을 고르는 방법입니다.

### Configure providers (프로바이더 설정)
URL: https://mangowhoiscloud.github.io/geode/docs/run/providers
EN: Anthropic, OpenAI, Codex, GLM. Where keys go, and what fallback chain you get.
KO: Anthropic, OpenAI, Codex, GLM. 키를 어디에 두는지, 어떤 폴백 체인이 동작하는지 다룹니다.

### Run as a daemon (데몬으로 실행)
URL: https://mangowhoiscloud.github.io/geode/docs/run/serve
EN: Start, restart, and stop serve. A thin CLI talks to an IPC-served runtime.
KO: serve를 시작하고 재시작하고 종료합니다. thin CLI가 IPC로 동작하는 런타임과 통신합니다.

### The two loops (두 개의 루프)
URL: https://mangowhoiscloud.github.io/geode/docs/concepts/two-loops
EN: The mental model the rest of the docs build on. An inner agentic loop runs a task; an outer loop tunes the system that runs tasks.
KO: 나머지 문서가 기대는 멘탈 모델입니다. 안쪽 agentic 루프가 작업을 처리하고, 바깥쪽 루프가 작업을 처리하는 시스템 자체를 다듬습니다.

### The inner agentic loop (안쪽 agentic 루프)
URL: https://mangowhoiscloud.github.io/geode/docs/architecture/agentic-loop
EN: The while(tool_use) primitive. How a turn runs, and the paths that end it.
KO: while(tool_use) 기본 단위입니다. 한 턴이 어떻게 돌고, 어떤 경로로 끝나는지 설명합니다.

### Context assembly (컨텍스트 조립)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/context
EN: Every LLM call's context is built here. Memory tiers plus prompt layers, under a token budget.
KO: 모든 LLM 호출의 컨텍스트가 여기서 만들어집니다. 메모리 계층과 프롬프트 레이어를 토큰 예산 안에서 합칩니다.

### Memory tiers (메모리 계층)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/memory/5-tier
EN: From a raw session log to a single LLM-ready summary. Hierarchical override, budget-aware compression.
KO: raw 세션 로그에서 LLM에 바로 넣을 수 있는 요약까지. 계층 override와 예산 인식 압축을 다룹니다.

### Prompt assembly (프롬프트 조립)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/llm/prompt-system
EN: How the system prompt is layered and assembled before each call.
KO: 매 호출 전에 시스템 프롬프트가 어떻게 층층이 조립되는지 설명합니다.

### Tools and toolsets (도구와 툴셋)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/tools/protocol
EN: The tool registry and deferred loading. A few tools load up front, the rest are fetched on demand.
KO: 도구 레지스트리와 지연 로딩입니다. 일부 도구는 미리 로드하고, 나머지는 필요할 때 가져옵니다.

### Hooks and observability (훅과 관측성)
URL: https://mangowhoiscloud.github.io/geode/docs/harness/hooks
EN: Lifecycle events that handlers subscribe to. How observe, react, decide, and act stack on one event.
KO: 핸들러가 구독하는 라이프사이클 이벤트입니다. 하나의 이벤트 위에 observe, react, decide, act가 어떻게 쌓이는지 설명합니다.

### LLM routing (LLM 라우팅)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/llm/providers
EN: Provider selection and fallback. Circuit breakers when a provider is unhealthy.
KO: 프로바이더 선택과 폴백입니다. 프로바이더가 불안정할 때 동작하는 회로 차단기를 포함합니다.

### Sub-agent orchestration (서브에이전트 오케스트레이션)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/orchestration
EN: Spawning isolated sub-agents in parallel lanes, with snapshotted memory and merge on completion.
KO: 격리된 서브에이전트를 병렬 레인에서 띄웁니다. 메모리를 스냅샷으로 넘기고 완료 시 병합합니다.

### Skills (스킬)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/skills
EN: User-invocable skills, distinct from tools. Discovery, lifecycle, override.
KO: 도구와 구분되는, 사용자가 호출하는 스킬입니다. 발견, 라이프사이클, override를 다룹니다.

### The closed loop (폐루프)
URL: https://mangowhoiscloud.github.io/geode/docs/capabilities/autoresearch
EN: The outer loop end to end. Mutate a policy, audit with Petri, attribute the result, then promote or revert.
KO: 바깥쪽 루프의 전체 흐름입니다. 정책을 변형하고, Petri로 감사하고, 결과를 귀속하고, 승격하거나 되돌립니다.

### Co-scientist seed generation (Co-scientist seed 생성)
URL: https://mangowhoiscloud.github.io/geode/docs/capabilities/co-scientist
EN: A multi-role agent loop that grows the evaluation seed corpus. Supervisor, generator, critic, pilot, ranker, evolver, meta-reviewer.
KO: 평가용 seed 코퍼스를 키우는 다중 역할 에이전트 루프입니다. supervisor, generator, critic, pilot, ranker, evolver, meta-reviewer로 이어집니다.

### Seed pipeline (Seed 파이프라인)
URL: https://mangowhoiscloud.github.io/geode/docs/capabilities/seed-pipeline
EN: The plugin that regenerates the seed corpus each generation. Picker, orchestrator, manifest, cost preview.
KO: 세대마다 seed 코퍼스를 다시 만드는 플러그인입니다. picker, orchestrator, manifest, cost preview로 구성됩니다.

### Outer-loop configuration (아우터 루프 설정)
URL: https://mangowhoiscloud.github.io/geode/docs/capabilities/outer-loop
EN: The shared schema and loader for autoresearch, seed pipeline, and Petri thresholds. Strict by default.
KO: autoresearch, seed 파이프라인, Petri 임계값이 공유하는 스키마와 로더입니다. 기본은 strict 모드입니다.

### Petri × GEODE (Petri × GEODE)
URL: https://mangowhoiscloud.github.io/geode/docs/petri/overview
EN: Anthropic Alignment Science's evaluation framework, wrapped over the GEODE agent as the loop's measurement.
KO: Anthropic Alignment Science의 평가 프레임워크를 GEODE 에이전트 위에 얹어 루프의 측정 도구로 씁니다.

### Scenarios (시나리오)
URL: https://mangowhoiscloud.github.io/geode/docs/petri/scenarios
EN: The Petri seed corpus plus GEODE-specific seeds, grouped into critical, auxiliary, and info dimension buckets.
KO: Petri seed 코퍼스에 GEODE 전용 seed를 더해 critical, auxiliary, info 차원 버킷으로 묶습니다.

### Run an audit (감사 실행)
URL: https://mangowhoiscloud.github.io/geode/docs/petri/run
EN: geode audit, or inspect eval for the raw path. Choose model roles, dimension set, seeds, and turn budget.
KO: geode audit, 또는 raw 경로인 inspect eval을 씁니다. 모델 역할, 차원 세트, seeds, 턴 예산을 고릅니다.

### Judge dimensions (Judge 차원)
URL: https://mangowhoiscloud.github.io/geode/docs/petri/judge-dimensions
EN: What each dimension scores, and how to read the heatmap. Critical floors versus auxiliary drift.
KO: 각 차원이 무엇을 평가하는지, heatmap을 어떻게 읽는지 설명합니다. critical 바닥값과 auxiliary drift를 구분합니다.

### Seed-generation runs (Seed 생성 런)
URL: https://mangowhoiscloud.github.io/geode/docs/petri/seeds
EN: The per-generation dashboard. Survivors, tokens, meta-review, and next-generation priors per run.
KO: 세대별 대시보드입니다. 런마다 생존 후보, 토큰, 메타리뷰, 다음 세대 prior를 보여줍니다.

### Lineage and positioning (계보와 좌표)
URL: https://mangowhoiscloud.github.io/geode/docs/capabilities/lineage
EN: Where this loop sits in the self-evolving agents literature. An honest recombination of known parts, not a new primitive.
KO: 이 루프가 self-evolving agents 문헌에서 어디에 위치하는지 짚습니다. 새로운 primitive가 아니라, 알려진 조각들을 정직하게 재조합한 결과입니다.

### Bundle viewer (번들 뷰어)
URL: https://mangowhoiscloud.github.io/geode/docs/petri/bundle
EN: The live inspect_ai transcript viewer for the latest audit run.
KO: 가장 최근 감사 런의 라이브 inspect_ai 트랜스크립트 뷰어입니다.

### Serve and gateway (Serve와 게이트웨이)
URL: https://mangowhoiscloud.github.io/geode/docs/harness/serve-gateway
EN: Operating the serve daemon's messaging gateway. Pollers, binding routing, lane queue.
KO: serve 데몬의 메신저 게이트웨이를 운영합니다. poller, binding 라우팅, lane queue를 다룹니다.

### Messaging integrations (메신저 연동)
URL: https://mangowhoiscloud.github.io/geode/docs/run/messaging
EN: Connect GEODE to Slack, Discord, or Telegram through gateway adapters.
KO: 게이트웨이 어댑터로 GEODE를 Slack, Discord, Telegram에 연결합니다.

### Schedule tasks (작업 예약)
URL: https://mangowhoiscloud.github.io/geode/docs/run/schedule
EN: Natural language and cron, with jitter. A daily report as a single command.
KO: 자연어와 cron을 jitter와 함께 씁니다. 일일 리포트를 명령 한 줄로 예약합니다.

### Scheduler internals (스케줄러 내부)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/scheduler
EN: How scheduled jobs are parsed, persisted, and fired.
KO: 예약된 작업이 어떻게 파싱되고 저장되고 실행되는지 설명합니다.

### Lifecycle (라이프사이클)
URL: https://mangowhoiscloud.github.io/geode/docs/harness/lifecycle
EN: Bootstrap, serve, shutdown. The injection order, and the cold-start lazy arc.
KO: Bootstrap, serve, shutdown. 주입 순서와 cold-start lazy arc를 다룹니다.

### Long-running safety (장기 실행 안전)
URL: https://mangowhoiscloud.github.io/geode/docs/ops/long-running
EN: Token guards, context overflow, and a sliding window. How a long run drains gracefully.
KO: 토큰 가드, 컨텍스트 오버플로, 슬라이딩 윈도입니다. 긴 실행이 어떻게 안전하게 마무리되는지 다룹니다.

### Cost monitoring (비용 모니터링)
URL: https://mangowhoiscloud.github.io/geode/docs/ops/cost
EN: Per-session and per-day budgets. The usage ledger, and when to switch models.
KO: 세션별, 일별 예산입니다. 사용량 ledger와 모델을 바꿀 시점을 다룹니다.

### Troubleshooting (문제 해결)
URL: https://mangowhoiscloud.github.io/geode/docs/run/troubleshooting
EN: Common failure modes and where to look. Logs, hooks, runlog.
KO: 흔한 실패 모드와 살펴볼 곳입니다. 로그, 훅, runlog를 봅니다.

### Write a tool (도구 작성)
URL: https://mangowhoiscloud.github.io/geode/docs/guides/custom-tool
EN: Define a tool, register it, and gate it with a permission policy.
KO: 도구를 정의하고 등록한 뒤 권한 정책으로 게이트를 거는 방법입니다.

### Register a hook (훅 등록)
URL: https://mangowhoiscloud.github.io/geode/docs/guides/register-hook
EN: Subscribe a handler to a lifecycle event and wire it in bootstrap.
KO: 라이프사이클 이벤트에 핸들러를 구독하고 bootstrap에 연결하는 방법입니다.

### Add an LLM adapter (LLM 어댑터 추가)
URL: https://mangowhoiscloud.github.io/geode/docs/guides/llm-adapter
EN: Add a provider to the router and adapter layer, with a fallback entry.
KO: 라우터와 어댑터 레이어에 프로바이더를 추가하고 폴백 항목을 거는 방법입니다.

### Configure a binding (바인딩 설정)
URL: https://mangowhoiscloud.github.io/geode/docs/guides/binding
EN: Route a messaging channel to a session lane with its own model and policy.
KO: 메신저 채널을 자체 모델과 정책을 가진 세션 레인으로 라우팅하는 방법입니다.

### Debug a stuck run (멈춘 실행 디버깅)
URL: https://mangowhoiscloud.github.io/geode/docs/guides/debug-stuck-run
EN: Read the transcript and runlog, find where a run stalled, and recover.
KO: 트랜스크립트와 runlog를 읽어 실행이 멈춘 지점을 찾고 복구하는 방법입니다.

### Configuration basics (설정 기초)
URL: https://mangowhoiscloud.github.io/geode/docs/config/basics
EN: Where configuration lives, how it loads, and how overrides resolve.
KO: 설정이 어디에 있고, 어떻게 로드되고, override가 어떻게 결정되는지 설명합니다.

### config.toml reference (config.toml 레퍼런스)
URL: https://mangowhoiscloud.github.io/geode/docs/config/reference
EN: Every configuration key, grouped by area, marked stable or experimental.
KO: 영역별로 묶은 모든 설정 키입니다. stable과 experimental을 표시합니다.

### Auth and OAuth (인증과 OAuth)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/auth
EN: Profile rotation, the Anthropic ToS path, and the Codex flow.
KO: 프로파일 로테이션, Anthropic ToS 경로, Codex 플로우를 다룹니다.

### OAuth token rotation (OAuth 토큰 회전)
URL: https://mangowhoiscloud.github.io/geode/docs/ops/oauth
EN: Refresh policy and cooldown across providers.
KO: 프로바이더 전반의 갱신 정책과 쿨다운을 다룹니다.

### System prompt modes (시스템 프롬프트 모드)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/llm/system-prompt-modes
EN: The persona opt-in and the audit-mode strip. The two ways the system prompt is reshaped.
KO: persona opt-in과 audit-mode strip입니다. 시스템 프롬프트가 변형되는 두 가지 방식입니다.

### Prompt caching (프롬프트 캐싱)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/llm/prompt-caching
EN: The static and dynamic boundary, and ephemeral cache control.
KO: static과 dynamic 경계, ephemeral 캐시 제어를 다룹니다.

### Prompt hashing (프롬프트 해싱)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/llm/prompt-hashing
EN: Pinned prompt hashes that break the build on unintended drift.
KO: 의도하지 않은 drift가 생기면 빌드를 깨뜨리는 프롬프트 해시 핀입니다.

### MCP servers (MCP 서버)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/tools/mcp
EN: Connecting MCP servers, the result-size guard, and the HTML to Markdown fallback.
KO: MCP 서버 연결, 결과 크기 가드, HTML to Markdown 폴백을 다룹니다.

### CLI and slash commands (CLI와 슬래시 명령)
URL: https://mangowhoiscloud.github.io/geode/docs/harness/cli
EN: The thin gateway and IPC, and the slash commands it accepts.
KO: thin 게이트웨이와 IPC, 그리고 받는 슬래시 명령들입니다.

### Guardrails G1-G4 (가드레일 G1-G4)
URL: https://mangowhoiscloud.github.io/geode/docs/verification/guardrails
EN: Schema, range, grounding, consistency. A fail-fast ladder over LLM output.
KO: Schema, range, grounding, consistency입니다. LLM 출력 위의 fail-fast 사다리입니다.

### BiasBuster (BiasBuster)
URL: https://mangowhoiscloud.github.io/geode/docs/verification/biasbuster
EN: Confirmation, recency, and anchoring detection on top of the guardrails.
KO: 가드레일 위에 얹는 confirmation, recency, anchoring 편향 탐지입니다.

### Cross-LLM verification (Cross-LLM 검증)
URL: https://mangowhoiscloud.github.io/geode/docs/verification/cross-llm
EN: An independent second opinion. A different provider re-scores the verdict.
KO: 독립적인 second opinion입니다. 다른 프로바이더가 판정을 다시 채점합니다.

### Cause decision tree (원인 분류 트리)
URL: https://mangowhoiscloud.github.io/geode/docs/verification/cause-decision-tree
EN: Map a failure cause to a recovery action, instead of blindly retrying.
KO: 무작정 재시도하는 대신, 실패 원인을 복구 행동에 매핑합니다.

### Observability (관측성)
URL: https://mangowhoiscloud.github.io/geode/docs/verification/observability
EN: The lenses on a run. Hooks, runlog, audit diagnostics, Petri.
KO: 실행을 들여다보는 렌즈들입니다. 훅, runlog, audit diagnostics, Petri입니다.

### Automation sidecar (자동화 사이드카)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/automation
EN: The feedback loop and model promotion, with drift detection between agent and runtime.
KO: 피드백 루프와 모델 프로모션입니다. 에이전트와 런타임 사이에서 drift를 감지합니다.

### Computer use (컴퓨터 사용)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/computer-use
EN: Provider-agnostic desktop automation, Anthropic and OpenAI unified.
KO: 프로바이더 독립 데스크탑 자동화입니다. Anthropic과 OpenAI를 통합합니다.

### CLI LaTeX rendering (CLI LaTeX 렌더링)
URL: https://mangowhoiscloud.github.io/geode/docs/runtime/ui/cli-latex
EN: Rendering math in the terminal. Detection, Unicode flatten, pretty print, image fallback.
KO: 터미널에서 수식을 렌더링합니다. 감지, Unicode flatten, pretty print, 이미지 폴백을 거칩니다.

### External references (외부 참고)
URL: https://mangowhoiscloud.github.io/geode/docs/reference/external-references
EN: Frontier agent systems, design standards, and prior work GEODE cites.
KO: GEODE가 인용하는 frontier 에이전트 시스템, 디자인 표준, 선행 작업입니다.

### Frontier comparison (프론티어 비교)
URL: https://mangowhoiscloud.github.io/geode/docs/reference/frontier-comparison
EN: Where GEODE sits next to Claude Code, Codex CLI, OpenClaw, and Hermes.
KO: GEODE가 Claude Code, Codex CLI, OpenClaw, Hermes 옆에서 어디에 위치하는지 비교합니다.

### CHANGELOG (CHANGELOG)
URL: https://mangowhoiscloud.github.io/geode/docs/reference/changelog
EN: Full version history, synced from CHANGELOG.md on every main push.
KO: main push마다 CHANGELOG.md에서 동기화되는 전체 버전 이력입니다.

### Petri bundle isolation (Petri 번들 격리)
URL: https://mangowhoiscloud.github.io/geode/docs/reference/petri-bundle-isolation
EN: Operator reference for the publish workflow, validator, and hygiene ratchet.
KO: publish 워크플로우, validator, hygiene ratchet의 운영자 레퍼런스입니다.

### Architecture deep-dive (아키텍처 심화)
URL: https://mangowhoiscloud.github.io/geode/docs/develop/architecture
EN: The subsystem map and a recommended reading order, retold as data-flow traces.
KO: 서브시스템 지도와 추천 읽기 순서를 데이터 흐름 추적으로 풀어냅니다.

### System index (시스템 색인)
URL: https://mangowhoiscloud.github.io/geode/docs/architecture/system-index
EN: Every subsystem with its file path. The flat catalog.
KO: 모든 서브시스템과 파일 경로입니다. 평면 카탈로그입니다.

### Why four layers (왜 4-계층인가)
URL: https://mangowhoiscloud.github.io/geode/docs/explanation/4-layer
EN: Model, Runtime, Harness, Agent. Why the boundaries fall where they do.
KO: Model, Runtime, Harness, Agent. 경계가 왜 그 자리에 있는지 설명합니다.

### Why a self-hosting harness (왜 self-hosting 하네스인가)
URL: https://mangowhoiscloud.github.io/geode/docs/explanation/self-hosting
EN: The runtime and the build line share primitives. Why that mattered.
KO: 런타임과 빌드 라인이 같은 기본 단위를 공유합니다. 그게 왜 중요했는지 설명합니다.

### Why ratchet discipline (왜 ratchet 규율인가)
URL: https://mangowhoiscloud.github.io/geode/docs/explanation/ratchet
EN: Pinned prompt hashes and a staged CI. The shape that prevents drift.
KO: 프롬프트 해시 핀과 단계별 CI입니다. drift를 막는 형태를 설명합니다.

### Release and PyPI lifecycle (릴리스와 PyPI 라이프사이클)
URL: https://mangowhoiscloud.github.io/geode/docs/ops/release-pypi-lifecycle
EN: The version-bump locations, the release workflow, and the rebuild cadence.
KO: 버전 bump 위치, 릴리스 워크플로우, rebuild 주기를 다룹니다.

### Backlog disposal (백로그 처분)
URL: https://mangowhoiscloud.github.io/geode/docs/ops/backlog-dispose
EN: Retire an idea with a paper trail instead of a silent delete.
KO: 조용히 삭제하는 대신 흔적을 남기며 아이디어를 정리합니다.

