| name | wf-start |
| description | Initialize a weft workflow from a template or inline steps. Use only when user types /wf-start. |
| argument-hint | <template-name | step1,step2,step3> |
| allowed-tools | ["Bash","Read","Write"] |
Start Weft Workflow
Initialize a new deterministic workflow.
Arguments
$ARGUMENTS
Instructions
If no arguments — guided template picker:
-
List available templates with full details:
python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" start
-
For each template, show a preview of its steps:
python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" preview <name>
-
Present the user with a numbered list like:
1. generic (3 steps) — plan, implement, verify
2. feature-workflow (12 steps) — full-cycle feature development with guards
3. Custom — describe your task and I'll build a workflow
-
Wait for the user to pick a number, name, or describe their task.
- If they pick a template: show the full preview and ask to confirm before starting.
- If they describe a task: suggest appropriate steps, confirm, then start as ad-hoc.
If a template name is given:
-
Preview it first:
python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" preview <template-name>
-
Start it:
python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" start <template-name>
If comma-separated step names are given (ad-hoc):
python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" start "step1,step2,step3"
After starting:
Display the workflow checklist and remind the user:
/wf-step complete to advance steps
/wf-status to check progress
/wf-analyze to review timing and recurring friction across runs
- The Stop hook will prevent finishing with incomplete steps
- If the current step has guards, explain what commands are blocked and why