Skip to content

docs: cite AGENTS.md instead of CLAUDE.md for repo guidance - #397

Merged
iceboundrock merged 1 commit into
mainfrom
autoforge/171
Nov 11, 2026
Merged

iceboundrock merged 1 commit into
mainfrom
autoforge/171

Conversation

@iceboundrock

Copy link
Copy Markdown
Contributor

PR #170 moved the architecture overview, design patterns, no-materialization rule and build commands from CLAUDE.md into AGENTS.md; CLAUDE.md now only includes AGENTS.md plus sub-agent rules. Several docs still cited CLAUDE.md as 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, and docs/MODULE_GUIDE.md's build-commands line to AGENTS.md. The cited section names now match AGENTS.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.md has 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 docs matches only ADR 0011. Every cited section exists in AGENTS.md, as do the four commands MODULE_GUIDE.md quotes (maturin develop, pytest py-ltseq/tests/ -v, cargo check, cargo test). git diff --check is clean.

Closes #171

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.
@iceboundrock

Copy link
Copy Markdown
Contributor Author

AI Code Review — Round 1

Reviewed HEAD: fceed18e3d6b2fa06e2442787eedc6018987d855 against base main (merge base e88d417ae4f3160796fa71642466648018bcf5b7)

Findings

None.

Spec

Satisfies 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.

Standards

Consistent with AGENTS.md, CLAUDE.md and the repository's non-code conventions. Changes preserve existing wording and bilingual parity.

Assessment

No actionable defects found. This is a narrowly scoped citation correction with no runtime or security impact.

Observations

The 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.

Verification

Read 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.

Summary

No findings; no fix round needed. Local documentation checks passed. CI completion remains unverified.

Needs another fix round: NO

@iceboundrock
iceboundrock merged commit 7885652 into main Nov 11, 2026
4 checks passed
@iceboundrock
iceboundrock deleted the autoforge/171 branch November 11, 2026 18:59
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: repoint CLAUDE.md references to AGENTS.md after guidance migration

1 participant