agent-agile

Use when the user has an existing plan, PRD, or spec document they want brought into this planning system instead of a fresh grill and intake — or invokes /aa-import with a path or description of that document.

Use when the user wants to plan a new project from a clear idea, has already locked an idea with aa-grill, or invokes /aa-new-project.

Use when multiple epics should run back to back without a human kicking off each one by hand, or the user invokes /aa-autopilot [--gate full-auto|checkpoint].

Use when the current epic on the roadmap is done and the next pending epic needs to be sliced into worker-ready story cards, or the user invokes /aa-plan-epic.

Use when the user wants to review a finished epic's demo, decide whether to approve, redo, or replan an epic, or invokes the review gate, for example "/aa-review", "let's review this epic", "walk me through the demo", "I want to give feedback on this epic".

Use when a sliced epic (story cards already written) is ready to build, or the user invokes /aa-execute-epic.

Use when a drafted plan (PROJECT.md, ROADMAP.md, and the current epic's story cards) needs adversarial review before execution starts, or the user invokes /aa-panel.

Use when the user has a rough or vague product idea that needs interrogation before any planning — or invokes /aa-grill. Locks the idea into .planning/IDEA.md or recommends against building it.

Use when the user says resume, continue, or pick up where we left off, starts a new session on an existing Agent-Agile project, or is recovering after a crash or context reset, for example "/aa-resume", "let's continue", "where were we".

Use when the user asks what Agent-Agile commands exist, wants a command reference or cheat sheet, is unsure which command to run next, or asks how the methodology works, for example "/aa-help", "what commands are there", "how does this system work".

Use when the user asks for status, progress, an overview, "where are we", a roadmap summary, or Key Result progress on an Agent-Agile project, for example "/aa-status", "how's this project going", "what's left to do".