Bootstrap AGENTS.md

Author a new AGENTS.md that orients a future agent to the current working scope: what it is, how it's wired, what's load-bearing, and the conventions a contributor must respect. Optimized for both human skim and LLM ingestion. Claude Code 2.1.277+ reads this file when no project CLAUDE.md is on the path; other agents read it directly.

Output modes

Before drafting, ask the user which mode to use:

• Flat (default) — single AGENTS.md containing every section. Best for leaf packages, small apps, anything that fits comfortably in ~150 lines.
• Progressive disclosure — slim AGENTS.md orientation index that lists must-know rules + a table of links into context/*.md files for everything else. Best for large apps with multiple subsystems, where loading the whole file every turn is wasteful.

Quote the two options to the user and wait for their pick. If they don't choose, default to flat. Skip this prompt only if the user already named the mode in their request (e.g. "bootstrap a progressive agents.md").

Scope rules