# Docs Index

This directory is the repository knowledge base for both humans and agents.
Start here, then navigate to focused docs.

## Core Maps

- [`../AGENTS.md`](../AGENTS.md): short entrypoint and execution checklist.
- [`ARCHITECTURE.md`](ARCHITECTURE.md): package boundaries and request/data flow.
- [`COMMAND_SURFACE.md`](COMMAND_SURFACE.md): command families, source files, and update obligations.
- [`GOLDEN_PRINCIPLES.md`](GOLDEN_PRINCIPLES.md): legibility standards and anti-patterns.

## Historical Execution Artifacts

- `2026-04-03-clinic-cli-implementation-plan.md`
- `2026-04-03-clinic-cli-progress-log.md`
- `2026-04-21-diagnose-plan.md`
- `2026-04-22-diagnose-evidence-bundle-plan.md`

These historical docs capture how the initial CLI was built. Keep them for traceability, but use the core maps above for current behavior.

## Update Rules

When behavior changes:

1. update code and tests first,
2. update the smallest relevant doc,
3. ensure `make legibility-check` and `make verify` pass.