WP-0003 Part 6: packaging sync and docs close-out

Sync coach, sys-medic, scope-analyst, optimization, and updated
tdd-workflow to packaged data (20 agents). Update architecture.md,
README orientation, and CHANGELOG for the metrics loop. Mark WP-0003
completed.

.claude/rules/architecture.md

@@ -6,20 +6,23 @@ kaizen-agentic has two distinct layers:
 
 - **`core.py`** — `Agent` (abstract base) + `AgentConfig` (dataclass). Tracks performance, supports config updates, implements kaizen interface.
 - **`optimization.py`** — `OptimizationLoop` (runs improvement cycles, detects trends, generates recommendations) + `PerformanceMetrics` (execution time, success rate, quality scores).
+- **`metrics.py`** — `MetricsStore` + `OptimizerStore` (project-scoped `.kaizen/metrics/` per ADR-004).
 
-### 2. Agent definitions (`agents/` — 17 files)
+### 2. Agent definitions (`agents/` — 20 files)
 
 Markdown instruction sets read and followed by Claude. Not executables. Naming convention: `agent-{name}.md`.
+Packaged copies live in `src/kaizen_agentic/data/agents/` for `pip install` distribution.
 
 | Category | Agents |
 |----------|--------|
 | Testing | `tdd-workflow`, `test-maintenance`, `testing-efficiency` |
-| Quality | `code-refactoring`, `datamodel-optimization`, `optimization` |
+| Quality | `code-refactoring`, `datamodel-optimization` |
 | Process | `requirements-engineering`, `keepaTodofile`, `keepaChangelog`, `keepaContributingfile`, `project-management`, `priority-evaluation`, `scope-analyst` |
-| Infrastructure | `setupRepository`, `tooling-optimization` |
+| Infrastructure | `setupRepository`, `tooling-optimization`, `sys-medic` |
 | Release | `releaseManager` |
 | Docs | `claude-documentation` |
 | Support | `wisdom-encouragement` |
+| Meta | `coach`, `optimization` |
 
 ### Custodian integration