Skip to content

When AGENTS.md, CLAUDE.md, and a Skill Disagree, Which One Wins?

7.1 relevance
Score Breakdown
technical depth
7
novelty
8
actionability
7
community
5
strategic
6
personal
9

Scored daily by a customisable AI persona to surface the most relevant engineering leadership news.

Resolving conflicts between AGENTS.md, CLAUDE.md, and skills — directly relevant to AI agent orchestration and developer experience.

AI/ML dev.to
When AGENTS.md, CLAUDE.md, and a Skill Disagree, Which One Wins?
Summary

When AGENTS.md, CLAUDE.md, and a skill file contain conflicting instructions, there is no universal precedence rule—resolution order varies by harness and version, and conflicts fail silently. A ten-minute demo with three contradictory status-word rules reveals which source wins in your specific stack, but the answer becomes stale after any upgrade. Harness documentation typically describes where files are read but rarely commits to a conflict resolution order, making agent behavior an implementation detail rather than a documented policy.

Author

Debashish Ghosal

More from Debashish Ghosal →