Create AGENTS.md as the agent's table of contents — a 100-line map pointing to deeper sources of truth in docs/. Agents start here, then load only what they need (progressive disclosure).
Philosophy: AGENTS.md is a map, not an encyclopedia. A monolithic instruction file crowds out the task and rots instantly. Keep it short; point to deeper docs.
| Existing agent docs | Check for AGENTS.md, CLAUDE.md, CODEX.md, spec/, docs/ | | Existing gitignore | Check .gitignore for .swarm/, .claude/ |
Bootstrap AGENTS.md as a short table-of-contents plus a structured docs/ directory (architecture, product specs, acceptance tests, ADRs, exec plans, quality grades). Use when AGENTS.md is missing, when asked to "create AGENTS.md", "bootstrap project for agents", or "set up agent context". Source: jonmumm/skills.