first commit

2026-07-30 23:02:00 -04:00
commit fd537ed47e
48 changed files with 3059 additions and 0 deletions
@@ -0,0 +1,36 @@
+# ADR-0010: Documentation as code
+
+- **Status:** Accepted
+- **Date:** 2026-07-30
+
+## Context
+
+Long-lived multi-agent development drifts when docs lag. The project requires three audience-specific trees plus agent governance from day one.
+
+## Decision
+
+Maintain from the first commit:
+
+- `living_docs/` — current truth
+- `developer_docs/` — contributor technical docs
+- `user_docs/` — end-user docs
+- `agent/` — rules, workflow, ADRs, security
+
+Policy: same PR as code; session incomplete without living_docs updates. See `agent/DOCUMENTATION_POLICY.md`.
+
+## Consequences
+
+### Positive
+
+- Continuous onboarding
+- ADRs + living status reduce rework
+
+### Negative / tradeoffs
+
+- Doc volume to maintain
+- Discipline required from AI agents
+
+### Follow-ups
+
+- [x] Phase 0 scaffold
+- [ ] Enforce via PR checklist / review