Spec Kitty Status

---
name: spec-kitty-status
description: Display kanban board status showing work package progress across lanes (planned/doing/for_review/done).
---

## Status Board

Show the current status of all work packages in the active feature. This displays:
- Kanban board with WPs organized by lane
- Progress bar showing completion percentage
- Parallelization opportunities (which WPs can run concurrently)
- Next steps recommendations

## When to Use

- Before starting work (see what's ready to implement)
- During implementation (track overall progress)
- After completing a WP (see what's next)
- When planning parallelization (identify independent WPs)

## Implementation

Run the CLI command to display the status board:

```bash
spec-kitty agent tasks status
```

To specify a feature explicitly:

```bash
spec-kitty agent tasks status --feature 012-documentation-mission
```

The command displays a rich kanban board with:
- Progress bar showing completion percentage
- Work packages organized by lane (planned/doing/for_review/done)
- Summary metrics

## Alternative: Python API

For programmatic access (e.g., in Jupyter notebooks or scripts), use the Python function:

```python
from specify_cli.agent_utils.status import show_kanban_status

# Auto-detect feature from current directory/branch
result = show_kanban_status()

# Or specify feature explicitly:
# result = show_kanban_status("012-documentation-mission")
```

Returns structured data:

```python
{
    'feature_slug': '012-documentation-mission',
    'progress_percentage': 80.0,
    'done_count': 8,
    'total_wps': 10,
    'by_lane': {
        'planned': ['WP09'],
        'doing': ['WP10'],
        'for_review': [],
        'done': ['WP01', 'WP02', ...]
    },
    'parallelization': {
        'ready_wps': [...],
        'can_parallelize': True/False,
        'parallel_groups': [...]
    }
}

## Output Example

```
╭─────────────────────────────────────────────────────────────────────╮
│                    012-documentation-mission                        │
│                     Progress: 80% [████████░░]                      │
╰─────────────────────────────────────────────────────────────────────╯

┌─────────────┬─────────────┬─────────────┬─────────────┐
│   PLANNED   │    DOING    │ FOR_REVIEW  │    DONE     │
├─────────────┼─────────────┼─────────────┼─────────────┤
│ WP09        │ WP10        │             │ WP01        │
│             │             │             │ WP02        │
│             │             │             │ WP03        │
│             │             │             │ ...         │
└─────────────┴─────────────┴─────────────┴─────────────┘

🔀 Parallelization: WP09 can start (no dependencies)
```