Conversation
…ters Move root CLAUDE.md into AGENTS.md (Claude Code, Grok, Cursor, Copilot and Codex all read the same file); CLAUDE.md becomes a stub that @-imports it. Add .rtk/filters.toml for the two locally noisy, hook-unfiltered commands: `rake test` (Postgres/PGMQ NOTICE chatter + SimpleCov deprecation lines interleaved in the dot progress) and `bin/integrations` (per-spec banners and cleanup chatter). rubocop, yard-lint and lostconf are already handled by the global rtk hook or aren't noisy enough to warrant a filter.
mhenrixon
force-pushed
the
chore/agents-md-rtk
branch
from
September 19, 2026 16:28
cf02c10 to
8afdff2
Compare
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
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.
Summary
CLAUDE.mdbody intoAGENTS.md, the single project-instruction fileshared across Claude Code, Grok, Cursor, Copilot and Codex. No rule content was dropped or
changed, only relocated and given a short intro.
CLAUDE.mdis now a stub that@-importsAGENTS.md, matching the getzazu/app#4104 pattern.AGENTS.mddidn't exist yet) and no other file referencedCLAUDE.mdas"the project rules" —
pgmq-ruby.gemspec'sspec.fileslist never shippedCLAUDE.mdin thegem package, so nothing to fix there either. No
.github/copilot-instructions.mdor.gitattributesin this repo..rtk/filters.tomlfor the two commands that are genuinely noisy and not already handledby the global rtk hook:
rake test— Postgres/PGMQNOTICE:chatter interleaved into the Minitest dot-progress line,plus 4 recurring
SimpleCov.add_filterdeprecation lines. Verified live: 43 → 8 lines(
rtk bundle exec rake test, exit code unchanged at 0,267 runs, 625 assertions, 0 failurespreserved).
bin/integrations— decorative====banners,Example: <name>titles, and per-specCleaning up N queue(s).../Dropped: ...chatter repeated once per integration spec.Verified live: 405 → 140 lines (
rtk bin/integrations, exit code unchanged at 0, thefinal
All 19 integration spec(s) passed.line preserved).rtk trust --yes+rtk verify'd (158/158 inline tests pass, includingthe 5 I added, built from real captured output).
bundle exec rubocopandbundle exec yard-lint lib/— already rewritten/clean (rubocopis in the global hook's known-command list;
yard-lintprints a singleNo offenses foundline on a clean run, nothing to strip).
docker compose up -dandnpm ci— not rewritten by the hook, but their real output isalready short (3 and 9 lines respectively) and not noisy enough to justify a filter.
npx lostconf --fail-on-stale— already rewritten by the global hook.brakeman/lingo/rails db:*filters were not copied — this repo runs none ofthose commands.
bin/setup(or equivalent) exists in this repo, so no new idempotentrtk trust --yessetupstep was added.
AGENTS.md's Testing section naming the two filtered commands.Adopts getzazu/app#4104.
Test plan
rtk trust --yes+rtk verify— 158/158 inline tests passrtk hook check "bundle exec rake test"/"bin/integrations"— both now show the projectfilter's rewrite
docker compose up -dPostgres+ PGMQ extension instance — line-count reduction confirmed, exit codes and pass/fail counts
unchanged
grep -rn "CLAUDE.md"across the repo (excluding.git) — only the intentionalself-reference inside
AGENTS.mdremainsbundle exec rake test/bin/integrations— not run as CI (docs/config-only change);spot-verified above instead
Summary by cubic
Consolidates project instructions into
AGENTS.mdso Claude Code, Grok, Cursor, Copilot, and Codex all read the same file;CLAUDE.mdis now a stub that importsAGENTS.md, with no rule content changed. Adds.rtk/filters.tomlto strip noisy output fromrake testandbin/integrations—Postgres/PGMQNOTICE:lines, SimpleCov deprecation warnings, and per-spec banners/cleanup chatter—while preserving exit codes and pass/fail summaries. The Testing section inAGENTS.mdnow documents that edits to.rtk/filters.tomlrequirertk trust --yesandrtk verify.Written for commit 8afdff2. Summary will update on new commits.