mirror of
https://github.com/github/awesome-copilot.git
synced 2026-05-27 17:11:44 +00:00
feat: [gem-team] Optimize memory management + Routing + concise agent definitions (#1782)
* chore: bump marketplace version to 1.33.0 Refactor the gem-browser-tester.agent.md file to provide a concise role description and streamline the listed knowledge sources. * docs(agents): Reinforces the coordinator’s responsibility to never skip phases. * Update gem‑orchestrator and gem‑researcher agent documentation - Clarify routing matrix: explicitly add bug_fix/debug handling in both routing and new_task phases. - Enhance researcher mode: use backticks on `research_yaml_paths` file paths and restructure the merge and envelope steps for clearer flow. * feat: Improve context handling and delegation in gem-orchestrator; enhance approval flow in gem-devops; update marketplace version - Updated .github/plugin/marketplace.json version to 1.34.0. * chore: update readme * fix: correct typo * chore: integrate research into planner, update workflows, and clarify context envelope usage * fix: phase references * chore: fix typo * chore(release): bump marketplace version to 1.38.0 - Updated .github/plugin/marketplace.json version field. - Refactored agents/gem-orchestrator.agent.md: renamed Phase 1 to Phase 0, added Intent Detection, Gray‑Areas Detection, and Complexity Assessment sections. - Revised workflow routing and plan validation logic, including detailed phase descriptions and crystal‑clear phase transition rules. * docs: restructure gem-orchestrator.agent.md phase descriptions (Intent Detection, Gray Areas, Complexity Assessment) and update wording; bump marketplace plugin version to 1.39.0 * chore: improve context cache * feat: Enrich agent learning documentation - Updated .github/plugin/marketplace.json version to 1.41.0. - Added facts, failure_modes, decisions, and conventions sections to the learnings object in all agent markdown files. * chore: imrpvoe context sharing * feat: improve context cache * fix: typo * chore: update readme * chore: cleanup * chore: improve agent selection logic --------- Co-authored-by: Aaron Powell <me@aaron-powell.com>
This commit is contained in:
Muhammad Ubaid Raza
committed by
GitHub
GitHub
parent
12666c97ee
commit
ee8d76cb9b
+2
-2
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "gem-team",
|
||||
"version": "1.24.0",
|
||||
"description": "Self-Learning Multi-agent orchestration harness for spec-driven development and automated verification.",
|
||||
"version": "1.42.0",
|
||||
"description": "Self-Learning Multi-agent orchestration framework for spec-driven development and automated verification.",
|
||||
"author": {
|
||||
"name": "mubaidr",
|
||||
"email": "mubaidr@gmail.com",
|
||||
|
||||
+217
-168
@@ -1,35 +1,58 @@
|
||||
<p align="center">
|
||||
<svg width="120" height="120" viewBox="0 0 36 36" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Gem Team Logo">
|
||||
<g fill="none" fill-rule="evenodd">
|
||||
<path fill="#BDDDF4" d="M13 3H7l-7 9h10z"/>
|
||||
<path fill="#5DADEC" d="M36 12l-7-9h-6l3 9z"/>
|
||||
<path fill="#4289C1" d="M26 12h10L18 33z"/>
|
||||
<path fill="#8CCAF7" d="M10 12H0l18 21zm3-9l-3 9h16l-3-9z"/>
|
||||
<path fill="#5DADEC" d="M18 33l-8-21h16z"/>
|
||||
</g>
|
||||
</svg>
|
||||
</p>
|
||||
|
||||
# Gem Team
|
||||
|
||||
Self-Learning Multi-agent orchestration harness for spec-driven development and automated verification.
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/badge/APM-mubaidr/gem--team-blue?style=flat-square" alt="APM">
|
||||
<img src="https://img.shields.io/github/v/release/mubaidr/gem-team?style=flat-square&color=important" alt="Version">
|
||||
<img src="https://img.shields.io/badge/License-Apache%202.0-green?style=flat-square" alt="License">
|
||||
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square" alt="PRs Welcome">
|
||||
<img src="https://img.shields.io/badge/Maintained%3F-yes-green?style=flat-square" alt="Maintained">
|
||||
</p>
|
||||
|
||||
## Quick Start
|
||||
Self-Learning Multi-agent orchestration framework for spec-driven development and automated verification.
|
||||
|
||||
> **TLDR:** Gem Team is a multi-agent framework that orchestrates LLM agents for software development tasks. It emphasizes spec-driven workflows with persistent learnings, built-in verification loops, knowledge-driven execution, and token efficiency.
|
||||
|
||||
> **Recommended Models:** Use a cost-efficient fast model as the default, and a stronger reasoning model for planner/debugger/critical review agents, e.g. `default=deepseek-v4-flash`, `planner,debugger,critic/reviewer=deepseek-v4-pro`. This gives you **80-90%** cost savings without sacrificing quality on complex tasks.
|
||||
|
||||
> **Crafted from years of personal experience** — This framework is shaped by real-world usage patterns, battle-tested and refined through countless hours of hands-on development workflows.
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
```bash
|
||||
# Install via APM (recommended)
|
||||
apm install mubaidr/gem-team
|
||||
|
||||
# Or register as a marketplace
|
||||
apm marketplace add mubaidr/gem-team
|
||||
apm install gem-team@gem-team
|
||||
apm install -g mubaidr/gem-team
|
||||
```
|
||||
|
||||
APM auto-detects your tools and deploys gem-team agents everywhere — VS Code, Claude Code, Cursor, OpenCode, Codex CLI, Gemini CLI, Windsurf, and GitHub Copilot CLI. See the [compatible tools table](#compatible-tools) for details.
|
||||
|
||||
See [all supported installation options](#installation) below.
|
||||
|
||||
---
|
||||
|
||||
## Contents
|
||||
## 📚 Contents
|
||||
|
||||
- [Quick Start](#quick-start)
|
||||
- [Why Gem Team?](#why-gem-team)
|
||||
- [Harness Architecture](#harness-architecture)
|
||||
- [Installation](#installation)
|
||||
- [The Agent Team](#the-agent-team)
|
||||
- [Knowledge Sources](#knowledge-sources)
|
||||
- [Contributing](#contributing)
|
||||
- [🚀 Quick Start](#quick-start)
|
||||
- [🎯 Why Gem Team?](#why-gem-team)
|
||||
- [🧠 Core Concepts](#core-concepts)
|
||||
- [🏗️ Architecture](#architecture)
|
||||
- [� The Agent Team](#the-agent-team)
|
||||
- [📦 Installation](#installation)
|
||||
- [🤝 Contributing](#contributing)
|
||||
|
||||
---
|
||||
|
||||
## Why Gem Team?
|
||||
## 🎯 Why Gem Team?
|
||||
|
||||
### Performance
|
||||
|
||||
@@ -38,43 +61,40 @@ See [all supported installation options](#installation) below.
|
||||
|
||||
### Quality & Security
|
||||
|
||||
- **Higher Quality** — Specialized harness agents + TDD + verification gates + contract-first
|
||||
- **Higher Quality** — Specialized framework 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
|
||||
- **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)
|
||||
- **Established Patterns** — Prefers established library/framework conventions over custom implementations
|
||||
- **Continuous Learning** — Memory tool persists patterns, gotchas, user preferences across sessions/ repo etc
|
||||
- **Skills & Guidelines** — Built-in special skill & guidelines (design-guidelines, debugger etc)
|
||||
- **Auto-Skills** — Agents extract reusable SKILL.md files from successful tasks
|
||||
|
||||
### Process
|
||||
|
||||
- **Spec-Driven** — Multi-step refinement defines "what" before "how"
|
||||
- **Plan-Driven** — Multi-step refinement defines "what" before "how"
|
||||
- **Contract-First** — Contract tests written before implementation
|
||||
- **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
|
||||
- **Resumable** — Execution can be paused and resumed without losing context
|
||||
- **Scriptable** — Use scripts for deterministic, repeatable, or bulk work (data processing, mechanical transforms, migrations/codemods, generated outputs, audits/reports, validation checks, reproduction helpers)
|
||||
|
||||
### 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.
|
||||
- **File-Based** — Researcher/Planner save to YAML files (for reusable context)
|
||||
- **Context Caching & Memory Management** — Self-validating cache prevents redundant work across sessions and agents
|
||||
|
||||
### Design
|
||||
|
||||
@@ -83,37 +103,120 @@ Optimized for reduced LLM token consumption without quality loss:
|
||||
|
||||
---
|
||||
|
||||
## Core Concepts
|
||||
## 🧠 Core Concepts
|
||||
|
||||
### The "System- IQ" Multiplier
|
||||
### 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.
|
||||
Raw reasoning isn't enough in single-pass chat. Gem-Team wraps your preferred LLM in a rigid framework with verification-first loops, fundamentally boosting its effective capability on SWE tasks.
|
||||
|
||||
### Design Support
|
||||
### Knowledge Layers
|
||||
|
||||
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) |
|
||||
| Type | Storage | 1-liner |
|
||||
| :--------------- | :---------------- | :------------------------------------------------------------------------------------------------------- |
|
||||
| **PRD** | `docs/PRD.yaml` | Product requirements spec — drives agent planning, implementation, and verification |
|
||||
| **AGENTS.md** | `AGENTS.md` | Static conventions, rules, and agent definitions (requires approval) |
|
||||
| **Memory** | memory tool | Facts, preferences, research, diagnoses, decisions, patterns — self-validated and reused across sessions |
|
||||
| **Skills** | `docs/skills/` | Reusable procedures with code examples, extracted from high-confidence patterns |
|
||||
| **Derived Docs** | `docs/knowledge/` | Online documentation, LLM-generated text, and reference materials |
|
||||
|
||||
---
|
||||
|
||||
## Harness Architecture
|
||||
Agents build these knowledge layers over time while working with you, capturing patterns, decisions, and learnings that improve future execution.
|
||||
|
||||
## 🏗️ Architecture
|
||||
|
||||
```text
|
||||
User Goal → Orchestrator → [Simple: Research/Plan] or [Complex: Discuss → PRD → Research → Plan → Approve] → Execute (waves) → Summary → Final Review
|
||||
↓
|
||||
Diagnose → Fix → Re- verify
|
||||
User Goal
|
||||
↓
|
||||
Orchestrator
|
||||
↓
|
||||
Phase 0: Init & Clarify
|
||||
• Generate/load plan_id
|
||||
• Read memory, detect effort (LOW/MEDIUM/HIGH)
|
||||
• Route to appropriate path
|
||||
↓
|
||||
Phase 1: Route
|
||||
• Routing matrix based on effort, task type, and context
|
||||
↓
|
||||
Phase 2: Planning
|
||||
• Delegate to planner
|
||||
• Validation: MEDIUM (reviewer) / HIGH (reviewer+critic)
|
||||
• Loop on failure (max 3x)
|
||||
• Present for approval if HIGH
|
||||
↓
|
||||
Phase 3: Execution Loop
|
||||
Pre-Wave: Check memory for failure_modes/gotchas → add guards
|
||||
↓
|
||||
┌─ Wave Execution ──────────────┐
|
||||
│ • Delegate tasks (≤4 concurrent)│
|
||||
└─────────────┬─────────────────┘
|
||||
↓
|
||||
┌─ Integration Check ──────────┐
|
||||
│ • Reviewer(wave) │
|
||||
│ • UI: Designer(validate) │
|
||||
│ • If fail: Debugger → retry │
|
||||
└─────────────┬─────────────────┘
|
||||
↓
|
||||
┌─ Phase 4: Persist Learnings ─┐
|
||||
│ • Collect & merge learnings │
|
||||
│ • Memory (deduped) │
|
||||
│ • Context Envelope update │
|
||||
│ • Conventions → AGENTS.md │
|
||||
│ • Decisions → PRD │
|
||||
│ • Skills extraction │
|
||||
└─────────────┬─────────────────┘
|
||||
↓
|
||||
Next wave? → No → Phase 5
|
||||
│Yes
|
||||
└─────────────────┘
|
||||
↓
|
||||
Phase 5: Output
|
||||
• Present final status
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
## 👥 The Agent Team
|
||||
|
||||
### Core Agents
|
||||
|
||||
| Agent | Description | Sources |
|
||||
| :--------------- | :------------------------------------------------------------------------------- | :----------------------------- |
|
||||
| **ORCHESTRATOR** | The team lead: Orchestrates research, planning, implementation, and verification | PRD, AGENTS.md |
|
||||
| **RESEARCHER** | Codebase exploration — patterns, dependencies, architecture discovery | PRD, codebase, AGENTS.md, docs |
|
||||
| **PLANNER** | DAG-based execution plans — task decomposition, wave scheduling, risk analysis | PRD, codebase, AGENTS.md |
|
||||
| **IMPLEMENTER** | TDD code implementation — features, bugs, refactoring. Never reviews own work | codebase, AGENTS.md, DESIGN.md |
|
||||
|
||||
### Quality & Review
|
||||
|
||||
| Role | Description | Sources |
|
||||
| :----------------- | :------------------------------------------------------------------------------- | :------------------------------- |
|
||||
| **REVIEWER** | **Zero- Hallucination Filter** — Security auditing, code review, OWASP scanning | PRD, codebase, AGENTS.md, OWASP |
|
||||
| **CRITIC** | Challenges assumptions, finds edge cases, spots over- engineering and logic gaps | PRD, codebase, AGENTS.md |
|
||||
| **DEBUGGER** | Root-cause analysis, stack trace diagnosis, regression bisection | codebase, AGENTS.md, git history |
|
||||
| **BROWSER TESTER** | E2E browser testing, UI/UX validation, visual regression | PRD, AGENTS.md, fixtures |
|
||||
| **SIMPLIFIER** | Refactoring specialist — removes dead code, reduces complexity | codebase, AGENTS.md, tests |
|
||||
|
||||
### Skill Management
|
||||
|
||||
| Role | Description | Sources |
|
||||
| :---------------- | :---------------------------------------------------------------------------------- | :----------------------------------- |
|
||||
| **SKILL CREATOR** | Pattern-to-skill extraction — creates SKILL.md files from high-confidence learnings | AGENTS.md, Memory patterns, SKILL.md |
|
||||
|
||||
### Specialized
|
||||
|
||||
| Role | Description | Sources |
|
||||
| :--------------------- | :--------------------------------------------------------------- | :----------------------- |
|
||||
| **DEVOPS** | Infrastructure deployment, CI/CD pipelines, container management | AGENTS.md, infra configs |
|
||||
| **DOCUMENTATION** | Technical documentation, README files, API docs, diagrams | AGENTS.md, source code |
|
||||
| **DESIGNER** | UI/UX design — layouts, themes, color schemes, accessibility | PRD, codebase, AGENTS.md |
|
||||
| **IMPLEMENTER-MOBILE** | Mobile implementation — React Native, Expo, Flutter | codebase, AGENTS.md |
|
||||
| **DESIGNER-MOBILE** | Mobile UI/UX — HIG, Material Design, safe areas | PRD, codebase, AGENTS.md |
|
||||
| **MOBILE TESTER** | Mobile E2E testing — Detox, Maestro, iOS/Android | PRD, AGENTS.md |
|
||||
|
||||
---
|
||||
|
||||
## 📦 Installation
|
||||
|
||||
### Install APM First
|
||||
|
||||
@@ -130,31 +233,56 @@ irm https://microsoft.github.io/apm/install.ps1 | iex
|
||||
npm install -g @microsoft/apm
|
||||
```
|
||||
|
||||
**Why APM?** Universal package manager for AI coding tools. One command installs to all your tools (Copilot CLI, Claude Code, Cursor, OpenCode). Handles version locking, updates, and dependencies automatically.
|
||||
**Why APM?** Universal package manager for AI coding tools. One command installs to all your tools (VS Code Copilot, GitHub Copilot CLI, Claude Code, Cursor, OpenCode, Codex CLI, Gemini CLI, Windsurf). Handles version locking, updates, and dependencies automatically.
|
||||
|
||||
[APM Documentation](https://microsoft.github.io/apm/) | [GitHub](https://github.com/microsoft/apm)
|
||||
|
||||
---
|
||||
|
||||
Choose the method that works best for your workflow:
|
||||
### Quick Install via APM
|
||||
|
||||
### Method 1: Direct Install via APM (Recommended)
|
||||
|
||||
Fastest way to get started. APM automatically detects your tool and installs to the correct location.
|
||||
Single command — APM auto-detects your tools and deploys to all of them:
|
||||
|
||||
```bash
|
||||
apm install mubaidr/gem-team
|
||||
```
|
||||
|
||||
**Works with:** GitHub Copilot CLI, Claude Code, Cursor, OpenCode
|
||||
#### Useful Flags
|
||||
|
||||
[APM Documentation](https://microsoft.github.io/apm/getting-started/quick-start/)
|
||||
```bash
|
||||
# Preview what would install (no writes)
|
||||
apm install --dry-run mubaidr/gem-team
|
||||
|
||||
# Install only for specific tools
|
||||
apm install --target claude,cursor mubaidr/gem-team
|
||||
|
||||
# Exclude a tool
|
||||
apm install --exclude codex mubaidr/gem-team
|
||||
|
||||
# Install globally (user scope)
|
||||
apm install -g mubaidr/gem-team
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Method 2: Via Marketplace
|
||||
### Compatible Tools
|
||||
|
||||
Add gem-team as a marketplace, then install from it. Useful for browsing available agents and managing updates.
|
||||
APM deploys agents to every harness it detects. Below is what lands where:
|
||||
|
||||
| Tool | Auto-detection signal | Where agents land | Primitives supported |
|
||||
| ------------------------- | ---------------------------- | ------------------- | -------------------------------------------------- |
|
||||
| **VS Code** (Copilot IDE) | `.github/` | `.github/agents/` | instructions, prompts, agents, skills, hooks, mcp |
|
||||
| **GitHub Copilot CLI** | `.github/` | `.github/agents/` | instructions, prompts, agents, skills, hooks, mcp |
|
||||
| **Cursor** | `.cursor/` or `.cursorrules` | `.cursor/agents/` | instructions, agents, skills, commands, hooks, mcp |
|
||||
| **OpenCode** | `.opencode/` | `.opencode/agents/` | agents, commands, skills, mcp |
|
||||
| **Codex CLI** | `.codex/` | `.codex/agents/` | agents, skills, hooks, mcp |
|
||||
| **Windsurf** | `.windsurf/` | `.windsurf/skills/` | instructions, agents, skills, commands, hooks, mcp |
|
||||
|
||||
---
|
||||
|
||||
### Via Marketplace
|
||||
|
||||
Add gem-team as a marketplace, then install. Useful for browsing available agents and managing updates.
|
||||
|
||||
#### GitHub Copilot CLI
|
||||
|
||||
@@ -162,11 +290,14 @@ Add gem-team as a marketplace, then install from it. Useful for browsing availab
|
||||
# Add marketplace
|
||||
copilot plugin marketplace add mubaidr/gem-team
|
||||
|
||||
# Browse available plugins
|
||||
# Browse
|
||||
copilot plugin marketplace browse gem-team
|
||||
|
||||
# Install
|
||||
copilot plugin install gem-team@gem-team
|
||||
|
||||
# Or from awesome-copilot (pre-registered by default)
|
||||
copilot plugin install gem-team@awesome-copilot
|
||||
```
|
||||
|
||||
#### Claude Code
|
||||
@@ -175,7 +306,7 @@ copilot plugin install gem-team@gem-team
|
||||
# Add marketplace
|
||||
/plugin marketplace add mubaidr/gem-team
|
||||
|
||||
# Browse in UI
|
||||
# Browse
|
||||
/plugin
|
||||
|
||||
# Install
|
||||
@@ -185,34 +316,16 @@ copilot plugin install gem-team@gem-team
|
||||
#### Cursor IDE
|
||||
|
||||
```bash
|
||||
# Add marketplace via APM
|
||||
apm marketplace add mubaidr/gem-team
|
||||
|
||||
# Install
|
||||
apm install gem-team@gem-team
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Method 3: From awesome-copilot Marketplace
|
||||
|
||||
Install from the official awesome-copilot marketplace (GitHub Copilot CLI only).
|
||||
|
||||
```bash
|
||||
# awesome-copilot is pre-registered by default
|
||||
copilot plugin install gem-team@awesome-copilot
|
||||
```
|
||||
|
||||
**Note:** This method is only available if gem-team is listed in the awesome-copilot marketplace.
|
||||
|
||||
---
|
||||
|
||||
### Method 4: Local/Manual Installation
|
||||
### Local / Manual Installation
|
||||
|
||||
For development, testing, or offline use.
|
||||
|
||||
#### Clone Repository
|
||||
|
||||
```bash
|
||||
git clone https://github.com/mubaidr/gem-team.git
|
||||
cd gem-team
|
||||
@@ -221,131 +334,67 @@ cd gem-team
|
||||
#### Claude Code
|
||||
|
||||
```bash
|
||||
# Load as local plugin
|
||||
claude --plugin-dir .
|
||||
|
||||
# Or add as local marketplace
|
||||
/plugin marketplace add ./
|
||||
|
||||
# Reload after changes
|
||||
/reload-plugins
|
||||
# Or: /plugin marketplace add ./
|
||||
```
|
||||
|
||||
#### Cursor IDE
|
||||
|
||||
```bash
|
||||
# Option 1: Via chat command
|
||||
# In Cursor: /add-plugin /absolute/path/to/gem-team
|
||||
# Via chat command
|
||||
/add-plugin /absolute/path/to/gem-team
|
||||
|
||||
# Option 2: Copy agents to project
|
||||
# One-line install: Copy agents and rename to .mdc
|
||||
# Or one-line copy to .cursor/rules/
|
||||
mkdir -p .cursor/rules && cp .apm/agents/*.agent.md .cursor/rules/ && cd .cursor/rules && for f in *.agent.md; do mv "$f" "${f%.agent.md}.mdc"; done && cd ../..
|
||||
```
|
||||
|
||||
#### GitHub Copilot CLI
|
||||
|
||||
```bash
|
||||
# Add as local marketplace
|
||||
copilot plugin marketplace add /absolute/path/to/gem-team
|
||||
|
||||
# Install
|
||||
copilot plugin install gem-team@gem-team
|
||||
```
|
||||
|
||||
#### Manual Copy (Any Tool)
|
||||
#### Any Tool (Manual Copy)
|
||||
|
||||
```bash
|
||||
# Copy agents to your tool's directory
|
||||
# GitHub Copilot: ~/.copilot/
|
||||
# Claude Code: ~/.claude/plugins/
|
||||
# Cursor: .cursor/rules/
|
||||
# OpenCode: .opencode/plugins/
|
||||
|
||||
cp -r .apm/agents <destination>
|
||||
# Destinations:
|
||||
# VS Code / Copilot CLI → ~/.copilot/
|
||||
# Claude Code → ~/.claude/plugins/
|
||||
# Cursor → .cursor/rules/
|
||||
# OpenCode → .opencode/plugins/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### VS Code (GitHub Copilot)
|
||||
|
||||
Search for "gem-team" in the VS Code Chat marketplace.
|
||||
|
||||
1. Open VS Code
|
||||
2. Go to Chat Settings
|
||||
3. Search "gem-team" in agents or plugins marketplace
|
||||
4. Click Install
|
||||
|
||||
---
|
||||
|
||||
### Verification
|
||||
|
||||
After installation, verify agents are available:
|
||||
After installation, confirm your setup:
|
||||
|
||||
```bash
|
||||
# GitHub Copilot CLI
|
||||
copilot plugin list
|
||||
# Preview which tools APM detects
|
||||
apm targets
|
||||
|
||||
# Claude Code
|
||||
/plugin list
|
||||
|
||||
# APM (any tool)
|
||||
# List installed packages
|
||||
apm list
|
||||
|
||||
# View package details
|
||||
apm view gem-team
|
||||
|
||||
# Tool-specific checks
|
||||
copilot plugin list # GitHub Copilot CLI
|
||||
/plugin list # Claude Code
|
||||
```
|
||||
|
||||
## 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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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<br>**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
|
||||
## 🤝 Contributing
|
||||
|
||||
Contributions are welcome! Please feel free to submit a Pull Request. [CONTRIBUTING](./CONTRIBUTING.md) for detailed guidelines on commit message formatting, branching strategy, and code standards.
|
||||
|
||||
## License
|
||||
## 📄 License
|
||||
|
||||
This project is licensed under the Apache License 2.0.
|
||||
|
||||
## Support
|
||||
## 💬 Support
|
||||
|
||||
If you encounter any issues or have questions, please [open an issue](https://github.com/mubaidr/gem-team/issues) on GitHub.
|
||||
|
||||
Reference in New Issue
Block a user