docs/ index — read this first
Single entry point. Knowledge was scattered across AGENTS.md, skills,
memories, and docs/ with no map; this is the map.
Read at session start (always)
| What | Where | Why |
|---|---|---|
| Engineering workflow, worktrees, git/PR rules, red lines, skill index | AGENTS.md | Canonical agent instructions. Authoritative. |
| Definition of Done — objective probe or not done | docs/DEFINITION_OF_DONE.md | The hard rule. Most-violated thing historically. |
| Claude-specific notes | CLAUDE.md | Auto-loaded; commit-attribution, worktree caveats |
When you hit a specific situation
| Situation | Go to |
|---|---|
| Marking a CAS done / reviewing a “done” | docs/DEFINITION_OF_DONE.md (probe required; verification reflexes) |
| “How did X go so wrong” — recognize a failure shape | docs/postmortems/ |
| Tech stack, architecture | docs/tech-stack.md, docs/architecture/ |
| Testing / smoke | docs/testing-strategy.md, skill casaconomy-smoke-test |
| UX rules, audits | docs/ux/, docs/ux-audits/ |
| Release / TestFlight | docs/release/ |
| A feature’s design intent | docs/features/ |
| Cloudflare (DNS/R2/D1/Workers) | skill casaconomy-cloudflare, …/references/zone.md |
| Hiring an agent | docs/hire/ |
Postmortems (recognize the shape before repeating it)
2026-05-multidevice-sync.md— three backends “done”, none deployed; phantom/fabricated close-outs; what controls actually worked (objective close-gate).
Hard rules / red lines (full list in AGENTS.md §“Red lines”)
- Objective probe required to close a CAS —
docs/DEFINITION_OF_DONE.md - Never auto-revert a reopen — AGENTS.md (commit
3d348450) - No engineering in the main clone — use worktrees; main clone is filesystem-locked for non-Saga (CAS-3062)
- No
worktrees/CAS-*paths in long-lived ops (launchd plists, daemons, cron) — CAS-2949
Memories vs docs
Durable cross-session lessons live in Saga’s memory (MEMORY.md index).
Project-shared rules live here / in AGENTS.md. If a lesson is shared and
load-bearing, it belongs in AGENTS.md or here — not only in memory,
because only Saga loads memory.
Meta-lesson (the postmortem’s core): unread/unenforced docs do not change behaviour. Keep this index short so it is actually read; keep the Definition of Done enforced, not advisory.