Higher Quality — Specialized harness agents + TDD + verification gates + contract-first
Built-in Security — OWASP scanning, secrets/PII detection on critical tasks
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
Constructive Critique — gem- critic challenges assumptions, finds edge cases

Intelligence

Established Patterns — Uses library/harness conventions over custom implementations
Source Verified — Every factual claim cites its source; no guesswork
Knowledge-Driven — Prioritized sources (PRD → codebase → AGENTS.md → Context7 → docs)
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)
Skills & Guidelines — Built-in skill & guidelines (web-design-guidelines)

Process

Spec-Driven — Multi-step refinement defines "what" before "how"
Verified-Plan — Complex tasks: Plan → Verification → Critic
Traceable — Self-documenting IDs link requirements → tasks → tests → evidence
Intent vs. Compliance — Shifts the burden from writing "perfect prompts" to enforcing strict, YAML-based approval gates
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

Token Efficiency

Optimized for reduced LLM token consumption without quality loss:

Concise Output — No preamble, no meta commentary, no verbose explanations
Strict Formats — JSON/YAML exactly matching schemas — eliminates parse errors and retries
Empty is OK — Skip empty arrays, nulls, verbose fields where not needed
File-Based — Researcher/Planner save to YAML files (not all in JSON output)
Learnings — Empty patterns/conventions unless critical

Result: ~40-60% reduction on output tokens while maintaining quality.

Design

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

Core Concepts

The "System- IQ" Multiplier

Raw reasoning isn't enough in single-pass chat. Gem-Team wraps your preferred LLM in a rigid harness with verification-first loops, fundamentally boosting its effective capability on SWE tasks.

Design Support

Gem Team includes specialized design agents with anti-"AI slop" guidelines for distinctive, modern and unique aesthetics with accessibility compliance.

Triple Learning System

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)

Harness Architecture

User Goal → Orchestrator → [Simple: Research/Plan] or [Complex: Discuss → PRD → Research → Plan → Approve] → Execute (waves) → Summary → Final Review
                ↓
            Diagnose → Fix → Re- verify

Installation

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/`	—

The Agent Team

Core Workflow

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

Quality & Review

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

Specialized

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

Knowledge Sources

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. CONTRIBUTING for detailed guidelines on commit message formatting, branching strategy, and code standards.

License

This project is licensed under the Apache License 2.0.

Support

If you encounter any issues or have questions, please open an issue on GitHub.

README.md

Gem Team

Quick Start

Contents

Why Gem Team?

Performance

Quality & Security