Skip to content

refactor(instructions): make CLAUDE.md the project rule file, drop AGENTS.md (v0.56.1) - #787

Merged
TheFJK merged 1 commit into
mainfrom
refactor/drop-agents-md
Aug 24, 2026
Merged

TheFJK merged 1 commit into
mainfrom
refactor/drop-agents-md

Conversation

@TheFJK

@TheFJK TheFJK commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator

AGENTS.md is the Codex convention. This repo does not use Codex, and the file reached Claude Code only because a one-line CLAUDE.md imported it (#748) — so the rules an agent actually obeys lived in a file named for a tool that never reads this repo.

What moved

The content is verbatim: same bump-version-everywhere mandate, same three-lane table, same six surfaces, same rationale. The only edit is the header — it inherited from ~/.codex/AGENTS.md, it now inherits from ~/.claude/CLAUDE.md.

Nine this-repo citations retargeted:

File What it cited
lib/bump-version.sh "the repo-root AGENTS.md" as the documented ritual
lib/review-consolidate.sh the fleet-PR title shape it blesses
skills/premerge-pipeline/SKILL.md ×2 the version binding, and the post-merge tag/release steps
docs/rfc/0021 the collapse-two-releases-into-one rule
docs/testing.md the release-ratchet ritual
tests/_lib_assert_structural.sh the SSOT for the surface list
post-impl-review/references/contracts.md the directory-scoping example
.gitignore a comment describing an import that no longer exists

The one suite that actually broke

tests/docs-accuracy.test.sh — its T12 block FATALs when the rule document is unreadable and pins fourteen assertions inside the version section, so it moved with the file. Everything else passed untouched, which is what confirmed the rest of the references aren't about this repo.

Deliberately unchanged — 62 references

These are the plugin reading a target repo's convention files, not this repo's:

  • convention-compliance reviews a change against the project's own written rules
  • research-constraints reads <working_dir>/AGENTS.md
  • review-fleet-args.sh collects -name AGENTS.md -o -name CLAUDE.md -o -name .editorconfig
  • tests/convention-citation.test.sh (28 refs) verifies agents quote those rules correctly

Deleting them would remove a feature from every repo UberDev is installed into — a different change from this repo not needing the file itself. Verified they pass untouched: convention-citation 60, review-pr-workflow 386, solve-fleet-workflow 586, child-wait, prkit-verify 49.

Verification

16 suites green: docs-accuracy 309, premerge 261, premerge-findings 208, review-pr 471, solve-fleet-workflow 586, review-pr-workflow 386, review-pr-consolidate 86, convention-citation 60, ci-wiring 30, epipe-guard 93, skill-size 49, vendor-provenance 63, prkit-verify 49, plus goal, solve-claim, child-wait.

Version bumped to 0.56.1 per the rule this PR moves — patch, since no behaviour changes.

…ENTS.md

AGENTS.md is the Codex convention. This repo does not use Codex, and the file
reached Claude Code only because a one-line CLAUDE.md imported it (#748) — so
the rules an agent actually obeys lived in a file named for a tool that never
reads this repo.

The content moves verbatim into CLAUDE.md: same bump-version-everywhere
mandate, same three-lane table, same six surfaces, same rationale. Only the
header changed (it inherited from ~/.codex/AGENTS.md; it now inherits from
~/.claude/CLAUDE.md).

Nine this-repo citations retargeted: bump-version.sh, review-consolidate.sh,
the premerge SKILL (x2), RFC 0021, docs/testing.md, _lib_assert_structural.sh,
post-impl-review/references/contracts.md, and .gitignore's comment describing
an import that no longer exists.

tests/docs-accuracy.test.sh moved with it — its T12 block FATALs when the rule
document is unreadable and pins fourteen assertions inside the version
section, so it was the one suite the rename actually broke.

DELIBERATELY UNCHANGED: the 62 references that are the plugin reading a TARGET
repo's convention files. convention-compliance reviews a change against the
project's own written rules; research-constraints reads <working_dir>/AGENTS.md;
review-fleet-args.sh collects `-name AGENTS.md -o -name CLAUDE.md -o -name
.editorconfig`. Deleting those would remove a feature from every repo UberDev
is installed into — a different change from this repo not needing the file.
Verified those suites pass untouched: convention-citation 60, review-pr-workflow
386, solve-fleet-workflow 586, child-wait, prkit-verify 49.

Verified: 16 suites green — docs-accuracy 309, premerge 261, premerge-findings
208, review-pr 471, solve-fleet-workflow 586, review-pr-workflow 386,
review-pr-consolidate 86, convention-citation 60, ci-wiring 30, epipe-guard 93,
skill-size 49, vendor-provenance 63, prkit-verify 49, plus goal, solve-claim
and child-wait.
@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 684c2b42-8907-46a7-b9e2-b413f16a54c7


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@TheFJK
TheFJK merged commit 0f08b7e into main Aug 24, 2026
15 checks passed
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