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>

docs/spec/overview.md

@@ -0,0 +1,40 @@
+# Overview
+
+Current deployed state of this repo — what you get if you run `install.sh` today. Updated at the close of each chunk and in the same PR as any behavior change.
+
+*Last updated: 2026-05-17*
+
+## What is deployed
+
+### Skills
+12 skills deployed to `~/.agents/skills/` via `install.sh`. Available as slash commands in Claude Code via `~/.claude/skills/ → ~/.agents/skills/` symlink. All 12 are first-draft placeholders pending rebuild in Chunk 3.
+
+Current skills: `caveman`, `claude-api`, `diagnose`, `grill-me`, `grill-with-docs`, `improve-codebase-architecture`, `init`, `prototype`, `review`, `security-review`, `tdd`, `to-issues`, `to-prd`, `triage`, `update-config`, `write-a-skill`.
+
+### Claude Code configuration
+- `~/.claude/CLAUDE.md` — global config index; always-on rules + content index pointers
+- `~/.claude/core/instructions/` — coding, git, testing, governance instruction files
+- `~/.claude/settings.json` — Claude Code settings
+
+### Governance layer
+`core/instructions/governance.md` loads into every Claude Code session via `@import` in `~/.claude/CLAUDE.md`. Covers: hard prohibitions on secrets and data, data classification tiers, HITL requirements, sycophancy resistance, deterministic execution preference.
+
+## What works end-to-end
+
+- `install.sh` runs idempotently — safe to re-run after changes
+- Provider adapter pattern: `providers/*/provider-manifest.sh` auto-discovered by `install.sh`
+- Governance rules take effect at session start without any manual loading step
+- Skills available as slash commands immediately after install
+
+## What is not yet deployed
+
+- `sync.sh` — pulls updates into existing projects (Chunk 6)
+- `init-project.sh` — bootstraps a new project (Chunk 6)
+- Copilot provider adapter (Chunk 7)
+- Formal CI/pre-commit enforcement of governance rules (Chunk 6)
+
+For chunk planning and open questions, see `docs/ROADMAP.md`.
+
+## Recent changes
+
+- 2026-05-17 — added `LESSONS.md` (issue 0013) and `docs/spec/` (issue 0014); refactored `docs/VISION.md` to goals/intent only