agent-navigation-sop

To generate an AGENTS.md file, trigger the /init workflow to instruct the AI to assess repository complexity, analyze build commands and coding conventions, then output structured navigation guidelines using XML-like section boundaries for task routing.

An AGENTS.md file documents AI agent navigation by capturing repository structure, build and test commands, coding conventions, and task routing guidelines to help humans and agents understand complex workflows during onboarding and maintenance.

You need agent navigation documentation when your repository has multiple agents and complex workflows, making it difficult for new agents or contributors to understand task routing, build commands, and coding conventions without structured guidance.

Yes, the /init workflow supports both on-demand documentation generation and initial repository setup, creating a reusable AGENTS.md template with sections for instructions, constraints, and context to enable consistent agent-driven collaboration.

No, generating agent navigation documentation enforces one-shot commands and avoids long-running processes, ensuring the AGENTS.md file is produced efficiently through a phased workflow of complexity assessment and information gathering without blocking operations.

The best way to maintain AGENTS.md is using a phased workflow that performs complexity assessment and information gathering, outputting structured documentation with XML-like section boundaries that keep build commands, conventions, and task routing comprehensible.