These instructions apply across the repository. More specific AGENTS.md files add rules for the directories they contain.
- Follow the instruction hierarchy established by the execution environment and apply the most specific applicable
AGENTS.mdfile. - Treat nested
AGENTS.mdfiles as scoped additions. Do not copy parent instructions into them; document only the rules that are specific to that subtree. - Use
.agents/for supporting guidance that is referenced by an applicableAGENTS.md. A.agents/directory does not create an instruction scope by itself.
When working under docs/, read docs/AGENTS.md and the supporting guidance it identifies. The documentation instruction map is:
| Work | Guidance |
|---|---|
| Writing or substantially editing pages | .agents/style-guide.md |
| Adding, moving, or reorganizing pages | .agents/info-architecture.md |
| Adding or changing Mintlify components or layout | .agents/mintlify-guidance.md |
| Validating documentation changes | .agents/validation.md |
| Updating OpenAPI spec for REST API reference | .agents/skills/update-openapi-spec/SKILL.md |
| Generating release notes from Jira exports | .agents/skills/generate-release-notes/SKILL.md |
Keep the root AGENTS.md focused on repository-wide guidance and this routing map. Put documentation-specific rules in docs/AGENTS.md or a more specific nested file.