AGENTS.md Priority and Conflict Resolution
Priority Rules
When multiple AGENTS.md files apply, follow this order:
- •Respect global hard constraints from higher-level strategy docs (project root, modular system root).
- •Apply the most local applicable strategy for detailed decisions (module -> directory).
- •Local strategies may refine or narrow global strategies but must not contradict explicit hard rules.
Conflict Resolution
If you detect conflicting rules:
- •Prefer higher-level hard constraints when explicit.
- •Prefer the more restrictive interpretation when uncertain.
- •Record the uncertainty in workdocs for human review.
- •Do not proceed with potentially unsafe actions.
Navigation Pattern
text
Project Root AGENTS.md
-> (move down for module work)
/modules/AGENTS.md
-> (move down for specific module)
/modules/<module_id>/AGENTS.md
-> (move down for specific directory)
/modules/<module_id>/subdir/AGENTS.md
AI should:
- •Start at the most relevant level for the task.
- •Move down for more specific guidance.
- •Move up when task scope expands beyond current level.
- •Move sideways when task involves peer modules.