---
name: hive
description: Lightweight feature tracker for parallel worktree development. Provides commands for breaking down projects into features and executing them in parallel via zero-conflict worktrees, or sequentially with a single agent.
---

# Hive — Lightweight Feature Tracker

No database, no MCP — just `features.md` as the single source of truth.

## Workflow

```
/hive:spec                    →  features.md (smart: detects context)
  OR step-by-step:
  /hive:map-codebase          →  .hive/codebase-map.json + summary.md
  /hive:to-features-md        →  features.md

/hive:worktree-split --count 3 --warp  →  N worktrees with territory mapping
/hive:run                     →  Sequential execution (one feature at a time)
/hive:status                  →  Progress report
/hive:q <question>            →  Read-only project exploration
/hive:worktree-merge <wt>    →  Merge completed worktree back
```

## Commands

| Command | Description |
|---------|-------------|
| `/hive:spec` | Create or edit `features.md` interactively (scout → planner → reviewer chain) |
| `/hive:map-codebase` | Analyze codebase → `.hive/codebase-map.json` + `summary.md` |
| `/hive:to-features-md` | Convert `.hive/` analysis into `features.md` |
| `/hive:run` | Sequential agent execution from `features.md` |
| `/hive:status` | Show progress from `features.md` |
| `/hive:next` | Show the next feature to implement |
| `/hive:q` | Ask questions about the project (read-only) |
| `/hive:worktree-split` | Split into N zero-conflict worktrees |
| `/hive:worktree-merge` | Merge a completed worktree back into main |

## features.md Format

```markdown
# Features

## Feature 1: <Title>
- Description: <What and why>
- Dependencies: <Feature N, or "none">
- Status: pending
```

Status values: `pending`, `in_progress`, `done`

## Flags

- `--auto-approve` — Skip confirmation prompts
- `--warp` — Use Warp Terminal for worktree-split
- `--count N` — Number of worktrees (1-10, default 3)
- `--features "1,2;3,4"` — Explicit feature grouping for worktree-split