Convoke plugin
Convoke installs BMAD-format agent teams: Vortex for validating ideas with users and Gyre for production readiness review.
- 69 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The installer copies agent and menu files into the project and agents write reports to `_bmad-output/` and `.gyre/`.
- Gyre reads the project filesystem to detect the stack.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/convokeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The installer copies agent and menu files into the project and agents write reports to `_bmad-output/` and `.gyre/`.
- Gyre reads the project filesystem to detect the stack.
This is third-party code. Review the repository files before installing.
What it does
Convoke extends the BMAD method to the stages before and after development. The Vortex team of seven agents (Emma, Isla, Mila, Liam, Wade, Noah, Max) runs from a user persona and problem framing to hypotheses, experiments and a next-step decision. The Gyre team of four agents (Scout, Atlas, Lens, Coach) detects the project stack, builds a model of required capabilities and finds production readiness gaps. An agent is a markdown file with a persona, menu and workflow. In Claude Code agents are slash commands; elsewhere the file is pasted into the conversation. Vortex output lands in `_bmad-output/vortex-artifacts/` and Gyre findings in `.gyre/`. Separate skills add capabilities to existing agents, for example RICE-scored backlog management through `/bmad-enhance-initiatives-backlog`.
Who it is for. Product managers and developers who use the BMAD method or want a structured check of an idea and of launch readiness.
Good fit when
- Before building, you need a user persona, a problem statement and a tested hypothesis.
- Before going to production, you need a stack-specific reliability gap list.
- An initiatives backlog needs RICE scoring.
- BMAD agent work needs routing: which agent takes the next step.
Not a fit when
- You need a ready general agent set outside the BMAD format; the author does not yet export Convoke's own team agents to other environments.
- You need a one-off code check without installing an npm package.
- You need one ready skill for a narrow task: Vortex and Gyre teams are built for a whole process.
Example request
Activate Emma from Vortex, choose Lean Persona and walk me through the steps for a meal planning app.Limitations
Installation goes through npm. All 11 Convoke agents are in the pipeline tier, so exporting them to a self-contained document is refused: only standalone skills can travel. Interview reports about real people are written to `_bmad-output/private/`, which should stay out of git. The package follows the BMAD layout: agent and menu files are copied into the project, so changes appear in your repository and in commits. `_bmad-output/private/` holds interviews with real people and is git-ignored; keep it that way.
How to disable. Remove the `convoke-agents` dependency and the `_bmad` and `.gyre` directories if unneeded. Updates never touch `_bmad-output/` artifacts; delete them by hand.
FAQ
How do I install Convoke?
Run `npm install convoke-agents@latest`, then `npx -p convoke-agents convoke-install`. The installer sets up both teams and the skill modules.
Is BMAD Method required?
No. Convoke runs standalone and extends BMAD where it is installed.
How do I update Convoke?
First `npm install convoke-agents@latest`, then `npx -p convoke-agents convoke-update --dry-run` to preview and `convoke-update` to apply with an automatic backup.
What if installation fails?
Run `npx -p convoke-agents convoke-doctor`, which diagnoses the installation.
Which agents make up Gyre?
Scout, Atlas, Lens and Coach. Gyre detects the stack, builds a capabilities model and stores findings in `.gyre/`.
Discussion
No questions or reviews yet.
Related
PluginsVBW
Vibe Better With Claude Code
A Claude Code plugin where a team of agents builds the work and a bash kernel accepts nothing until checks pass.
A workflow template for Claude Code and five more agents: a backlog task, a diff review and a commit.
A 33-skill plugin with gates: question the request, verify facts against sources, test first, review by a second model
Claude Craft adds rules, agents and commands to Claude Code projects: BMAD sprints, reviewers for 11 stacks, browser acceptance.
metaswarm runs a task through 23 agents and 9 phases: research, plan, review, TDD execution, PR and a post-merge retrospective.
Six commands for Claude Code, Codex and Cursor: the main session holds context while fresh agents review the problem and diff.
README in short
Two agent teams across lifecycle stages: Vortex at discovery and Gyre at readiness. Every workflow ends by routing to the agent who picks up next.