The useful idea here is the handoff: when the agent switches from architecture to implementation, the decisions and their rationale move with the task, so the next role does not re-derive them or contradict them. Two things to know going in — the server guides but never executes, so it is a discipline layer over an agent that still does the work, and setup does not end at the config block: the rules have to be initialised per client, and Claude Code needs that file wired into `CLAUDE.md` by hand.
A workflow-guidance server for AI coding agents. Rather than executing work itself, it hands the agent structured rules for the step it is on and carries context across role changes — the README's own framing is guidance without execution. Work moves through four roles: Product Manager for project setup and task creation, Architect for technical design and implementation planning, Senior Developer for implementation and testing, and Code Review for security and performance checks before approval. Built on NestJS with Prisma over SQLite or PostgreSQL.
- `init_rules` — generates the agent rules (custom modes) for your client; `cursor`, `copilot`, `roocode` and `kilocode` are the supported targets
- `get_step_guidance` — for an execution and a role, the step to take, the approach broken into ordered actions, a quality checklist, and the decisions carried over from earlier roles
- `report_step_completion` — report the result and metrics back, which is what advances the workflow and preserves the handoff
- Role transitions that keep state: the current role, which steps are finished, the decisions made and the reasoning behind them travel with the task instead of living in the transcript
- Two ways to run it: `npx @hive-academy/anubis` with `PROJECT_ROOT` set, or the `hiveacademy/anubis` Docker image with your project mounted at `/app/workspace` and `.anubis` mounted alongside it
Node.js 18.0.0 or newer for the npx path, or Docker for the image. No account and no external service — state lives in a local database through Prisma. `PROJECT_ROOT` tells the server which project it is working in. After the server is running there is a second step that is easy to miss: ask the agent to call `init_rules` for your client before starting any work, which is what writes the custom mode or rules file. On Claude Code the rules are not generated for you — download the repository's rules markdown, save it into your project, and reference it from `CLAUDE.md`. Package `@hive-academy/anubis` (1.2.26) on npm. MIT licensed.
One command — npx -y @hive-academy/anubis