docs: update README and CLAUDE.md with current state

[dimakis]

Summary

• Updated test count: 1607 → 2587 tests (177 suites)
• Added packages architecture section (@mitzo/protocol, @mitzo/harness, @mitzo/client)
• Added TaskBoard as 10th page, updated to 48 components, 21 hooks, 27 lib files
• Added missing skills (/land-pr, /pr-shepherd)
• Added ~10 missing env vars (APNS, OTEL, Loki, ContexGin, CORS, logging)
• Restructured backend section with categorized file tables (Core, Skills, Task Board, Worktrees, Observability, Notifications, WebSocket, Supporting)

Test plan

• Verify README renders correctly on GitHub
• Verify CLAUDE.md is picked up by Claude Code sessions

🤖 Generated with Claude Code

[dimakis]

Centaur Review

Found 5 issue(s) (3 warning).

CLAUDE.md

Docs-only PR with solid reorganization. A few count mismatches (components: 48 vs 51 actual, lib: 27 vs 28 actual) and useChatMessages listed under the wrong directory. Hardcoded test counts will go stale quickly.

• 🔵 unsafe_assumptions (L20): Hardcoded test count "2587 tests across 177 suites" will go stale as soon as tests are added or removed. Consider a range or removing the count entirely (the command npm test is self-documenting). The previous value "22000+" was already wrong, and this replacement will be too eventually. [fixable]
• 🟡 bugs (L110): Component count says "48 components" but there are 51 actual component files in frontend/src/components/. Additionally, ChatArea.tsx exists in the repo but is missing from the enumerated list. [fixable]
• 🟡 bugs (L94): Lib count says "27 utility files" but there are 28 actual files in frontend/src/lib/ (excluding tests). The enumerated list in the same section also has 28 items, contradicting the header count. [fixable]
• 🟡 bugs (L86): useChatMessages is listed under "Hooks — hooks/ directory (21 hooks)" but doesn't exist in frontend/src/hooks/. It lives in @mitzo/client (packages/client/src/slices/messages.ts). Either move this entry to the Packages section or clarify its location. The hook count of 21 is correct for files in frontend/src/hooks/, but the listing adds an extra entry that isn't there. [fixable]

README.md

Docs-only PR with solid reorganization. A few count mismatches (components: 48 vs 51 actual, lib: 27 vs 28 actual) and useChatMessages listed under the wrong directory. Hardcoded test counts will go stale quickly.

• 🔵 unsafe_assumptions (L254): Same hardcoded test count "2587 tests, 177 suites" — will drift out of date. This is the third distinct test count that has appeared across these two files (was "22000+" in CLAUDE.md and "1607 tests, 544 suites" in README.md). [fixable]

[dimakis]

🔵 unsafe_assumptions: Hardcoded test count "2587 tests across 177 suites" will go stale as soon as tests are added or removed. Consider a range or removing the count entirely (the command npm test is self-documenting). The previous value "22000+" was already wrong, and this replacement will be too eventually. [fixable]

[dimakis]

🟡 bugs: Component count says "48 components" but there are 51 actual component files in frontend/src/components/. Additionally, ChatArea.tsx exists in the repo but is missing from the enumerated list. [fixable]

[dimakis]

🟡 bugs: Lib count says "27 utility files" but there are 28 actual files in frontend/src/lib/ (excluding tests). The enumerated list in the same section also has 28 items, contradicting the header count. [fixable]

[dimakis]

🟡 bugs: useChatMessages is listed under "Hooks — hooks/ directory (21 hooks)" but doesn't exist in frontend/src/hooks/. It lives in @mitzo/client (packages/client/src/slices/messages.ts). Either move this entry to the Packages section or clarify its location. The hook count of 21 is correct for files in frontend/src/hooks/, but the listing adds an extra entry that isn't there. [fixable]

[dimakis]

🔵 unsafe_assumptions: Same hardcoded test count "2587 tests, 177 suites" — will drift out of date. This is the third distinct test count that has appeared across these two files (was "22000+" in CLAUDE.md and "1607 tests, 544 suites" in README.md). [fixable]