Skip to content

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

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: 76 → 6 lines.

Check that replaces a prose rule

  • .github/workflows/docker.yaml: a new first step fails if any ARG *_VERSION pin differs between the Dockerfiles. The workflow has no pull-request trigger, so this runs after merge.

Found, not fixed

  • The README says FrankenPHP 1.12 is the default; the Dockerfile pins 1.13.

🤖 Generated with Claude Code

Most of the file repeated the README. Keep only the traps: Dockerfiles
kept in parallel, the renovate pin format, and FROM scratch dropping ENV.
The pin-parity rule is now a CI step instead of prose.

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