[BUG] Model ignores CLAUDE.md priority over skill instructions
Resolved 💬 3 comments Opened Mar 31, 2026 by zoharmizrahi Closed Apr 4, 2026
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
CLAUDE.md contains the rule: "Do not commit implementation plan documents." A superpowers skill (writing-plans) has a workflow that includes committing plan/design documents. The skill itself documents the priority order:
CLAUDE.md— highest priority- Skills — middle
- Default system prompt — lowest
Despite this, the model followed the skill's workflow and committed two plan documents, violating the CLAUDE.md rule. The model did not cross-check the skill's steps against project instructions before acting.
What Should Happen?
When a skill workflow step conflicts with a CLAUDE.md rule, the model should skip or adapt that step to comply with CLAUDE.md.
Error Messages/Logs
Steps to Reproduce
- Add a rule to
CLAUDE.md(e.g., "Do not commit plan documents") - Use a skill whose workflow includes a step that violates that rule (e.g., writing-plans skill that commits plan files)
- The model follows the skill and violates the
CLAUDE.mdrule
Claude Model
Opus
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.1.86
Platform
Anthropic API
Operating System
Ubuntu/Debian Linux
Terminal/Shell
Terminal.app (macOS)
Additional Information
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗