awesome-copilot/plugins/gem-team/README.md

Gem Team

Turn AI coding into an engineering process.

Agent definitions that enforce good software engineering: optimizing cost, time, and quality.

Visit Homepage

The Problem

Current AI coding is often one-off and ad-hoc. You get code, but you don't get a repeatable process. This leads to inconsistent quality, wasted tokens, and a lack of long-term learning.

The Solution

Gem Team wraps your AI with a disciplined engineering delivery system. It enforces good software engineering practices automatically, so you get better results with less effort.

Why Gem Team?

• Quality by Default: TDD, code reviews, and security audits happen automatically. No more "vibe coding" that breaks in production.
• Smart & Efficient: Optimized for fewer tokens and lower costs. Progressive context management prevents bloat and keeps your AI focused.
• Works With Your Tools: Seamless integration with Copilot, Claude, Cursor, Codex, Gemini, and Windsurf. Use your preferred environment.
• Learns & Improves: Remembers what works and extracts reusable skills. Your AI gets smarter and more efficient over time.

Intelligent Model Routing

Gem Team automatically uses the right model for each kind of work:

• Premium models handle planning, debugging, critique, and review where deeper reasoning matters.
• Explore models handle research, implementation, testing, documentation, and other bounded tasks efficiently.
• Configurable tiers let you choose the models and providers that fit your budget and workflow.

This gives you stronger verification where it matters without paying the highest model cost for every task. Configure it once in .gem-team.yaml:

model_routing:
  enabled: true
  tiers:
    premium: "your-strong-model (provider)"
    explore: "your-fast-model (provider)"

TL;DR: Gem Team turns AI coding into a structured, repeatable engineering process with built-in quality, efficiency, and learning.

Quick Start

Install APM first:

# macOS / Linux
curl -sSL https://aka.ms/apm-unix | sh

# Windows PowerShell
irm https://aka.ms/apm-windows | iex

# Verify
apm --version

Install Gem Team into your current project:

apm install mubaidr/gem-team --target copilot,claude,cursor,opencode,codex,gemini,windsurf

Or install for one target only:

apm install mubaidr/gem-team --target copilot

After the first install, commit the generated APM files that belong to your repo, especially apm.yml, apm.lock.yaml, and the generated harness directories such as .github/, .claude/, .cursor/, .opencode/, .codex/, .gemini/, or .windsurf/. Do not commit apm_modules/.

APM can auto-detect targets from existing harness directories, but explicit --target is recommended for predictable installs and fresh repositories.

The Process

Gem Team uses a structured workflow to turn AI coding into a reliable engineering process:

1. Plan: Analyze the task, break it down, and create a structured plan with verification gates.
2. Build: Implement features using TDD, following best practices and design patterns.
3. Review: Automated code reviews, security audits, and accessibility checks at every step.
4. Learn: Extract reusable skills and patterns from successful tasks to improve future performance.

Features

• Automated Quality Gates: TDD, code reviews, and security/accessibility audits happen automatically.
• Effortless Context: Progressive context management prevents bloat and keeps your AI focused.
• Smart Routing: Tasks are automatically routed to the right agents based on complexity.
• Reusable Knowledge: High-confidence patterns and skills are extracted and reused for future tasks.
• Cost Efficiency: Model routing and output hygiene ensure you only use the tokens you need.

How it Works

Gem Team installs a set of specialized agents that work together under the guidance of an Orchestrator. This team follows a disciplined workflow that includes planning, implementation, verification, and learning.

• Specialist Agents: Dedicated agents for planning, research, implementation, review, and more.
• Orchestration: An Orchestrator coordinates the team, ensuring tasks are completed in the right order and verified at every step.
• Context Management: Plan-level context in each plan.yaml gives every agent the information it needs without redundant reads or wasted tokens.

Agent Roles

Role	Description
Orchestrator	Coordinates the workflow and ensures all tasks are completed correctly.
Planner	Breaks down complex tasks into manageable steps.
Implementer	Writes the code using TDD and best practices.
Reviewer	Verifies code quality, security, and compliance with requirements.
Debugger	Diagnoses bugs with root-cause analysis (never implements fixes).
Researcher	Explores the codebase and finds the best patterns to use.
Designer	Creates UI/UX designs, layouts, and design systems.
Designer Mobile	Creates mobile UI/UX following HIG and Material Design guidelines.
Impl. Mobile	Implements mobile features with TDD for iOS/Android.
Tester	Runs E2E browser tests and visual regression.
Tester Mobile	Runs mobile E2E tests on iOS/Android simulators.
DevOps	Manages deployments, CI/CD, and infrastructure with approval gates.
Documentation	Writes technical docs, API references, and walkthroughs.
Code Simplifier	Refactors code to reduce complexity and remove dead code.
Critic	Challenges assumptions and finds edge cases before implementation.
Skill Creator	Extracts reusable patterns into packaged agent skills.

Compatible Tools

Gem Team works with your favorite AI coding tools:

Tool	Harness	Description
Copilot	.github/agents/	VS Code Copilot / GitHub Copilot CLI
Claude	.claude/agents/	Claude Code
Cursor	.cursor/agents/	Cursor
OpenCode	.opencode/agents/	OpenCode
Codex	.codex/agents/	Codex CLI
Gemini	GEMINI.md	Gemini CLI
Windsurf	.windsurf/rules/	Windsurf / Cascade

Configuration

Gem Team is designed to work out of the box with smart defaults. You can customize behavior by editing the AGENTS.md file or specific agent definitions in the .apm/agents/ directory.

Learn More

• Documentation
• Contributing
• License

Support

If you have questions or need help, please open an issue on GitHub.