agents-md-author

An AGENTS.md file provides a minimal, stable entrypoint for repository onboarding. You need one when managing multiple docs or a monorepo that requires scalable guidance and a clear reference structure to avoid documentation duplication.

To create a minimal AGENTS.md, draft a root file with a one-line project description and a References section pointing to deeper docs. Scan existing documentation first to prevent duplication and keep the root file tiny.

Refactor AGENTS.md files by moving detailed guidance into deeper referenced docs, leaving only essential content in the root. This approach ensures the entrypoint remains tiny, stable, and scalable for monorepos or multi-doc repositories.

Yes, the AGENTS.md file adheres to the Skill Unit contract by requiring YAML frontmatter with name and description. It also supports optional scripts, references, and assets to structure the governance and onboarding documentation.

Use references in AGENTS.md when repositories have multiple docs or need scalable guidance. Pointing to deeper docs keeps the root file tiny and stable, preventing content bloat while maintaining a useful onboarding entrypoint.