plugin-hive

Hive

Composable substrate for the agentic SDLC — user-directed, disciplined, kickoff to ship.

A Claude Code plugin that turns your project into a coordinated swarm of AI specialists with the discipline of a real software team — planning, design, execution, code review, test. Built at Firefly Events while shipping our own products. Open source.

---

What is Hive?

Hive structures AI-assisted software development into a repeatable, team-like workflow. Instead of chatting with a single assistant, you get:

• Specialized agents (analyst, architect, developer, tester, reviewer, etc.) that collaborate on your behalf
• Structured phases from kickoff to ship with built-in quality gates
• Persistent memory so agents learn from past sessions and projects
• Human-in-the-loop checkpoints where your judgment matters most

Think of it as giving your Claude Code session the discipline and coordination of a small software team — without the overhead.

---

Why use Hive?

If you've found that:

• AI coding assistants lose context on larger features
• You spend too much time re-explaining project details
• Testing and review feel ad-hoc or incomplete
• You want more reliable, repeatable results from AI-assisted work

...then Hive provides the scaffolding to make agentic development feel more like working with a competent team.

---

Quick Start

1. Prerequisites

• Claude Code CLI v2.1+ (install guide)
• Claude Code authentication: sign in normally, or use Anthropic's stored-secret flow if you want Claude Code to draw from your Anthropic subscription/API account

2. Install

# Inside any Claude Code session:
/plugin marketplace add firefly-events/plugin-hive
/plugin install plugin-hive@firefly-events/plugin-hive

3. Initialize your project

/hive:kickoff        # Discovers codebase & generates team configs

4. Daily workflow

/hive:standup   # Review yesterday, surface blockers
/hive:plan      # Design → horizontal scan → vertical slice → agent-ready stories
/hive:execute   # Orchestrator runs stories through dev workflow (research → implement → test → review → integrate)
/hive:review    # Structured code review (correctness, security, conventions)
/hive:ship      # Reconcile work, bump version, run release action, mark stories shipped

Each story produces a committed, reviewed state. The orchestrator handles coordination; you provide judgment at the planning and review gates.

---

Commands

Core workflow

• /hive:kickoff — initialize Hive for a project
• /hive:standup — daily ceremony and blockers
• /hive:triage — capture and prioritize bugs/features
• /hive:plan — decompose work into agent-ready stories
• /hive:execute — run stories through implementation workflow
• /hive:review — structured code/PR review
• /hive:test — test swarm for coverage, execution, and bug routing
• /hive:ship — reconcile, bump version, run the release action, mark stories shipped
• /hive:status — active epics, story progress, and drift trend
• /hive:ship — cut a release: reconcile stories, author human-readable changelog prose (draft → operator review → write to CHANGELOG.md), verify version bump, run ship target. Changelog format rules live in hive/references/changelog-entry-format.md.

Design & UI

• /hive:brand-system — colors, typography, spacing, visual guide
• /hive:design — wireframes and design handoff
• /hive:design-system — W3C design tokens from brand system
• /hive:design-review — critique designs or implementations
• /hive:polish-audit — motion/delight opportunities after UI audit
• /hive:visual-qa — compare implementation against design briefs
• /hive:logo-exploration — generate logo directions and contact sheets