Skip to content

docs: correct the db module count to 137 and re-translate stale CLAUDE.md/GEMINI.md mirrors - #15329

Merged
diegosouzapw merged 7 commits into
release/v3.8.52from
docs/agent-surfaces-i18n-852
Oct 2, 2026
Merged

diegosouzapw merged 7 commits into
release/v3.8.52from
docs/agent-surfaces-i18n-852

Conversation

@diegosouzapw

Copy link
Copy Markdown
Owner

Summary

This PR touches agent-instruction surfaces (llm.txt + its 66 mirrors, and the CLAUDE.md / GEMINI.md translations). The owner approved these changes in the session.

  1. src/lib/db/ module count → 137. llm.txt said 122 in four places, and README / REPOSITORY_MAP.md said 136. The real count of .ts files in src/lib/db/ is 137 today, using the same method the original figure came from. check:docs-counts does not verify this number, which is why it drifted. The 66 llm.txt mirrors were regenerated with sync-llm-mirrors. The changed README and REPOSITORY_MAP sections were re-translated in all 66 locales.
  2. Stale CLAUDE.md / GEMINI.md mirrors re-translated.
    • 40 CLAUDE.md mirrors still carried the old long CLAUDE.md: 31 headings and 16 code fences, against 6 and 0 in today's source, which only points to AGENTS.md.
    • 3 GEMINI.md mirrors were stale in the same way.
    • The drift check could not see any of this because their recorded hashes matched.
    • They were found by a structure audit and an inline-code-span audit of all 10032 mirrors.

Validation

  • Every changed mirror passed the output guard and a structure/leak check against the base: 241 mirrors, 0 regressions, 0 leaks.
  • CLAUDE.md / GEMINI.md no longer appear in either audit.
  • check:docs-sync PASS (llm mirrors match the root, version 3.8.52), check:docs-counts with no strict drift, i18n:check-keys OK.
  • check-translation-drift still lists 6 docs the base edited (QUALITY_GATES, ACP, AGENT_PROTOCOLS_GUIDE, CLI-INTEGRATIONS, API_REFERENCE, ENVIRONMENT). They are being refreshed in a separate i18n PR.

⚠️ base-red inherited: #15306

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

CI Coverage Report

  • Coverage job: success
  • PR test policy: success

Coverage artifact was not available for this run.

…-surfaces-i18n-852

# Conflicts:
#	.i18n-state.json
@diegosouzapw
diegosouzapw merged commit f4e3fde into release/v3.8.52 Oct 2, 2026
43 of 48 checks passed
@diegosouzapw
diegosouzapw deleted the docs/agent-surfaces-i18n-852 branch October 2, 2026 10:46
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.

1 participant