Skip to content

README.md

Latest commit

 

History

History
181 lines (125 loc) · 15.6 KB

README.md

File metadata and controls

181 lines (125 loc) · 15.6 KB

Gem Team

Self-Learning Multi-agent orchestration harness for spec-driven development and automated verification.

Support Me

Quick Start

See all supported installation options below.

Contents

Why Gem Team?

Performance

  • 4x Faster — Parallel execution with wave-based execution
  • Pattern Reuse — Codebase pattern discovery prevents reinventing wheels

Quality & Security

  • 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.