refactor(docs): Optimize CLAUDE.md structure (47KB→12KB) + expand AGENTS.md v16.0
## Summary
- **CLAUDE.md optimization:** Move engineering guidelines to AGENTS.md only (governance lock)
- Removed: Governance, Testing Strategy, Observability details, Common Workflows, Guardrails
- Kept: Project status, timeline, architecture high-level overview, quick reference
- Result: 47KB → 12.1KB (75% reduction, well within 40KB limit)
- **AGENTS.md expansion:** Add 5 missing engineering procedure sections
- v16.0 Testing Strategy (xUnit/Vitest/Playwright organization, commands, rules)
- v16.0 Backend Architecture (Vertical Slice, Database/Migrations, Hangfire Job Design)
- v16.0 Frontend Architecture (Registry-driven screens, KBX contracts, UI adapter boundary)
- v16.0 Observability (Logging, Tracing, Dashboards, Metrics)
- v16.0 Common Workflows (Adding Vertical Slices, Refactoring, Creating Jobs)
- **New companion docs** (no duplication, supplement AGENTS.md):
- docs/ARCHITECTURE_DETAILED.md — Deep dive on backend/frontend patterns
- docs/COMMON_WORKFLOWS.md — Workflow procedures with examples
- docs/GITEA_API_REFERENCE.md — Gitea API + External data sources
## Governance (enforced)
- All engineering procedures now in AGENTS.md ONLY
- CLAUDE.md = project context only (status, timeline, overview)
- Companion docs reference AGENTS.md (no duplicate guidance)
- No conflicting guidance across multiple sources
## Result
- CLAUDE.md: 12.1KB ✅ (within 40KB limit)
- AGENTS.md: 44.8KB (comprehensive procedures)
- Single source of truth for all engineering guidelines
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
kjh2064
07ad98ec12