agents-md

An AGENTS.md file provides deterministic, AI-facing project guidance for your repository. You need hierarchical AGENTS.md files when standardizing agent docs across simple projects or complex monorepos to ensure scoped instructions and low-token navigation.

To generate AGENTS.md documentation for a monorepo, run the deterministic discovery workflow to identify package boundaries, then apply hierarchical layouts with root and package-specific files using the provided templates to tailor guidance to each package.

The best way to structure AGENTS.md files across multiple packages is using a hierarchical layout with a root AGENTS.md plus scoped instruction files for each package, minimizing duplication through index references and local skill references.

Yes, you can maintain AGENTS.md docs without duplication by using scoped instruction files, index references, and local skill references that enforce minimal duplication and copy-safe command templates to ensure consistent, low-token guidance.

AGENTS.md generation works for both simple projects and complex monorepos. The deterministic discovery workflow applies hierarchical layouts and scoped instruction patterns to route knowledge efficiently regardless of repository scale.