Migrate all docs scattered across hidden folders into docs/: - .compozy/tasks/ → docs/planning/ (PRDs, tech specs, tasks, memory) and docs/adr/ (ADRs by phase) - .specs/ → docs/specs/ (codebase, features, project specs) - .docs/ → docs/legacy/ (legacy reference implementation docs) - .discussions/ → docs/discussions/ (design discussions and open questions) Delete .compozy/, .specs/, .docs/, and .discussions/. Update AGENTS.md: add explicit docs/ location table, hard rule against hidden doc folders, and new AI-assisted development section (context lazy loading, scope control, verification). Update CLAUDE.md: fix .docs/ references to docs/legacy/. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Architecture Decision Records
ADRs document significant architectural decisions — what was decided, why, and what the consequences are. They are immutable once accepted; superseded decisions get a new ADR that references the old one.
Format
# ADR-NNN: Title
**Status**: Proposed | Accepted | Deprecated | Superseded by ADR-XXX
**Date**: YYYY-MM-DD
## Context
What situation prompted this decision? What forces are at play?
## Decision
What was decided, stated clearly and directly.
## Consequences
What becomes easier? What becomes harder? What are the trade-offs?
Index
| ADR | Title | Status |
|---|---|---|
| — | (none yet) | — |