[MANDATORY] You MUST use TaskCreate to break ALL work into small tasks BEFORE starting. NEVER skip task creation.
Quick Summary
Goal: Activate a workflow by ID, creating tracking tasks and announcing the workflow sequence.
Workflow:
-
Match -- Validate workflow ID against catalog
-
Create -- Set up TaskCreate items for all workflow steps
-
Announce -- Tell user the detected intent and workflow sequence
Key Rules:
-
AI MUST always detect nearest workflow and ask user via AskUserQuestion to confirm activation
-
Present "Activate [Workflow] (Recommended)" vs "Execute directly without workflow"
-
Create workflow-level tasks BEFORE any implementation tasks
Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).
Workflow Start
Activate a workflow from the injected catalog and initialize step tracking via TaskCreate.
When to Use
-
Starting a detected workflow from the injected catalog
-
Initializing workflow state for step-by-step execution
-
Switching from one active workflow to another
NOT for: Manual step execution (follow TaskCreate items), workflow design (use planning ), or workflow catalog management.
Quick Reference
Workflow
-
Read the workflow catalog injected by the hook
-
Validate the workflow ID against available entries
-
Create workflow state via the workflow-step-tracker hook
-
Create TaskCreate items for ALL sequence steps immediately
-
Begin first step, marking it in_progress
Related
-
Command: /workflow-start <workflowId>
-
Hook: workflow-step-tracker.cjs
-
Hook: workflow-router.cjs
Activation Rules
-
Call ONLY after reading the workflow catalog injected by the hook
-
Use the exact workflow ID shown in the catalog (e.g., feature , bugfix , investigation )
-
ALWAYS ask the user via AskUserQuestion to confirm activation before proceeding
-
If called while another workflow is active, it will auto-switch (end current, start new)
After Activation
Your FIRST action after activation MUST be calling TaskCreate once for EACH workflow step:
TaskCreate: subject="[Workflow] /step-command - Step description", description="Workflow step", activeForm="Executing step"
Create ALL tasks first, then mark the first task in_progress via TaskUpdate . Do NOT skip this.
See Also
-
planning skill - Creating implementation plans
-
feature-implementation skill - Implementing features after planning
-
debug skill - Bug fix workflows
IMPORTANT Task Planning Notes (MUST FOLLOW)
-
Always plan and break work into many small todo tasks
-
Always add a final review todo task to verify work quality and identify fixes/enhancements