auto-improving-agents-mdlisted

# Auto-Improving AGENTS.md ## Two modes of operation **Setup mode:** The user asks to create, structure, or audit an AGENTS.md file. Follow the setup workflows below. **Session mode:** The user wants ongoing auto-improvement during the current session. Follow the behavioral directives below — propose AGENTS.md updates when corrected or when discovering undocumented conventions. ## Workflow: Bootstrap a new AGENTS.md 1. Ask for (or discover) the project's build, test, and lint commands. 2. Copy the starter template from [assets/starter-agents.md](assets/starter-agents.md) into the project root as `AGENTS.md`. 3. Fill in the command placeholders. 4. Delete the seed examples under Conventions. 5. Leave all other sections with their comment placeholders — they fill organically. 6. Commit the file. Do NOT write a comprehensive AGENTS.md upfront. **Alternative bootstrap:** Study the repo and draft initial rules, then ruthlessly prune — keep only what would surprise a competent developer reading the codebase for the first time. ## Workflow: Add auto-improvement to an existing AGENTS.md 1. Verify the file has clearly named sections (Commands, Conventions, Architecture Decisions, Boundaries, Gotchas). If not, restructure first — see [references/01-bootstrapping-and-structure.md](references/01-bootstrapping-and-structure.md). 2. Append the Self-Improvement Meta-Rules block from [assets/starter-agents.md](assets/starter-agents.md). 3. Verify the file is under 150 rules. If over