[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

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.

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

workflow-start