XP-006: Multiple Layers Without Documented Precedence

Summary

• Rule ID: XP-006
• Severity: MEDIUM
• Category: Cross-Platform
• Normative Level: SHOULD
• Auto-Fix: No
• Verified On: 2026-02-04

Applicability

• Tool: all
• Version Range: unspecified
• Spec Revision: unspecified

Evidence Sources

• https://developers.openai.com/codex/guides/agents-md
• https://docs.cursor.com/en/context

Test Coverage Metadata

• Unit tests: true
• Fixture tests: true
• E2E tests: false

Examples

The following examples demonstrate what triggers this rule and how to fix it.

Invalid

# CLAUDE.md

## Code Style
- Use TypeScript
- Follow ESLint rules

# AGENTS.md (separate file, same project)

## Code Style
- Use JavaScript
- Follow Prettier rules

Valid

# CLAUDE.md

CLAUDE.md takes precedence over AGENTS.md.

## Code Style
- Use TypeScript
- Follow ESLint rules