hive-workers

name	Hive Workers
version	1.0.0
description	Execute tasks using hive mind orchestration with parallel agents, automatic code review, and documentation updates. Use for feature execution, epic completion, or complex multi-task work.
category	orchestration
tags	["hive-mind","orchestration","parallel-execution","multi-agent"]
author	Smith Horn
triggers	{"keywords":["execute with hive mind","run phase with hive mind","execute this epic","orchestrate these tasks","parallel execution with review"],"explicit":["/hive-workers"]}
composes	["governance","worktree-manager","linear"]

Hive Workers Skill

Orchestrates complex task execution using ruflo hive mind with automatic code review and documentation updates.

Quick Start

0. EXPLORE: Search codebase for existing implementations (MANDATORY)
1. Read the task or issue
2. Initialize hive mind: swarm_init({ topology: "hierarchical" })
3. Create todos: TodoWrite with all tasks
4. Execute in parallel where possible
5. Run code review with Task agent
6. Fix any "Must Fix" items
7. Run governance audit
8. Create ADR if architectural decision
9. Update project status
10. Generate sprint report
11. Cleanup: swarm_destroy, mark issues done

Execution

When triggered, immediately:

1. Read agent-prompt.md from this skill's directory (./agent-prompt.md)
2. Spawn a single Task with subagent_type: "general-purpose" passing the agent-prompt content as the prompt
3. Include in the prompt: the user's request, current working directory, and any arguments passed
4. Wait for the agent to complete
5. Present the agent's summary to the user

Sub-Documentation

Document	Contents
agent-prompt.md	Full execution workflow, phase details, checklists
context-persistence.md	Maintaining context across sessions for long-running tasks
CHEATSHEET.md	Quick reference for common operations
templates/	Workflow templates for task execution

Related Skills

• governance - Standards enforcement
• worktree-manager - Parallel development

Prerequisites

• ruflo configured (claude mcp add ruflo -- npx ruflo@v3alpha mcp start)
• Linear MCP (optional, for issue tracking)

For full execution details, see agent-prompt.md.

Changelog

v1.0.0 (2026-03)

• Initial public release
• 11-step hive mind execution workflow
• ruflo MCP integration (swarm_init, agent_spawn, task_orchestrate, swarm_destroy)
• Automatic governance audit after execution
• Context persistence across sessions (context-persistence.md)
• Workflow templates for common task types