2 Commits

Author	SHA1	Message	Date
arsen	a36af57d19	fix(docs): repair internal links broken by README/CLAUDE doc-slim ... After ADR-117/118 docs sweep (commit 4075b608) extracted Use Cases, How It Works, Edge Modules, Self-Learning sections from README into docs/use-cases.md + docs/architecture.md, but two classes of links were left dangling: 1. README anchor links pointing at section IDs that no longer exist in README: #edge-intelligence-adr-041 → moved to docs/use-cases.md #esp32-s3-hardware-pipeline → architecture detail in docs/ #vital-sign-detection → moved out #sensing-server → moved out #-quick-start → renamed during slim Replaced with deep links into docs/use-cases.md or docs/dev-handbook.md / docs/architecture.md where appropriate. 2. Extracted docs (docs/use-cases.md etc.) had path links written from the perspective of repo root (docs/edge-modules/, v2/crates/...) — broken once the file moved into docs/. Bulk-rewrote via Python regex pass: docs/edge-modules/X → edge-modules/X docs/adr/X → adr/X v2/... → ../v2/... archive/... → ../archive/... scripts/... → ../scripts/... plugins/... → ../plugins/... firmware/... → ../firmware/... 3. docs/use-cases.md self-reference #ai-backbone-ruvector → that section was never moved; replaced with prose + link to architecture.md. Final scan: ZERO dangling anchors in the doc tree. One valid anchor `#edge-module-list` in use-cases.md points to a local `<details id="edge-module-list">` block. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-05-18 11:34:02 +07:00
arsen	4075b6082d	docs: enforce ≤200-line cap on README/CLAUDE/CHECKLIST and 3 ADRs ... User-stated rule: README.md and CLAUDE.md must not exceed 200 lines; all detail goes into docs/ with a link. ADRs also targeted at ≤200. Before: README.md 542 lines CLAUDE.md 407 lines CHECKLIST 235 lines ADR-116 224 ADR-117 245 ADR-120 209 After: README.md 198 ✓ CLAUDE.md 149 ✓ CHECKLIST 199 ✓ ADR-116 191 ✓ ADR-117 199 ✓ ADR-120 200 ✓ ADR-115/118/119 already under (161 / 193 / 161) New supporting docs (extracted content): docs/use-cases.md — full deployment-tier catalogue + 60 ADR-041 edge modules + ADR-024 self-learning section, all moved from README docs/architecture.md — pipeline diagram + module breakdown from README docs/dev-handbook.md — crate map, RuvSense modules, build/firmware/release /publish, witness verification — all moved from CLAUDE.md docs/claude-swarm.md — V3 CLI commands, agent types, memory commands — moved from CLAUDE.md Trims (compress prose without losing facts): ADR-116 — D7 honesty section + Verified Acceptance + Open Items ADR-117 — Context narrative folded to bullets + Out of Scope condensed ADR-120 — Out of Scope condensed CHECKLIST — adaptive classifier entries compacted + Deferred grouped CLAUDE.md now adds the ≤200-line rule explicitly to Behavioral Rules + Project Architecture + Pre-Merge Checklist so future sessions can't forget it. README.md was a 67% reduction; CLAUDE.md 63%. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-05-18 11:04:15 +07:00