/wf1-kickoff

Initialize a new workflow workspace. This is the entry point for all wf1-wf5 workflows.

What This Skill Does

• Create the work directory at docs/wf/<work-id>/

• Initialize state.json to track workflow progress

• Generate 01_KICKOFF.md from the template

• Interview the user to fill in the kickoff document

Workflow

Step 1: Determine Work ID

If the user provides a work-id as an argument, use it. Otherwise, ask the user for a short, descriptive identifier (e.g., add-csv-export , fix-login-bug ). The work-id should be kebab-case.

Step 2: Check for Existing Work

Check if docs/wf/<work-id>/ already exists. If so, warn the user and ask whether to resume or create a new work-id.

Step 3: Create Directory and Files

• Create docs/wf/<work-id>/

• Copy this skill's bundled templates/01_KICKOFF.md to docs/wf/<work-id>/01_KICKOFF.md

• Create state.json with initial state:

All timestamps must use UTC in the format YYYY-MM-DDTHH:MM:SSZ (e.g., 2026-03-01T12:00:00Z ).

{ "work_id": "<work-id>", "phase": "kickoff", "created_at": "YYYY-MM-DDTHH:MM:SSZ", "updated_at": "YYYY-MM-DDTHH:MM:SSZ", "phases": { "kickoff": { "status": "in_progress", "completed_at": null }, "spec": { "status": "pending", "completed_at": null }, "plan": { "status": "pending", "completed_at": null }, "impl": { "status": "pending", "completed_at": null, "current_step": null, "total_steps": null }, "review": { "status": "pending", "completed_at": null, "target": null, "verdict": null } } }

Step 4: Fill the Kickoff Document

Interview the user to fill in the kickoff document. Ask about:

• Goal: What do they want to achieve? (1-2 sentences)

• Completion criteria: How do we know it's done?

• Constraints: Any limitations or requirements?

• Out of scope: What should NOT be done?

• Dependencies: Anything this work depends on?

• Open questions: Items that need human decisions

Replace the template placeholders with the user's answers. Remove unused placeholder sections rather than leaving them empty.

Step 5: Finalize

• Update state.json : set phases.kickoff.status to "completed" and phases.kickoff.completed_at to the current timestamp

• Update phase to "spec" (next phase)

• Tell the user: the kickoff is complete, and they can proceed with /wf2-spec <work-id>

Important Notes

• The template is bundled with this skill at skills/wf1-kickoff/templates/01_KICKOFF.md .

• The work directory structure is: docs/wf/<work-id>/ (relative to project root)

• Always show the user the completed kickoff document before finalizing

• The kickoff document is written in Japanese (following the template language)