# Documentation index

Public project site (GitHub Pages): [index.html](index.html) at https://smadduri9.github.io/codeagent/

| Document | Description |
|----------|-------------|
| [OPERATOR.md](OPERATOR.md) | Run CodeAgent on your repositories (Groq setup, config, commands) |
| [PROGRESS.md](PROGRESS.md) | Build phases, merge status, session evidence |
| [platform-notes.md](platform-notes.md) | macOS vs Linux differences |
| [RUNBOOK.md](RUNBOOK.md) | Operator prompts for phased builds |
| [REPO_SETUP.md](REPO_SETUP.md) | GitHub description, topics, Pages, demo assets |
| [decisions/](decisions/) | Architecture and process decision records |
| [demo/](demo/) | Terminal demo recording (MP4, GIF, poster) |

Repository-level specs (repo root):

| Document | Description |
|----------|-------------|
| [DESIGN.md](../DESIGN.md) | Technical design and invariants |
| [BUILD_PLAN.md](../BUILD_PLAN.md) | Feature plan and acceptance |
| [AGENTS.md](../AGENTS.md) | Contributor and agent rules |

Evaluation:

| Path | Description |
|------|-------------|
| [evals/baselines/replay-40/](../evals/baselines/replay-40/) | Scripted replay baseline (42/42) |
| [evals/baselines/live-core12-partial.md](../evals/baselines/live-core12-partial.md) | Partial live core12 summary |
| [evals/baselines/gate-conclusion.md](../evals/baselines/gate-conclusion.md) | Phase 9 gate conclusion |

Examples:

| Path | Description |
|------|-------------|
| [examples/payment_service/](../examples/payment_service/) | End-to-end demonstration fixture (DESIGN 12.2) |
