# Wf Start

> Initialize a weft workflow from a template or inline steps. Use only when user types /wf-start.

- Skill: `ccplugins/wf-start` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ccplugins/wf-start`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ccplugins/wf-start/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: ccplugins (https://skillmd.com/u/ccplugins)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/ccplugins/wf-start

---


# Start Weft Workflow

Initialize a new deterministic workflow.

## Arguments
$ARGUMENTS

## Instructions

### If no arguments — guided template picker:

1. List available templates with full details:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" start
   ```

2. For each template, show a preview of its steps:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" preview <name>
   ```

3. 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
   ```

4. 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:

1. Preview it first:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" preview <template-name>
   ```

2. Start it:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/core/cli.py" start <template-name>
   ```

### If comma-separated step names are given (ad-hoc):

```bash
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-dashboard` to open the live monitoring TUI
- The Stop hook will prevent finishing with incomplete steps
- If the current step has guards, explain what commands are blocked and why