Synced from Hive. This page is pulled from hivecommons/hive@v5 during the docs build. Edit the canonical source in the Hive repository.
Integration guide
Audience: platform teams and tool authors who want Hive to read a non-GitHub backlog, lend external execution capacity, or connect planning/specification tools without over-claiming what v5 can do today.
The canonical Hive documentation source for the published Hive docs is this repository’s src/docs/ tree. The separate hivecommons/docs site repository is the Next.js/Nextra shell for docs.hivecommons.dev; its README says the site syncs Hive content from hivecommons/hive src/docs/ on branch v5. Put Hive guide changes here first, then let that mirror pick them up.
Two external projects shaped these surfaces and remain the reference integrations: Flue, the report-only external-execution pilot behind the pkg/extwork contract, and Crustify, the C/C++-to-Rust migration harness whose Wavefront migration graph is consumed as an additive work source (see work sources and the wavefront-smoke.yml canary).
Extension surfaces in v5
| Surface | What you can do today | Start here |
|---|---|---|
| Work sources | Add or configure an adapter that turns source-native items into worksource.Issue values. The primary adapters linked today are GitHub Issues, GitHub Projects, Linear, and Jira; run stages and the Crustify Wavefront migration graph are additive sources. | Work source providers |
| ClankeR + Flue-style external execution | Use the contributor relay as the transport and the pkg/extwork contract as the engine-neutral admission/observation seam. Flue is the reference HTTP adapter. | ClankeR and Flue-style external execution |
| Spektacular | Let Hive poll a Spektacular-compatible CLI for spec/plan status and import final plan tasks into Hive’s run flow. | Spektacular and Project Inception |
| vibe-kanban (report-only) | Mirror repository’s admitted hive queue a local vibe-kanban board through its MCP server. way: hive keeps admission and acceptance. Optionally records board pick-ups of queued items as shadow executions in a local log. Default off. | vibe-kanban mirror |
Related surfaces that are not redefined here: agent configuration, CLI/backend setup, MCP write policy, hub API, contributor relay, work sources, long-running runs, and Spektacular runner.
Terminology
Use source-neutral words in generic integration docs: work source, project, item, and change request. Keep product names when talking about a specific adapter, such as GitHub Projects or Jira. The glossary and guard-test intent live in Work-source terminology.