| name | init |
| description | Generates AGENTS.md file using the WHAT/WHY/HOW framework. Explores the codebase and produces a minimal (<100 line) context file with progressive disclosure. |
| argument-hint | [--reset] |
AGENTS.md -- Context File Generator
This skill is CLI-agnostic. It works with Claude Code, Codex, Amp, or any AI coding assistant.
Generate a minimal, high-impact AGENTS.md context file for this repository using the WHAT/WHY/HOW framework. See reference/AGENTS.md for the template, rules, and progressive disclosure specs.
Validate the result of every operation. If any step fails, halt and report the failure before continuing.
Arguments
$ARGUMENTS
--reset: Regenerate everything from scratch -- overwrite AGENTS.md and all context files created by this skill, then re-run the full exploration.- Default (no args): Generate AGENTS.md and context files. If AGENTS.md already exists, overwrite it directly.
Step 1: Handle --reset
If $ARGUMENTS contains --reset:
- Check which
.maestro/context/ files were created by this skill (not by maestro:setup). The skill-created files use snake_case names like building_the_project.md, running_tests.md, code_conventions.md, service_architecture.md, database_schema.md, etc. The maestro:setup files use kebab-case: , , , , , .
