diff --git a/llm.txt b/llm.txt
new file mode 100644
index 0000000..fd1457e
--- /dev/null
+++ b/llm.txt
@@ -0,0 +1,32 @@
+# core/agent — AI Agent Orchestration
+
+> dappco.re/go/agent — Dispatch, monitor, and verify AI agents (Codex, Claude,
+> Gemini) working on sandboxed repositories. MCP server for agent coordination.
+
+## Entry Points
+
+- CLAUDE.md — Agent instructions, build commands, architecture overview
+- pkg/agentic/ — Core orchestration (dispatch, prep, verify, scan, review)
+
+## Package Layout
+
+- cmd/core-agent/ — CLI entry point (97 lines — just core.New + services)
+- pkg/agentic/ — Agent orchestration: dispatch, workspace prep, PR creation, verification
+- pkg/brain/ — OpenBrain memory integration
+- pkg/lib/ — Embedded templates, personas, flows, workspace scaffolds
+- pkg/messages/ — Typed IPC message definitions (12 message types)
+- pkg/monitor/ — Agent monitoring, notifications, completion tracking
+- pkg/setup/ — Workspace detection and scaffolding
+
+## Test Coverage
+
+- 840 tests, 79.9% statement coverage
+- 92% AX-7 (Good/Bad/Ugly) category coverage
+- 14 functions awaiting go-process v0.7.0 for full testability
+- Zero os/exec imports in source — all commands via go-process
+
+## Conventions
+
+Follows RFC-025 Agent Experience (AX) principles.
+Test naming: TestFile_Function_{Good,Bad,Ugly}
+See: https://core.help/specs/RFC-025-AGENT-EXPERIENCE/