Issue tracking and task management using the hive system. Use when creating, updating, or managing work items. Use when you need to track bugs, features, tasks, or epics. Do NOT use for simple one-off questions or explorations.
Hive is a local-first issue tracking system designed for AI agents. This skill provides best practices for effective cell management.
NOTE: For swarm workflows, combine this skill with swarm-coordination from global-skills/.
| Type | When to Use |
|---|---|
bug | Something is broken and needs fixing |
feature | New functionality to add |
task | General work item |
chore | Maintenance, refactoring, dependencies |
epic | Large initiative with multiple subtasks |
- "Fix null pointer exception in UserService.getProfile()"
- "Add dark mode toggle to settings page"
- "Migrate auth tokens from localStorage to httpOnly cookies"
- "Fix bug" (too vague)
- "Make it better" (not actionable)
- "stuff" (meaningless)
## Problem
[Clear description of the issue or need]
## Expected Behavior
[What should happen]
## Current Behavior
[What currently happens, for bugs]
## Proposed Solution
[How to fix/implement, if known]
## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
## Notes
[Any additional context, links, or constraints]
open → in_progress → closed
↓
blocked (optional)
hive_update(id: "hv-abc123", state: "in_progress")
Use when you start working on a cell.
hive_close(id: "hv-abc123", resolution: "Fixed in commit abc1234")
Use when work is complete.
hive_update(id: "hv-abc123", state: "blocked", body: "Blocked by #hv-xyz789")
Use when you can't proceed due to a dependency.
hive_query(state: "open", type: "bug")
hive_query(search: "authentication")
hive_query(limit: 10, sort: "updated")
Epics are containers for related work:
---