Spektacular (Spek) takes a markdown spek and uses AI coding agents to plan and implement your features. Agent-agnostic. Pluggable.
brew install hivecommons/homebrew-repo/spektacular Write a spek. Spek plans, then implements, driving the coding agent of your choice from a single markdown source of truth.
Plan turns a spek into a detailed implementation plan, exploring the codebase and asking questions as it goes. Implement drives a coding agent through the plan and validates the result against your acceptance criteria.
Everything you need for structured, AI-assisted planning, without locking you into a single agent, source of truth, or workflow.
Write a markdown spek. Spek drives plan and implement from it, keeping intent reviewable at every stage.
Spek interviews you before drafting a spek, asking adaptive questions instead of a fixed script, so you get a complete spek even when you haven’t fully thought the feature through yet.
Speks, plans, and knowledge are stored behind a Store interface. The coding agent is behind an Agent interface. Swap either out.
Every repository brings its own knowledge store, and the project adds any shared ones. Spek tags each result with the tier and store it came from.
Ships with Claude Code, Bob, Codex, and oh-my-pi (omp) agents. Pick the one your team already uses, or register your own.
Spec, plan, and implement each run as stepwise state machines. Stop, inspect, edit, and resume: no work is lost.
Apache 2.0 licensed. Build on it, extend it, run it anywhere. Contributions welcome.
Spek is developed under Hive Commons, the umbrella community for Hive — AI-agent fleet orchestration with governed, audited agent swarms.
Spek handles one feature at a time: a spek, a plan, and an implementation you can review. Hive Commons is where that work is scaled up — Hive itself orchestrates fleets of coding agents across repositories, with the governance and audit trail that running agents at that scale demands.
The two fit together deliberately. A Spek workflow is the unit of work a fleet orchestrator schedules, and its artifacts — the spek, the plan, the changelog record — are the audit trail that makes an agent’s output reviewable rather than merely plausible.
Alongside them the community maintains related tooling for agent-assisted
development, including hotshot, pluk, promptargs, rationguard and
dibs.
Spek is free and open source. Start with a spek, ship with confidence.