Gem Team plugin
Gem Team installs 12 agent roles and a plan, TDD, verify, learn process in place of one-off code generation
- 229 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The roles write code and run tests, browser and DevOps commands by plan
- The APM install writes folders and files into the project and installs the manager with a script from the network
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/gem-teamDetects 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 roles write code and run tests, browser and DevOps commands by plan
- The APM install writes folders and files into the project and installs the manager with a script from the network
This is third-party code. Review the repository files before installing.
What it does
Gem Team is a set of agent definitions that turns one-off code generation into a repeatable engineering process. `.apm/agents/` holds twelve roles: orchestrator, planner, researcher, implementer, debugger, reviewer, code simplifier, documentation writer, browser tester, mobile tester, devops and skill creator. A `gem-devops-guidelines` skill is included too. The process has five steps. A request is classified and a depth of work is chosen. Simple tasks keep the plan in memory, while medium and hard ones get a persistent plan with an id you can return to. Execution runs in waves with TDD, independent tasks run in parallel and tasks that overlap on files are queued. Every task is verified, and review and security audits switch on when change risk calls for them. The last step keeps only stable patterns. Model routing is set in `.gem-team.yaml`: a strong model takes planning, debugging and review, a fast one takes research, implementation and tests. Installation goes through the APM manager with `apm install` and targets Copilot, Claude, Cursor, OpenCode, Codex, Gemini and Windsurf.
Who it is for. Developers and small teams tired of agent code without tests or review, and anyone who wants one set of roles across Copilot, Claude, Cursor, Codex and other clients.
Good fit when
- A task is of medium complexity and you want a persistent plan with an id that can be paused and resumed
- A change touches security or infrastructure and review and audit should switch on by risk
- The project uses several clients and roles must be installed into Copilot, Claude and Cursor with one command
- You want expensive and cheap stages split across models through `.gem-team.yaml`
- A UI has to be checked in a browser or on mobile: dedicated tester roles handle that
Not a fit when
- A one-line fix: a process with plans and checks is overkill
- You cannot install the APM manager and do not want to lay files out per client by hand
- You want a single skill for one task rather than a full twelve-role process
Example request
Start the Gem Team orchestrator: plan adding CSV export, implement it with tests and run the reviewer before finishingLimitations
- Installation goes through Microsoft's APM manager, which has to be installed first with the script from the docs.
- The cost and speed figures in the README were measured by the author on one model (DeepSeek V4.1 Flash through CommandCode) and can differ on others.
- The roles keep persistent plans and accumulate patterns, so `apm.yml`, `apm.lock.yaml` and client folders appear in the project and are committed to the repository.
- The last commit is from late October 2026.
How to disable. Remove the mubaidr/gem-team dependency from `apm.yml` and `apm.lock.yaml` and delete the client folders APM generated (`.claude/`, `.cursor/`, `.codex/` and others) if you no longer need them. Remove the `.gem-team.yaml` file by hand.
FAQ
How do I install Gem Team in Claude Code?
Install the APM manager, then run `apm install mubaidr/gem-team --target claude` in the project. For several clients list the targets separated by commas.
Which roles does Gem Team include?
Twelve: orchestrator, planner, researcher, implementer, debugger, reviewer, code simplifier, documentation writer, browser and mobile testers, devops and skill creator.
How do I pin a Gem Team version?
Use a release tag: `apm install 'mubaidr/gem-team#gem-team-v<version>' --target copilot`. A repeated `apm install` replays the commit from `apm.lock.yaml` and does not upgrade.
How is Gem Team different from Superpowers?
Superpowers gives the agent a process through skills: clarification, plan, TDD, subagents and review. Gem Team installs a set of ready roles with persistent wave plans, model routing and APM installation into seven clients.
How do I set up model routing?
Enable the `model_routing` block in `.gem-team.yaml`: the `premium` tier takes planning, debugging and review, and the `explore` tier takes research, implementation and tests. You choose the models and providers yourself.
Discussion
No questions or reviews yet.
Related
PluginsA Gemini CLI extension on the PDCA cycle: 21 agents, 35 skills and 24 commands for planning, design, build and analysis
APM
APM (Agent Package Manager)
A package manager for AI agent context: skills, prompts and MCP servers install with one command across supported agents
A library of 89 subagents for Gemini CLI and Antigravity CLI: review, security, testing, DevOps, data and language experts.
Agentic OS adds a five-step workflow and checks in git hooks and CI so that a step without evidence does not count as done
metaswarm runs a task through 23 agents and 9 phases: research, plan, review, TDD execution, PR and a post-merge retrospective.
AGENTS.md instructions and skills with a test-first process that scales to the task, for Cursor, Codex CLI, Gemini CLI.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Gem Team (this card) | no | 229 | |
| Superpowers | no | 316,679 | a process defined by skills: clarification, plan, TDD, subagents and review |
| BMad Method | no | 55,288 | a skill set from idea and PRD through architecture, stories and review |
README in short
The README starts from the claim that one-off code without a process gives unstable quality and presents the fix as a delivery discipline. It then covers reasons to choose the package, model routing, a quick start through APM and the five steps of the process. The features list follows: risk-based checks, context savings, parallel waves and task routing.