Skip to content

Cut agent instructions down to what the code can't tell an agent - #8

Draft
Moritz Mazetti (Radiergummi) wants to merge 1 commit into
mainfrom
prune-agent-docs
Draft

Moritz Mazetti (Radiergummi) wants to merge 1 commit into
mainfrom
prune-agent-docs

Conversation

@Radiergummi

Copy link
Copy Markdown
Member

Recent research suggests that large agent instruction files make coding agents perform worse. This PR keeps only what an agent cannot learn from the code, config or README, and turns rules into checks where the existing tooling allows it.

Summary

  • CLAUDE.md: 65 → 5 lines. One rule stays: lint/format/tsconfig rules come from @matchory/coding-style. A local override was tested and style:verify does not catch it.

Please check

  • README.md still ends with "See CLAUDE.md for the conventions to follow".

🤖 Generated with Claude Code

Everything else duplicated the README, package.json or settings.json.
The .editorconfig drift rule is already enforced by style:verify in CI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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