레이어 아키텍처 그래프

이 페이지는 손으로 그린 다이어그램이 아닙니다. Understand-Anything가 저장소를 정적 분석해 만든 지식 그래프에서, 파일 수준 노드를 14개 레이어로 묶고 imports 엣지만 레이어 간으로 집계한 결과입니다. 원본 그래프는 노드 14,555개로 커서 페이지에 싣지 않고, 집계 스크립트가 만든 소형 JSON (src/data/geode/layer-graph.json) 하나만 소비합니다.

노드 크기는 레이어의 파일 수, 엣지 굵기는 두 레이어 사이의 import 횟수입니다. 방향은 접었고(양방향 합), 가장 굵은 5개만 금색으로 라벨을 답니다. 같은 레이어 안의 import는 레이어 간 그래프에서 빠집니다.

가장 굵은 의존 5개

1. 207 — Self Improving And Seed Generation ↔ Tests
2. 205 — Agent Runtime ↔ Tests
3. 141 — LLM And Prompts ↔ Tests
4. 109 — Config Auth Observability ↔ Tests
5. 105 — Memory Hooks Wiring ↔ Tests

다섯 개가 모두 Tests에 걸립니다. 이것은 데이터 아티팩트가 아니라 구조입니다. 테스트 스위트는 각 런타임 레이어를 직접 import하므로, 레이어 간 import 그래프에서 가장 넓게 뻗는 노드가 됩니다.

허브와 고립 레이어

• Tests (0 인 / 976 아웃) — Widest importer: the test suite reaches into every runtime layer (imports-out only, nothing imports the tests back).
• Agent Runtime (241 인 / 125 아웃) — Runtime hub: the most-imported code layer — the agentic loop and its result model that the other runtime layers depend on.
• Public Site (258 파일, 0 엣지) — No cross-layer import edges: it connects through prose references and the build, not through Python imports.
• Architecture Docs (70 파일, 0 엣지) — No cross-layer import edges: it connects through prose references and the build, not through Python imports.
• Research Audit Docs (135 파일, 0 엣지) — No cross-layer import edges: it connects through prose references and the build, not through Python imports.

레이어별 수치

스냅숏 2026-07-03. Files = 분석된 파일 수, In/Out = 레이어 간 import, Cross-degree = In+Out.

읽기 투어 (7단계)

그래프의 tour는 저장소를 처음 여는 사람에게 권하는 읽기 순서입니다. 정체성 문서에서 시작해 실행 루프, 도구, 프롬프트/프로바이더, 배선, 감사 플러그인을 지나 공개 사이트에서 끝납니다.

1. Project Identity. Start with the public README and runtime identity documents to understand what GEODE is.
   doc: README.mddoc: GEODE.mddoc: AGENTS.md
2. Agentic Loop. Follow the core while(tool_use) execution loop and its result model.
   src: core/agent/loop/agent_loop.pysrc: core/agent/loop/models.pysrc: core/agent/loop/_context.pysrc: core/agent/loop/_response.py
3. Tool Execution. Inspect tool processing, approval gates, result serialization, and native tool registry surfaces.
   src: core/agent/tool_executor/processor.pysrc: core/agent/tool_executor/executor.pysrc: core/tools/registry.pyconfig: core/tools/definitions.json
4. Prompt And Provider Stack. Review prompt assembly and provider adapters that turn runtime state into model calls.
   src: core/llm/prompt_assembler.pysrc: core/llm/providers/anthropic.pysrc: core/llm/providers/openai.pysrc: core/llm/providers/glm.py
5. Memory, Hooks, And Wiring. See how context, lifecycle events, bootstrap, IPC, and gateway execution surround the loop.
   src: core/memory/context.pysrc: core/hooks/system.pysrc: core/wiring/container.py
6. Petri Audit Extension. Explore the plugin that evaluates GEODE behavior with Petri-style alignment audits.
   src: plugins/petri_audit/runner.pysrc: plugins/petri_audit/cli_audit.py
7. Public Site. Inspect the Next.js site, generated source-of-truth data, diagrams, and docs surface.
   src: site/src/data/geode/sot.tssrc: site/src/app/docs/architecture/agentic-loop/page.tsxsrc: site/src/components/geode/agentic-loop-diagram.tsx

이 지도는 어떻게 생성되나

Generated with Understand-Anything v2.8.1 from HEAD b742381, 2026-07-03

재생성은 두 단계입니다. 먼저 Understand-Anything v2.8.1로 저장소를 다시 스캔해 .understand-anything/knowledge-graph.json를 갱신하고, 이어서 사이트에서 집계 스크립트를 돌립니다. 그래프 원본은 로컬에서만 생성되며 커밋하지 않습니다(worktree에서는 KG_JSON로 절대 경로를 넘깁니다).

# 1. rescan (Understand-Anything v2.8.1) -> .understand-anything/knowledge-graph.json
# 2. aggregate into the small JSON + the deck SVG:
KG_JSON=/abs/.understand-anything/knowledge-graph.json npm run build-layer-graph

같은 집계에서 덱용 라이트 팔레트 SVG도 함께 만들어져 public/diagrams/layer-graph-deck-light.svg에 저장됩니다.

더 읽을거리

• 아키텍처 심화. 레이어를 가로지르는 데이터 흐름.
• 시스템 색인. 모든 서브시스템과 파일 경로의 평면 카탈로그.
• 왜 5계층인가. 경계가 왜 그 자리에 있는지.