Architecture decision records
ADRs are grouped by decision boundary so related rules stay together. Each record includes context, decision, alternatives, mechanics, tests, consequences, and revisit triggers. Contracts in ../contracts.md are the shared wire shape.
| ADR | Decision |
|---|---|
| 001 | private, local-first learning system and authority boundaries |
| 002 | iCloud Hacking and Deadwire canonical subtree |
| 003 | host Python/Swift, native Ollama, Docker artifacts + Neo4j |
| 004 | Python domain/orchestration, Swift native extraction |
| 005 | pinned Python packages and resource-bounded Compose |
| 006 | local models, revisions, cache keys, configuration |
| 007 | incremental inventory, OCR, normalization, chunk references |
| 008 | schemas, embeddings, retrieval, review-only merging |
| 009 | artifact API, canonical publication, rebuildable Neo4j |
| 010 | prerequisite planning, ranking, daily practice evidence |
| 011 | recovery, backup, local-only logs, authorized use |
| 012 | fixtures, evaluation gates, coding standards, backlog |