dex-workflow

# Dex Workflow - Task-Based Feature Implementation

**Current branch:** !`git branch --show-current 2>/dev/null || echo "not in git repo"`
**Task status:** !`dex status 2>/dev/null | head -5 || echo "dex not configured"`

Dex is a CLI for persistent task tracking across sessions. Tasks sync with
GitHub issues and support native cross-session resume.

## When to Use Dex Workflow

- Implementing stories from a PRD spec
- Tracking implementation progress across sessions
- Resuming work after `/clear` or session restart
- When you need GitHub issue sync

## Daily Workflow

### Check Status

```bash
dex status                  # Dashboard with stats, ready tasks, recent completions
dex list                    # All pending tasks (tree view)
dex list --ready            # Unblocked tasks ready to work
dex list --in-progress      # Currently claimed tasks
dex list --blocked          # Tasks waiting on dependencies
```

### Start Working

```bash
dex list --ready            # See what's available
dex show <id> --full        # Read full task details
dex start <id>              # Claim the task (marks in-progress)
```

If task has skills metadata, load them first:
```bash
# Look for "Skills:" line in task description
/Skill <skill-name>
```

### Complete a Task

Use `/complete` command (wraps reviewers + dex complete):
```bash
/complete <task-id>
```

Or manually:
1. Run reviewers (code-simplifier + kieran)
2. Address findings
3. Commit with task reference
4. Mark complete with verified result:
```bash
dex complete <id> --result "What changed: X. Verification: N tests passing."
```

### GitHub Sync

```bash
dex sync                    # Push tasks to GitHub issues
dex sync --github           # Explicit GitHub sync
dex import #123             # Import existing GitHub issue
dex export <id>             # One-time export (no sync)
```

## Task Creation from PRD Spec

### Using `dex plan` (Recommended)

After writing spec with Implementation Stories section:

```bash
dex plan plans