Repository navigation
docs: cite AGENTS.md instead of CLAUDE.md for repo guidance - #397
Conversation
PR #170 moved the architecture overview, design patterns, the no-materialization rule and the build commands from CLAUDE.md into AGENTS.md; CLAUDE.md now only includes AGENTS.md. Repoint the ADR Sources/notes lines (0001, 0005, 0007, 0012 and their .cn.md counterparts) and MODULE_GUIDE's build-commands line to AGENTS.md, and use the section names AGENTS.md actually has. ADR decisions are unchanged; ADR 0011 keeps its separately tracked stale-wording note.
AI Code Review — Round 1Reviewed HEAD: FindingsNone. SpecSatisfies the issue: all scoped references now cite AGENTS.md, including both ADR languages. Citation labels match the target headings or bold items. ADR decisions and excluded ADR 0011 remain unchanged. StandardsConsistent with AGENTS.md, CLAUDE.md and the repository's non-code conventions. Changes preserve existing wording and bilingual parity. AssessmentNo actionable defects found. This is a narrowly scoped citation correction with no runtime or security impact. ObservationsThe supplied PR head and base match this round's binding. Remaining CLAUDE.md references under docs occur only in the explicitly excluded ADR 0011 pair. CI results were still pending in the supplied snapshot. VerificationRead the full bound diff, affected ADRs, module-guide context, guidance files and supplied GitHub context. git diff --check passed. A read-only Python 3 assertion script verified that all nine changed files contain only citation replacements and target-label normalization, all cited targets and four build commands exist in AGENTS.md, and the worktree remains clean. The initial python invocation was unavailable; rerunning with python3 passed. Runtime suites were not run because no executable code changed and the documented full suite is expensive. No controller validation was configured. SummaryNo findings; no fix round needed. Local documentation checks passed. CI completion remains unverified. Needs another fix round: NO |
PR #170 moved the architecture overview, design patterns, no-materialization rule and build commands from
CLAUDE.mdintoAGENTS.md;CLAUDE.mdnow only includesAGENTS.mdplus sub-agent rules. Several docs still citedCLAUDE.mdas the source of those sections, which was only transitively true.This repoints the Sources/notes lines of ADRs 0001, 0005, 0007 and 0012 (English and
.cn.md), ADR 0005's "documented in" line, anddocs/MODULE_GUIDE.md's build-commands line toAGENTS.md. The cited section names now matchAGENTS.md's own headings. "Expression transpilation" and "No materialization rule" are bold items under "Key design patterns" there, not headings, so those citations name both. No ADR decision text changes. ADR 0011's stale-wording note is tracked separately and is untouched.docs/MODULE_GUIDE.cn.mdhas no build-commands section, so it needed no change.Validation
Docs only; no test or tool reads these files. After the change,
grep -rn CLAUDE docsmatches only ADR 0011. Every cited section exists inAGENTS.md, as do the four commandsMODULE_GUIDE.mdquotes (maturin develop,pytest py-ltseq/tests/ -v,cargo check,cargo test).git diff --checkis clean.Closes #171