Prompt file imported from sky2464/DreamToosa (
.claude/commands/agtoosa-help.md). Copyright stays with the author.
Display the AgToosa command reference.
Sub-commands
| Sub-command | Behavior |
|---|---|
| (none) | Print the static command table below without reading Docs/Master-Plan.md, git state, or other project files |
next |
Assistance-only: read-only context read → recommend exactly one next AgToosa command |
Default — /agtoosa-help (static, fast)
Output the table below directly. Do not read any Docs file for the default path.
AgToosa Command Reference
Start here: /agtoosa-next — advance your project one step (spec, build, review, ship, fixes, docs). Repeat after each phase.
| Command | Purpose | Sub-commands |
|---|---|---|
/agtoosa-next |
Primary sequential driver — SYNC routes and executes one workflow | dry · pick · fix · test · docs |
/agtoosa-init |
One-time setup: scan codebase, validate AI configs, create Docs/Context/ files | (none) |
/agtoosa-spec |
Research → 6 forcing questions → Executable Specification → STRIDE threat model → atomic task planning | research · plan · quick · tasks · amend · to-issues |
/agtoosa-build |
TDD Red-Green-Refactor against the planned task list → full test suite + SAST/DAST | tdd · test |
/agtoosa-qa |
Plan → run → report → triage: unit, integration, E2E, browser, a11y, performance | plan · run · report · triage |
/agtoosa-review |
4-persona parallel review (Security · Arch · Product · QA) + Simplifier pass | security · arch · debug · cross |
/agtoosa-ship |
Pre-flight → deploy → archive spec → update changelog → suggest next story | check · docs · retro |
/agtoosa-goal |
Clarify project/story outcomes into a Goal Contract | project · story · check · revise |
/agtoosa-revert |
Git-aware logical rollback by phase or commit | (phase or commit) |
/agtoosa-task |
Fast task capture to Master-Plan.md for bugs, chores, spikes, and fixes | (type and description) |
/agtoosa-update |
Re-read context + changelog and sync workflow files to latest AgToosa baseline | (none) |
/agtoosa-status |
Read-only health dashboard: Master-Plan parsing, git cross-ref, orphan detection | plan · git · orphans |
Typical workflow
/agtoosa-init (once per project)
/agtoosa-next (repeat — spec → build → review → ship in order)
Advanced (parallel / personas): /agtoosa-spec · /agtoosa-build · /agtoosa-review · /agtoosa-ship · /agtoosa-handoff · /agtoosa-review cross-model
/agtoosa-help and /agtoosa-help next are on-demand assistance — preview only; run /agtoosa-next to execute.
Key files
Docs/Master-Plan.md— project management source of truthDocs/AgToosa_Goal.md— goal clarification utility/sub-workflowDocs/AgToosa_AgentCapability.md— lifecycle routing matrix (installed surfaces → handoff/review paths)Docs/Context/— product, tech-stack, and workflow configurationDocs/archived/— completed specs and plansDocs/AgToosa_Changelog.md— auto-maintained changelog
Authoring resources
Static maintainer-guide links (print as-is; do not fetch or treat as local Docs paths):
- Platform extensions: https://github.com/sky2464/AgToosa/blob/main/docs/extension-authoring-guide.md
- Registry packs: https://github.com/sky2464/AgToosa/blob/main/docs/registry-pack-authoring.md
/agtoosa-help next (read-only preview — hand off to Next)
- Run the same routing as
/agtoosa-next dry:bash agtoosa.sh --status-line [path] --route-hint --format json(readDocs/AgToosa_Next.mdfor full rules). Never modify files, git state, or Master-Plan. - Output preview:
AgToosa Next (dry) → /agtoosa-<command> (<story-id|none>) — <rationale>
SYNC: ...
To execute: /agtoosa-next
(This preview did not modify anything.)
- Do not auto-run mutating workflows from help — execution is
/agtoosa-nextonly. - Do not invoke this path for freeform
next/do it— those PROGRESS utterances execute/agtoosa-nextperDocs/AgToosa_Agent.md.
- Command:
/agtoosa-help(command.help) - Canonical workflow:
Docs/AgToosa_Agent.md - Modes:
full,next - Question budget: max 0; Quick max: 0
- Mutation class:
read-only - Approval gate: none
- Phase stop: none
- Lifecycle close:
none
