docs: implement issues 0013 and 0014 — LESSONS.md and docs/spec/

Add LESSONS.md as the long-loop feedback log at repo root. Patterns
observed during development graduate to standing rules when three or
more entries appear.

Introduce docs/spec/ as the living spec layer: overview.md (deployed
state) and architecture.md (directory structure, install pipeline,
provider model, governance layer). Refactor docs/VISION.md to goals
and intent only — architecture content moved to docs/spec/architecture.md.

Update CLAUDE.md and CONTEXT.md to reference the new spec files.
Close issues 0013 and 0014. Update ROADMAP and factory integration
note to reflect completion.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-17 10:36:59 +00:00
parent eae5c37b35
commit b55eede1ef
10 changed files with 137 additions and 77 deletions

View File

@@ -21,7 +21,9 @@ This repo is the global AI development configuration repository — the authorit
Read these at the start of every session in this repo:
- `CONTEXT.md` — domain language and principles; challenge any term that conflicts with it
- `docs/VISION.md` — purpose, goals, roadmap, and long-term Management Application vision
- `docs/VISION.md` — purpose, goals, and long-term Management Application vision
- `docs/spec/overview.md` — current deployed state; what works today
- `docs/spec/architecture.md` — current directory structure, install pipeline, provider model
- `docs/ROADMAP.md` — chunk status table and open questions; read this to orient on where work stands
- `docs/ai-constitution.md` — full governance evidence base; read when a governance decision needs justification
- `docs/HUMANS.md` — human practitioner checklist; applies when working with AI tools in this repo