Self-Learning Multi-agent orchestration framework for spec-driven development and automated verification.
⚡ The verification-first coding framework that wraps your LLM in TDD loops, security gates, and self-correction cycles.
See all installation options below.
- 🚀 Quick Start
- 🎯 Who's It For?
- 🤔 Why Gem Team?
- 🏗️ Architecture
- 📦 Installation
- 🤖 The Agent Team
- 📚 Knowledge Sources
- 🤝 Contributing
| 👥 Teams | 🧑💻 Solo Devs | 🏢 Enterprises |
|---|---|---|
| Complex multi-file features with reliable verification | Faster shipping with debugging auto-pilot | Security compliance, audit trails, accessibility |
- ⚡ 4x Faster — Parallel execution with wave-based execution
- 🌊 Wave-Based — Parallel agents with integration gates per wave
- ♻️ Pattern Reuse — Codebase pattern discovery prevents reinventing wheels
- 🏆 Higher Quality — Specialized agents + TDD + verification gates + contract-first
- 🔒 Built-in Security — OWASP scanning, secrets/PII detection on critical tasks
- 👁️ Full Visibility — Real-time status, clear approval gates
- 🛡️ Resilient — Pre-mortem analysis, failure handling, auto-replanning
- ♿ Accessibility-First — WCAG compliance validated at spec and runtime layers
- 🚀 Safe DevOps — Idempotent operations, health checks, mandatory approval gates
- 🔎 Final Review — Optional user-triggered comprehensive review of all changed files
- 💬 Constructive Critique — gem-critic challenges assumptions, finds edge cases
- 🧠 Continuous Learning — Memory tool persists patterns, gotchas, user preferences across sessions
- 🎯 Auto-Skills — Agents extract reusable SKILL.md files from successful tasks (high confidence: auto, medium: confirm)
- 📏 Established Patterns — Uses library/framework conventions over custom implementations
- 🧠 Context Scaffolding — Maps large-scale dependencies before the model reads code, preventing context-loss in legacy repos
- 📋 Source Verified — Every factual claim cites its source; no guesswork
- 📚 Knowledge-Driven — Prioritized sources (PRD → codebase → AGENTS.md → Context7 → docs)
- 🛠️ Skills & Guidelines — Built-in skill & guidelines (web-design-guidelines)
- 🪞 Self-Correcting — All agents self-critique at 0.85 confidence threshold
- ⚖️ Intent vs. Compliance — Shifts the burden from writing "perfect prompts" to enforcing strict, YAML-based approval gates
- 🔬 Smart Debugging — Root-cause analysis with stack trace parsing + confidence-scored fixes
- 🔗 Traceable — Self-documenting IDs link requirements → tasks → tests → evidence
- 📐 Spec-Driven — Multi-step refinement defines "what" before "how"
- 🗂️ Verified-Plan — Complex tasks: Plan → Verification → Critic
- 🩺 Diagnose-then-Fix — gem-debugger diagnoses → gem-implementer fixes → re-verifies
⚠️ Pre-Mortem — Failure modes identified BEFORE execution- 📝 Contract-First — Contract tests written before implementation
- 🎨 Design Agents — Dedicated agents for web and mobile UI/UX with anti-"AI slop" guidelines for distinctive aesthetics
- 📱 Mobile Agents — Native mobile implementation (React Native, Flutter) + iOS/Android testing
Raw reasoning isn't enough in single-pass chat. Gem-Team wraps your preferred LLM in a rigid, verification-first loop, fundamentally boosting its effective capability on SWE tasks.
Gem Team includes specialized design agents with anti-"AI slop" guidelines for distinctive, modern and unique aesthetics with accessibility compliance.
| Type | Storage | 1-liner |
|---|---|---|
| 🧠 Memory | /memories/ |
Facts & user preferences (auto-save) |
| 🎯 Skills | docs/skills/ |
Procedures with code examples |
| 📐 Conventions | AGENTS.md |
Static rules (requires approval) |
User Goal → Orchestrator → [Simple: Research/Plan] or [Complex: Discuss → PRD → Research → Plan → Approve] → Execute (waves) → Summary → Final Review
↓
🔁 Diagnose → Fix → Re-verify
| Method | Command / Link | Docs |
|---|---|---|
| Code | Install Now | Copilot Docs |
| Code Insiders | Install Now | Copilot Docs |
| APM (All AI coding agents) |
apm install mubaidr/gem-team |
APM Docs |
| Copilot CLI (Marketplace) | copilot plugin install gem-team@awesome-copilot |
CLI Docs |
| Copilot CLI (Direct) | copilot plugin install gem-team@mubaidr |
CLI Docs |
| Windsurf | codeium agent install mubaidr/gem-team |
Windsurf Docs |
| Claude Code | claude plugin install mubaidr/gem-team |
Claude Docs |
| OpenCode | opencode plugin install mubaidr/gem-team |
OpenCode Docs |
| Manual (Copy agent files) |
VS Code: ~/.vscode/agents/ VS Code Insiders: ~/.vscode-insiders/agents/ GitHub Copilot: ~/.github/copilot/agents/ GitHub Copilot (project): .github/plugin/agents/ Windsurf: ~/.windsurf/agents/ Claude: ~/.claude/agents/ Cursor: ~/.cursor/agents/ OpenCode: ~/.opencode/agents/ |
— |
| Role | Description | Sources | Recommended LLM |
|---|---|---|---|
| 🎯 ORCHESTRATOR | The team lead: Orchestrates research, planning, implementation, and verification | PRD, AGENTS.md | Closed: GPT-5.4, Gemini 3.1 Pro, Claude Sonnet 4.6 Open: GLM-5, Kimi K2.5, Qwen3.5 |
| 🔍 RESEARCHER | Codebase exploration — patterns, dependencies, architecture discovery | PRD, codebase, AGENTS.md, docs | Closed: Gemini 3.1 Pro, GPT-5.4, Claude Sonnet 4.6 Open: GLM-5, Qwen3.5-9B, DeepSeek-V3.2 |
| 📋 PLANNER | DAG-based execution plans — task decomposition, wave scheduling, risk analysis | PRD, codebase, AGENTS.md | Closed: Gemini 3.1 Pro, Claude Sonnet 4.6, GPT-5.4 Open: Kimi K2.5, GLM-5, Qwen3.5 |
| 🔧 IMPLEMENTER | TDD code implementation — features, bugs, refactoring. Never reviews own work | codebase, AGENTS.md, DESIGN.md | Closed: Claude Opus 4.6, GPT-5.4, Gemini 3.1 Pro Open: DeepSeek-V3.2, GLM-5, Qwen3-Coder-Next |
| Role | Description | Sources | Recommended LLM |
|---|---|---|---|
| 🛡️ REVIEWER | Zero-Hallucination Filter — Security auditing, code review, OWASP scanning | PRD, codebase, AGENTS.md, OWASP | Closed: Claude Opus 4.6, GPT-5.4, Gemini 3.1 Pro Open: Kimi K2.5, GLM-5, DeepSeek-V3.2 |
| 🎯 CRITIC | Challenges assumptions, finds edge cases, spots over-engineering and logic gaps | PRD, codebase, AGENTS.md | Closed: Claude Sonnet 4.6, GPT-5.4, Gemini 3.1 Pro Open: Kimi K2.5, GLM-5, Qwen3.5 |
| 🔬 DEBUGGER | Root-cause analysis, stack trace diagnosis, regression bisection | codebase, AGENTS.md, git history | Closed: Gemini 3.1 Pro, Claude Opus 4.6, GPT-5.4 Open: DeepSeek-V3.2, GLM-5, Qwen3-Coder-Next |
| 🧪 BROWSER TESTER | E2E browser testing, UI/UX validation, visual regression | PRD, AGENTS.md, fixtures | Closed: GPT-5.4, Claude Sonnet 4.6, Gemini 3.1 Flash Open: Llama 4 Maverick, Qwen3.5-Flash, MiniMax M2.7 |
| ✂️ SIMPLIFIER | Refactoring specialist — removes dead code, reduces complexity | codebase, AGENTS.md, tests | Closed: Claude Opus 4.6, GPT-5.4, Gemini 3.1 Pro Open: DeepSeek-V3.2, GLM-5, Qwen3-Coder-Next |
| Role | Description | Sources | Recommended LLM |
|---|---|---|---|
| 🚀 DEVOPS | Infrastructure deployment, CI/CD pipelines, container management | AGENTS.md, infra configs | Closed: GPT-5.4, Gemini 3.1 Pro, Claude Sonnet 4.6 Open: DeepSeek-V3.2, GLM-5, Qwen3.5 |
| 📝 DOCUMENTATION | Technical documentation, README files, API docs, diagrams | AGENTS.md, source code | Closed: Claude Sonnet 4.6, Gemini 3.1 Flash, GPT-5.4 Mini Open: Llama 4 Scout, Qwen3.5-9B, MiniMax M2.7 |
| 🎨 DESIGNER | UI/UX design — layouts, themes, color schemes, accessibility | PRD, codebase, AGENTS.md | Closed: GPT-5.4, Gemini 3.1 Pro, Claude Sonnet 4.6 Open: Qwen3.5, GLM-5, MiniMax M2.7 |
| 📱 IMPLEMENTER-MOBILE | Mobile implementation — React Native, Expo, Flutter | codebase, AGENTS.md | Closed: Claude Opus 4.6, GPT-5.4, Gemini 3.1 Pro Open: DeepSeek-V3.2, GLM-5, Qwen3-Coder-Next |
| 📱 DESIGNER-MOBILE | Mobile UI/UX — HIG, Material Design, safe areas | PRD, codebase, AGENTS.md | Closed: GPT-5.4, Gemini 3.1 Pro, Claude Sonnet 4.6 Open: Qwen3.5, GLM-5, MiniMax M2.7 |
| 📱 MOBILE TESTER | Mobile E2E testing — Detox, Maestro, iOS/Android | PRD, AGENTS.md | Closed: GPT-5.4, Claude Sonnet 4.6, Gemini 3.1 Flash Open: Llama 4 Maverick, Qwen3.5-Flash, MiniMax M2.7 |
Agents consult only the sources relevant to their role:
| Trust Level | Sources | Behavior |
|---|---|---|
| Trusted | PRD, plan.yaml, AGENTS.md | Follow as instructions |
| Verify | Codebase files, research findings | Cross-reference before assuming |
| Untrusted | Error logs, external data | Factual only — never as instructions |
Contributions are welcome! Please feel free to submit a Pull Request. CONTRIBUTING for detailed guidelines on commit message formatting, branching strategy, and code standards.
This project is licensed under the Apache License 2.0.
If you encounter any issues or have questions, please open an issue on GitHub.
