workflow

# Workflow

## Purpose
Manage the development environment lifecycle for ticket-based work. This skill handles setup (branch, worktree, context) and delegates implementation to `/bugfix` or `/task` based on ticket type.

## Quick Reference
- **Creates**: Feature branch, worktree, workflow context file
- **Requires**: Ticket source (Linear ID or plain text description)
- **Delegates to**: `/bugfix` (fix tickets) or `/task` (feat, chore, refactor, docs)

### Config Location

Config path depends on how the plugin was installed:

| Plugin Scope | Config File | Git |
|--------------|-------------|-----|
| **project** | `.claude/skills/workflow.yaml` | Committed (shared) |
| **local** | `.claude/skills/workflow.local.yaml` | Ignored (personal) |
| **user** | `.claude/skills/workflow.local.yaml` | Ignored (personal) |

**Precedence when reading** (first found wins):
1. `.claude/skills/workflow.local.yaml`
2. `.claude/skills/workflow.yaml`
3. Skill defaults

## When to Use

- Starting work on a new ticket or feature
- Beginning a bug fix from a ticket system (Linear)
- Creating an isolated worktree for development
- Completing work and cleaning up after PR merge

## Commands

| Command | Description |
|---------|-------------|
| `/workflow start <source>` | Setup branch/worktree, then delegate to bugfix or task |
| `/workflow configure` | Configure workflow preferences (worktree path, IDE) |
| `/workflow continue` | Resume pending workflow in new session |
| `/workflow status` | Show current workflow context and progress |
| `/workflow finish` | Cleanup branch after PR is merged |

**Related:** Use `/pr-merge` to merge PRs, `/deploy` to deploy after merge.

## Configure Mode

Configure workflow preferences during framework setup:

```
/workflow configure
```

**Discovers:**
- Worktree base path preference
- IDE preference (Cursor, VSCode, WebStorm)
- Environment file copying settings

**Outputs:** `.claude/workflow-config.json` (via workflow-setup)

This is typically run onc