Beakpoint-Insights/roost
33 stars · Last commit 2026-11-04
Spec-driven development that doesn't stop at the code: coding agents take an idea to release, and you make the calls.
README preview
<p align="center"><img src="assets/winston.png" width="160" alt="Winston, the Beakpoint bird"></p> # roost [](https://github.com/Beakpoint-Insights/roost/releases) [](LICENSE) [](#install) **Spec-driven development that doesn't stop at the code.** roost takes a product idea all the way to production. It shapes the epic, builds it slice by slice with one coding-agent session per repo, reviews the whole epic, QAs it in a real browser, and walks you through the rollout one command at a time. - **The whole cycle, not just the build.** Most spec-driven kits hand off once the code is written. roost carries on through review, close-out, release QA and the rollout. - **You make the calls.** Agents do the work and stop at named checkpoints: the plan, each slice's findings, what's deferred, and each rollout gate. You run every rollout command yourself. - **Nothing lives only in a chat.** Plans, kickoffs, carry-over and test results go in your tracker, so any run can be picked up where it left off. - **One agent per repo.** An orchestrator session drives a worker session in each repo, in order, against your real local stack. - **Its behavior is tested.** [Eval cases](CONTRIBUTING.md#evals) check what the skills do, run with and without roost. roost is a set of skills, not an agent: it hosts nothing and runs inside your coding agent. It's opinionated about **how** the work goes: test-first, small PRs on a stack, your decisions at named checkpoints, nothing left only in a chat, and a rollout runbook you run yourself. It's open about **which tools** you use: your tracker, test tool, repos, local stack, branching and deploy rules come from one team config file, and each tool plugs in through an adapter. Today roost runs fully in Claude Code with Jira, Xray and `gh stack` on GitHub. Other trackers, test tools, git hosts and coding agents are [on the roadmap](https://github.com/Beakpoint-Insights/roost/milestones). **Brought to you by [Beakpoint](https://beakpointinsights.com).** Beakpoint built roost and uses it every day to build its own product. Winston, the bird at the top of this page, is Beakpoint's mascot.