delorenj B. User Prompting
When the workflow needs user input, prompt the user conversationally:
- Present options as a numbered list in your response text
- Ask the user to reply with their choice
- For multi-select, ask for comma-separated numbers
C. Tool Usage
Use these Augment tools when executing GSD workflows:
launch-processfor running commands (terminal operations)str-replace-editorfor editing existing filesviewfor reading files and listing directoriessave-filefor creating new filesgrepfor searching code (or use MCP servers for advanced search)web-search,web-fetchfor web queriesadd_tasks,view_tasklist,update_tasksfor task management
D. Subagent Spawning
When the workflow needs to spawn a subagent:
- Use the built-in subagent spawning capability
- Define agent prompts in
.augment/agents/directory
Mode routing:
- default (no flag): Capture as a structured todo for later work → add-todo workflow
- --note: Zero-friction idea capture (append/list/promote) → note workflow
- --backlog: Add an idea to the backlog parking lot (999.x numbering) → add-backlog workflow
- --seed: Capture a forward-looking idea with trigger conditions → plant-seed workflow
- --list: List pending todos and select one to work on → check-todos workflow
| Flag | Destination | Workflow |
|---|---|---|
| (none) | Structured todo in .planning/todos/ | add-todo |
| --note | Timestamped note file, list, or promote | note |
| --backlog | ROADMAP.md backlog section (999.x) | add-backlog |
| --seed | .planning/seeds/SEED-NNN-slug.md | plant-seed |
| --list | Interactive todo browser + action router | check-todos |
Parse the first token of {{GSD_ARGS}}:
- If it is
--note: strip the flag, pass remainder to note workflow - If it is
--backlog: strip the flag, pass remainder to add-backlog workflow - If it is
--seed: strip the flag, pass remainder to plant-seed workflow - If it is
--list: pass remainder (optional area filter) to check-todos workflow - Otherwise: pass all of {{GSD_ARGS}} to add-todo workflow