docs(claude-md): refactor to 92 lines with @-references — measured counts, per-surface storage truth - #125
Merged
Merged
Conversation
Root CLAUDE.md had grown to 463 lines and drifted from PRIVACY.md on storage (falsely asserted "PostgreSQL MANDATORY, No SQLite"). Extract the module inventory and MCP tool tables to docs/module-inventory.md and docs/mcp-tools.md (loaded via @-references), correcting the documented module counts against the actual tree (measured 2026-07-14: core 208, infrastructure 77, shared 25, handlers 131 vs the stale "108/21/11" prose) while preserving every previously-documented module description. Rewrite CLAUDE.md itself around five verifiable sections: Build & Test (with the ruff-double-check and consolidation-OFF traps), Architecture (3 sentences + @-refs), Code Style (3 greppable rules, including an honest note on 3 pre-existing core->infrastructure violations found during this pass, not newly introduced), What NOT to do (3 dated-incident prohibitions), and a condensed Scientific Implementation Standard. Benchmark score table dropped from CLAUDE.md as pure duplication of README.md/docs/arxiv-*/main.tex; the reproduce.sh-vs-production-DB distinction from PR #121 is preserved verbatim as the release-gate instrument of record. Fixes #114 Co-Authored-By: Claude <noreply@anthropic.com>
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>
Closed
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #114 (périmètre étendu).
docs/module-inventory.md(inventaire par couche + dependency rules) etdocs/mcp-tools.md(tiers d'outils + data flows). Sections : Build & Test (pièges ruff-double-check, consolidation-OFF), Architecture (3 phrases + @-références), Code Style (3 règles vérifiables), What NOT to do (3 prohibitions issues d'incidents datés).Dérives hors-scope découvertes et signalées (issues de suivi) : 3 violations de couche core→infrastructure préexistantes ; comptes périmés dans docs/architecture.md.
🤖 Generated with Claude Code
https://claude.ai/code/session_01R5Z1wfiBpADgENq6pB6E2i