Skip to content

docs(architecture): replace stale module counts with single-source pointers - #130

Merged
cdeust merged 1 commit into
mainfrom
docs/architecture-counts
Jul 14, 2026
Merged

docs(architecture): replace stale module counts with single-source pointers#130
cdeust merged 1 commit into
mainfrom
docs/architecture-counts

Conversation

@cdeust

@cdeust cdeust commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Fixes #127. Les comptes de modules en dur (40/11/10/34/4 — jamais remesurés, même origine que la dérive CLAUDE.md corrigée par #125) remplacés par des renvois vers docs/module-inventory.md et docs/mcp-tools.md — une seule source, mesurée et datée. Même traitement pour la même dérive trouvée dans docs/program/gitnexus-competitive-analysis.md (« 108 core modules »). Laissés intacts, justifié : les comptes historiques des ADR (décisions datées) et les énumérations locales auto-suffisantes. Grep de contrôle final : vide.

🤖 Generated with Claude Code

…e-source pointer

docs/architecture.md still carried the pre-#114 module-count estimates (40
core / 11 infra / 10 shared / 34 handlers / 4 hooks) that had drifted from
reality (measured 2026-07-14: 208/77/25/131). Since #114 created
docs/module-inventory.md as the measured, dated source of truth, keeping a
second set of counts in the mermaid diagram and section headers just
recreates the same drift. Point to module-inventory.md instead of
re-asserting numbers that will go stale again.

Swept the rest of docs/ for the same drift class: found and fixed the
identical "108 core modules" estimate (never measured, same origin as the
old CLAUDE.md figure) in docs/program/gitnexus-competitive-analysis.md.
Historical ADRs (docs/adr/012-python-migration.md) and self-contained
per-feature module tables (docs/papers/research-post-context-assembly.md)
were left untouched — they describe a point-in-time decision or a locally
enumerated table, not a live claim about current total module counts.

Fixes #127

Co-Authored-By: Claude <noreply@anthropic.com>
@cdeust
cdeust merged commit abdd7c1 into main Jul 14, 2026
14 checks passed
@cdeust
cdeust deleted the docs/architecture-counts branch July 14, 2026 22:30
pull Bot pushed a commit to asleekgeek/Cortex that referenced this pull request Jul 15, 2026
Cuts 13 commits ahead of v4.14.1: core→infrastructure layer-violation
cleanup via reverse-DI ports-and-adapters (cdeust#135), check_setup MCP tool +
/preflight command (cdeust#115, cdeust#119, cdeust#133), XDG-aware embedding cache_folder
(cdeust#132), project settings catalogue + headless CI regimes (cdeust#131), devcontainer
with prewarmed models (cdeust#129), optional OTLP telemetry (cdeust#128), stale docs/
module-count fixes (cdeust#130, cdeust#121), CLAUDE.md refactor (cdeust#125), Windows
postInstall dispatch fix (cdeust#117). No retrieval-path code touched.

Pre-tag guard on the exact release tree (git_sha 018c76d, isolated
ephemeral pgvector container via benchmarks/reproduce.sh --no-ablation):
LongMemEval MRR 0.9166/R@10 0.9820 (matches v4.14.1, no regression); LoCoMo
3-run mean MRR 0.8009/R@10 0.9146 (vs v4.14.1's 3-run mean 0.7984/0.9142,
an improvement within noise); BEAM MRR 0.5437/R@10 0.7139 (within v4.14.1's
established intra-day variance band). All 4 gated floors PASS (tolerance
0.005) — unlike v4.14.1 where LoCoMo MRR failed the absolute floor on its
3-run mean, 4.14.2's mean clears it by -0.0041. Evidence:
benchmarks/results/repro/20260715-v4.14.2-pretag/.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/architecture.md : comptes de modules périmés (40 core / 11 infra vs 208 / 77 mesurés)

1 participant