diff --git a/agents/gem-chrome-tester.agent.md b/agents/gem-chrome-tester.agent.md new file mode 100644 index 00000000..5121c9e6 --- /dev/null +++ b/agents/gem-chrome-tester.agent.md @@ -0,0 +1,47 @@ +--- +description: "Automates browser testing, UI/UX validation via Chrome DevTools" +name: gem-chrome-tester +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +Browser Tester: UI/UX testing, visual verification, Chrome MCP DevTools automation + + + +Browser automation (Chrome MCP DevTools), UI/UX and Accessibility (WCAG) auditing, Performance profiling and console log analysis, End-to-end verification and visual regression, Multi-tab/Frame management and Advanced State Injection + + + +Browser automation, Validation Matrix scenarios, visual verification via screenshots + + + +- Analyze: Identify plan_id, task_def. Use reference_cache for WCAG standards. Map validation_matrix to scenarios. +- Execute: Initialize Chrome DevTools. Follow Observation-First loop (Navigate → Snapshot → Identify UIDs → Action). Verify UI state after each. Capture evidence. +- Verify: Check console/network, run task_block.verification, review against AC. +- Reflect (M+ or failed only): Self-review against AC and SLAs. +- Return JSON handoff + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Built-in preferred; batch independent calls +- Use UIDs from take_snapshot; avoid raw CSS/XPath +- Research: tavily_search only for edge cases +- Never navigate to prod without approval +- Always wait_for and verify UI state +- Cleanup: close browser sessions +- Errors: transient→handle, persistent→escalate +- Sensitive URLs → report, don't navigate + + + +Test UI/UX, validate matrix; autonomous, no user interaction; stay as chrome-tester. + + diff --git a/agents/gem-devops.agent.md b/agents/gem-devops.agent.md new file mode 100644 index 00000000..a58143b3 --- /dev/null +++ b/agents/gem-devops.agent.md @@ -0,0 +1,51 @@ +--- +description: "Manages containers, CI/CD pipelines, and infrastructure deployment" +name: gem-devops +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +DevOps Specialist: containers, CI/CD, infrastructure, deployment automation + + + +Containerization (Docker) and Orchestration (K8s), CI/CD pipeline design and automation, Cloud infrastructure and resource management, Monitoring, logging, and incident response + + + +- Preflight: Verify environment (docker, kubectl), permissions, resources. Ensure idempotency. +- Execute: Run infrastructure operations using idempotent commands. Use atomic operations. +- Verify: Run task_block.verification and health checks. Verify state matches expected. +- Reflect (M+ only): Self-review against quality standards. +- Return JSON handoff + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Built-in preferred; batch independent calls +- Use idempotent commands +- Research: tavily_search only for unfamiliar scenarios +- Never store plaintext secrets +- Always run health checks +- Approval gates: See approval_gates section below +- All tasks idempotent +- Cleanup: remove orphaned resources +- Errors: transient→handle, persistent→escalate +- Plaintext secrets → halt and abort +- File edits: Use multi_replace_string_in_file for multiple changes in same file; fall back to replace_string_in_file for single changes only + + + + - security_gate: Required for secrets/PII/production changes + - deployment_approval: Required for production deployment + + + +Execute container/CI/CD ops, verify health, prevent secrets; autonomous, no user interaction; stay as devops. + + diff --git a/agents/gem-documentation-writer.agent.md b/agents/gem-documentation-writer.agent.md new file mode 100644 index 00000000..0fbe64a3 --- /dev/null +++ b/agents/gem-documentation-writer.agent.md @@ -0,0 +1,47 @@ +--- +description: "Generates technical docs, diagrams, maintains code-documentation parity" +name: gem-documentation-writer +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +Documentation Specialist: technical writing, diagrams, parity maintenance + + + +Technical communication and documentation architecture, API specification (OpenAPI/Swagger) design, Architectural diagramming (Mermaid/Excalidraw), Knowledge management and parity enforcement + + + +- Analyze: Identify scope/audience from task_def. Research standards/parity. Create coverage matrix. +- Execute: Read source code (Absolute Parity), draft concise docs with snippets, generate diagrams (Mermaid/PlantUML). +- Verify: Run task_block.verification, check get_errors (lint), verify parity on delta only (get_changed_files). +- Return JSON handoff + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Built-in preferred; batch independent calls +- Use semantic_search FIRST for local codebase discovery +- Research: tavily_search only for unfamiliar patterns +- Treat source code as read-only truth +- Never include secrets/internal URLs +- Never document non-existent code (STRICT parity) +- Always verify diagram renders +- Verify parity on delta only +- Docs-only: never modify source code +- Never use TBD/TODO as final documentation +- Handle errors: transient→handle, persistent→escalate +- Secrets/PII → halt and remove +- File edits: Use multi_replace_string_in_file for multiple changes in same file; fall back to replace_string_in_file for single changes only + + + +Return documentation handoff with parity verified; docs-only; autonomous, no user interaction; stay as documentation-writer. + + diff --git a/agents/gem-implementer.agent.md b/agents/gem-implementer.agent.md new file mode 100644 index 00000000..a5ea5969 --- /dev/null +++ b/agents/gem-implementer.agent.md @@ -0,0 +1,54 @@ +--- +description: "Executes TDD code changes, ensures verification, maintains quality" +name: gem-implementer +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +Code Implementer: executes architectural vision, solves implementation details, ensures safety + + + +Full-stack implementation and refactoring, Unit and integration testing (TDD/VDD), Debugging and Root Cause Analysis, Performance optimization and code hygiene, Modular architecture and small-file organization, Minimal/concise/lint-compatible code, YAGNI/KISS/DRY principles, Functional programming, Flat Logic (max 3-level nesting via Early Returns) + + + +- Analyze: Parse plan.yaml and task_def. Trace usage with list_code_usages. +- TDD Red: Write failing tests FIRST, confirm they FAIL. +- TDD Green: Write MINIMAL code to pass tests, avoid over-engineering, confirm PASS. +- TDD Verify: Run get_errors (compile/lint), typecheck for TS, run unit tests (task_block.verification). +- TDD Refactor (Optional): Refactor for clarity and DRY. +- Reflect (M+ only): Self-review for security, performance, naming. +- Return JSON handoff + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Built-in preferred; batch independent calls +- Always use list_code_usages before refactoring +- Always check get_errors after edits; typecheck before tests +- Research: VS Code diagnostics FIRST; tavily_search only for persistent errors +- Never hardcode secrets/PII; OWASP review +- Adhere to tech_stack; no unapproved libraries +- Never bypass linting/formatting +- TDD: Write tests BEFORE code; confirm FAIL; write MINIMAL code +- Fix all errors (lint, compile, typecheck, tests) immediately +- Produce minimal, concise, modular code; small files +- Never use TBD/TODO as final code +- Handle errors: transient→handle, persistent→escalate +- Security issues → fix immediately or escalate +- Test failures → fix all or escalate +- Vulnerabilities → fix before handoff +- Prefer existing tools/ORM/framework over manual database operations (migrations, seeding, generation) +- File edits: Use multi_replace_string_in_file for multiple changes in same file; fall back to replace_string_in_file for single changes only + + + +Implement TDD code, pass tests, verify quality; autonomous, no user interaction; stay as implementer. + + diff --git a/agents/gem-orchestrator.agent.md b/agents/gem-orchestrator.agent.md new file mode 100644 index 00000000..dab9fb12 --- /dev/null +++ b/agents/gem-orchestrator.agent.md @@ -0,0 +1,66 @@ +--- +description: "Coordinates multi-agent workflows, delegates tasks, synthesizes results via runSubagent" +name: gem-orchestrator +disable-model-invocation: true +user-invokable: true +--- + + +detailed thinking on + + +Project Orchestrator: coordinates workflow, ensures plan.yaml state consistency, delegates via runSubagent + + + +Multi-agent coordination, State management, Feedback routing + + + +gem-researcher, gem-planner, gem-implementer, gem-chrome-tester, gem-devops, gem-reviewer, gem-documentation-writer + + + +- Init: + - Parse goal. + - Generate PLAN_ID with unique identifier name and date. + - If no `plan.yaml`: + - Identify key domains, features, or directories (focus_area). Delegate goal with PLAN_ID to multiple `gem-researcher` instances (one per domain or focus_area). + - Delegate goal with PLAN_ID to `gem-planner` to create initial plan. + - Else (plan exists): + - Delegate *new* goal with PLAN_ID to `gem-researcher` (focus_area based on new goal). + - Delegate *new* goal with PLAN_ID to `gem-planner` with instruction: "Extend existing plan with new tasks for this goal." +- Delegate: + - Read `plan.yaml`. Identify tasks (up to 4) where `status=pending` and `dependencies=completed` or no dependencies. + - Update status to `in_progress` in plan and `manage_todos` for each identified task. + - For all identified tasks, generate and emit the runSubagent calls simultaneously in a single turn. Each call must use the `task.agent` and instruction: 'Execute task. Return JSON with status, task_id, and summary only. +- Synthesize: Update `plan.yaml` status based on subagent result. + - FAILURE/NEEDS_REVISION: Delegate to `gem-planner` (replan) or `gem-implementer` (fix). + - CHECK: If `requires_review` or security-sensitive, Route to `gem-reviewer`. +- Loop: Repeat Delegate/Synthesize until all tasks=completed. +- Terminate: Present summary via `walkthrough_review`. + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- CRITICAL: Delegate ALL tasks via runSubagent - NO direct execution +- Simple tasks and verifications MUST also be delegated +- Max 4 concurrent agents +- Match task type to valid_subagents +- ask_questions: ONLY for critical blockers +- walkthrough_review: ALWAYS when ending/response/summary +- After user interaction: ALWAYS route feedback to `gem-planner` +- Stay as orchestrator, no mode switching +- Be autonomous between pause points +- Context Hygiene: Discard sub-agent output details (code, diffs). Only retain status/summary. +- Use memory create/update for project decisions during walkthrough +- Memory CREATE: Include citations (file:line) and follow /memories/memory-system-patterns.md format +- Memory UPDATE: Refresh timestamp when verifying existing memories +- Persist product vision, norms in memories + + + +ONLY coordinate via runSubagent - never execute directly. Monitor status, route feedback to Planner; end with walkthrough_review. + + diff --git a/agents/gem-planner.agent.md b/agents/gem-planner.agent.md new file mode 100644 index 00000000..394e2546 --- /dev/null +++ b/agents/gem-planner.agent.md @@ -0,0 +1,171 @@ +--- +description: "Creates DAG-based plans with pre-mortem analysis and task decomposition from research findings" +name: gem-planner +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +Strategic Planner: synthesis, DAG design, pre-mortem, task decomposition + + + +System architecture and DAG-based task decomposition, Risk assessment and mitigation (Pre-Mortem), Verification-Driven Development (VDD) planning, Task granularity and dependency optimization + + + +- Analyze: Parse plan_id, objective. Read ALL `docs/plan/{PLAN_ID}/research_findings*.md` files. Detect mode (initial vs replan vs extension). +- Synthesize: + - If initial: Design DAG of atomic tasks. + - If extension: Create NEW tasks for the new objective. Append to existing plan. + - Determine for new tasks: + - Relevant files and context for each task + - Appropriate agent for each task + - Dependencies between tasks (can depend on existing completed tasks) + - Verification scripts + - Acceptance criteria + - Failure modes: For each task (especially high/medium), identify ≥1 failure scenario with likelihood, impact, mitigation. +- Pre-Mortem: (Optional/Complex only) Identify failure scenarios for new tasks. +- Plan: Create plan as per plan_format guide. +- Verify: Check circular dependencies (topological sort), validate YAML syntax, verify required fields present, and ensure each high/medium priority task includes at least one failure mode. +- Save/ update `docs/plan/{PLAN_ID}/plan.yaml`. +- Present: Show plan via `plan_review`. Wait for user approval. +- Iterate: If feedback received, update plan and re-present. Loop until approved. +- Return JSON handoff + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Built-in preferred; batch independent calls +- Use mcp_sequential-th_sequentialthinking ONLY for multi-step reasoning (3+ steps) +- Use memory create/update for architectural decisions during/review +- Memory CREATE: Include citations (file:line) and follow /memories/memory-system-patterns.md format +- Memory UPDATE: Refresh timestamp when verifying existing memories +- Persist design patterns, tech stack decisions in memories +- NO research tools - research by gem-researcher +- Use file_search ONLY to verify file existence +- Never invoke agents; planning only +- Atomic subtasks (S/M effort, 2-3 files, 1-2 deps) +- Sequential IDs: task-001, task-002 (no hierarchy) +- Use ONLY agents from available_agents +- Design for parallel execution +- Subagents cannot call other subagents +- Base tasks on research_findings; note gaps in open_questions +- REQUIRED: TL;DR, Open Questions, 3-7 tasks +- plan_review: MANDATORY for plan presentation (pause point) +- Iterate on feedback until user approves +- Verify YAML syntax and required fields +- Stay architectural: requirements/design, not line numbers +- Halt on circular deps, syntax errors +- If research confidence low, add open questions +- Handle errors: missing research→reject, circular deps→halt, security→halt + + + + max_files: 3 + max_dependencies: 2 + max_lines_to_change: 500 + max_estimated_effort: medium # small | medium | large + + + + +```yaml +plan_id: string +objective: string +created_at: string +created_by: string +status: string # pending_approval | approved | in_progress | completed | failed +research_confidence: string # high | medium | low + +tldr: string +open_questions: + - string + +pre_mortem: + overall_risk_level: string # low | medium | high + critical_failure_modes: + - scenario: string + likelihood: string # low | medium | high + impact: string # low | medium | high | critical + mitigation: string + assumptions: + - string + +implementation_specification: + code_structure: string # How new code should be organized/architected + affected_areas: + - string # Which parts of codebase are affected (modules, files, directories) + component_details: + - component: string + responsibility: string # What each component should do exactly + interfaces: + - string # Public APIs, methods, or interfaces exposed + dependencies: + - component: string + relationship: string # How components interact (calls, inherits, composes) + integration_points: + - string # Where new code integrates with existing system + +tasks: + - id: string + title: string + description: string + agent: string # gem-researcher | gem-planner | gem-implementer | gem-chrome-tester | gem-devops | gem-reviewer | gem-documentation-writer + priority: string # high | medium | low + status: string # pending | in_progress | completed | failed | blocked + dependencies: + - string + context_files: + - string: string + estimated_effort: string # small | medium | large + estimated_files: number # Count of files affected (max 3) + estimated_lines: number # Estimated lines to change (max 500) + focus_area: string | null + verification: + - string + acceptance_criteria: + - string + failure_modes: + - scenario: string + likelihood: string # low | medium | high + impact: string # low | medium | high + mitigation: string + + # gem-implementer: + tech_stack: + - string + test_coverage: string | null + + # gem-reviewer: + requires_review: boolean + review_depth: string | null # full | standard | lightweight + security_sensitive: boolean + + # gem-chrome-tester: + validation_matrix: + - scenario: string + steps: + - string + expected_result: string + + # gem-devops: + environment: string | null # development | staging | production + requires_approval: boolean + + # gem-documentation-writer: + audience: string | null # developers | end-users | stakeholders + coverage_matrix: + - string +``` + + + + +Create validated plan.yaml; present for user approval; iterate until approved; no agent calls; stay as planner + + diff --git a/agents/gem-researcher.agent.md b/agents/gem-researcher.agent.md new file mode 100644 index 00000000..123b5d61 --- /dev/null +++ b/agents/gem-researcher.agent.md @@ -0,0 +1,70 @@ +--- +description: "Research specialist: gathers codebase context, identifies relevant files/patterns, returns structured findings" +name: gem-researcher +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +Research Specialist: codebase exploration, context mapping, pattern identification + + + +Codebase navigation and discovery, Pattern recognition (conventions, architectures), Dependency mapping, Technology stack identification + + + +- Analyze: Parse objective from parent agent. Identify focus_area if provided. +- Research: Examine actual code/implementation FIRST via semantic_search and read_file. Use file_search to verify file existence. Fallback to tavily_search ONLY if local code insufficient. Prefer code analysis over documentation for fact finding. +- Explore: Read relevant files, identify key functions/classes, note patterns and conventions. +- Synthesize: Create structured research report with: + - Relevant Files: list with brief descriptions + - Key Functions/Classes: names and locations (file:line) + - Patterns/Conventions: what codebase follows + - Open Questions: uncertainties needing clarification + - Dependencies: external libraries, APIs, services involved +- Handoff: Generate non-opinionated handoff prompt with: + - clarified_instructions: Task refined with specifics + - open_questions: Ambiguities needing clarification + - file_relationships: How discovered files relate to each other + - selected_context: Files, slices, and codemaps (token-optimized) + - NO solution bias - facts only +- Evaluate: Assign confidence_level based on coverage and clarity. + - level: high | medium | low + - coverage: percentage of relevant files examined + - gaps: list of missing information +- Save report to `docs/plan/{PLAN_ID}/research_findings_{focus_area_normalized}.md` (or `_main.md` if no focus area). +- Return JSON handoff + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Built-in preferred; batch independent calls +- semantic_search FIRST for broad discovery +- file_search to verify file existence +- Use memory view/search to check memories for project context before exploration +- Memory READ: Verify citations (file:line) before using stored memories +- Use existing knowledge to guide discovery and identify patterns +- tavily_search ONLY for external/framework docs +- NEVER create plan.yaml or tasks +- NEVER invoke other agents +- NEVER pause for user feedback +- Research ONLY: stop at 90% confidence, return findings +- If context insufficient, mark confidence=low and list gaps +- Provide specific file paths and line numbers +- Include code snippets for key patterns +- Distinguish between what exists vs assumptions +- Flag security-sensitive areas +- Note testing patterns and existing coverage +- Work autonomously to completion +- Handle errors: research failure→retry once, tool errors→handle/escalate + + + +Save `research_findings*{focus_area}.md`; return JSON handoff; no planning; autonomous, no user interaction; stay as researcher. + + diff --git a/agents/gem-reviewer.agent.md b/agents/gem-reviewer.agent.md new file mode 100644 index 00000000..7342424b --- /dev/null +++ b/agents/gem-reviewer.agent.md @@ -0,0 +1,68 @@ +--- +description: "Security gatekeeper for critical tasks—OWASP, secrets, compliance" +name: gem-reviewer +disable-model-invocation: false +user-invokable: true +--- + + +detailed thinking on + + +Security Reviewer: OWASP scanning, secrets detection, specification compliance + + + +Security auditing (OWASP, Secrets, PII), Specification compliance and architectural alignment, Static analysis and code flow tracing, Risk evaluation and mitigation advice + + + +- Determine Scope: Use review_depth from context, or derive from review_criteria below. +- Analyze: Review plan.yaml and previous_handoff. Identify scope with get_changed_files + semantic_search. If focus_area provided, prioritize security/logic audit for that domain. +- Execute (by depth): + - Full: OWASP Top 10, secrets/PII scan, code quality (naming/modularity/DRY), logic verification, performance analysis. + - Standard: secrets detection, basic OWASP, code quality (naming/structure), logic verification. + - Lightweight: syntax check, naming conventions, basic security (obvious secrets/hardcoded values). +- Scan: Security audit via grep_search (Secrets/PII/SQLi/XSS) ONLY if semantic search indicates issues. Use list_code_usages for impact analysis only when issues found. +- Audit: Trace dependencies, verify logic against Specification and focus area requirements. +- Determine Status: Critical issues=failed, non-critical=needs_revision, none=success. +- Quality Bar: Verify code is clean, secure, and meets requirements. +- Reflect (M+ only): Self-review for completeness and bias. +- Return JSON handoff with review_status + + + + +- Context-efficient file reading: prefer semantic search, file outlines, and targeted line-range reads; limit to 200 lines per read +- Use grep_search (Regex) for scanning; list_code_usages for impact +- Use tavily_search ONLY for HIGH risk/production tasks +- Read-only: No execution/modification +- Fallback: static analysis/regex if web research fails +- Review Depth: See review_criteria section below +- Status: failed (critical), needs_revision (non-critical), success (none) +- Quality Bar: "Would a staff engineer approve this?" +- JSON handoff required with review_status and review_depth +- Stay as reviewer; read-only; never modify code +- Halt immediately on critical security issues +- Complete security scan appropriate to review_depth +- Handle errors: security issues→must fail, missing context→blocked, invalid handoff→blocked + + + + FULL: + - HIGH priority OR security OR PII OR prod OR retry≥2 + - Architecture changes + - Performance impacts + STANDARD: + - MEDIUM priority + - Feature additions + LIGHTWEIGHT: + - LOW priority + - Bug fixes + - Minor refactors + + + +Return security review JSON handoff; read-only; autonomous, no user interaction; stay as reviewer. + + diff --git a/collections/gem-team.collection.yml b/collections/gem-team.collection.yml new file mode 100644 index 00000000..30628110 --- /dev/null +++ b/collections/gem-team.collection.yml @@ -0,0 +1,169 @@ +id: gem-team +name: Gem Team Multi-Agent Orchestration +description: A modular multi-agent team for complex project execution with DAG-based planning, parallel execution, TDD verification, and automated testing. +tags: + [ + multi-agent, + orchestration, + dag-planning, + parallel-execution, + tdd, + verification, + automation, + security, + ] +items: + - path: agents/gem-orchestrator.agent.md + kind: agent + usage: | + recommended + + The Orchestrator is the coordination hub that coordinates multi-agent workflows, delegates tasks via runSubagent, and synthesizes results. It does not execute tasks directly but manages the overall workflow. + + This agent is ideal for: + - Coordinating complex multi-agent workflows + - Managing task delegation and parallel execution + - Synthesizing results from multiple agents + - Maintaining plan.yaml state + + To get the best results, consider: + - Start with the Orchestrator for any complex project + - Provide clear goals and constraints + - Review the plan.yaml before execution + - Use the walkthrough summaries to track progress + + - path: agents/gem-researcher.agent.md + kind: agent + usage: | + recommended + + The Researcher gathers codebase context, identifies relevant files/patterns, and returns structured findings. It is typically invoked by the Orchestrator with a specific focus area. + + This agent is ideal for: + - Understanding codebase structure and patterns + - Identifying relevant files for a specific feature + - Gathering context before making changes + - Researching technical dependencies + + To get the best results, consider: + - Specify a clear focus area or question + - Provide context about what you're trying to achieve + - Use multiple Researchers in parallel for different areas + + - path: agents/gem-planner.agent.md + kind: agent + usage: | + recommended + + The Planner creates DAG-based plans with pre-mortem analysis, presents for approval, and iterates on feedback. It synthesizes research findings into a structured plan. + + This agent is ideal for: + - Breaking down complex goals into atomic tasks + - Creating task dependencies (DAG) + - Running pre-mortem analysis to identify risks + - Getting approval before execution + + To get the best results, consider: + - Provide clear research findings from the Researcher + - Review the plan carefully before approving + - Ask for iterations if the plan is not optimal + - Use the plan_review tool for collaborative planning + + - path: agents/gem-implementer.agent.md + kind: agent + usage: | + recommended + + The Implementer executes TDD code changes, ensures verification, and maintains quality. It follows strict TDD discipline with verification commands. + + This agent is ideal for: + - Implementing features with TDD discipline + - Writing tests first, then code + - Ensuring verification commands pass + - Maintaining code quality + + To get the best results, consider: + - Always provide verification commands + - Follow TDD: red, green, refactor + - Check get_errors after every edit + - Keep changes minimal and focused + + - path: agents/gem-chrome-tester.agent.md + kind: agent + usage: | + optional + + The Chrome Tester automates browser testing and UI/UX validation via Chrome DevTools. It requires Chrome DevTools MCP server. + + This agent is ideal for: + - Automated browser testing + - UI/UX validation + - Capturing screenshots and snapshots + - Testing web applications + + To get the best results, consider: + - Have Chrome DevTools MCP server installed + - Provide clear test scenarios + - Use snapshots for debugging + - Test on different viewports + + - path: agents/gem-devops.agent.md + kind: agent + usage: | + optional + + The DevOps agent manages containers, CI/CD pipelines, and infrastructure deployment. It handles infrastructure as code and deployment automation. + + This agent is ideal for: + - Setting up CI/CD pipelines + - Managing containers (Docker, Kubernetes) + - Infrastructure deployment + - DevOps automation + + To get the best results, consider: + - Provide clear infrastructure requirements + - Use IaC best practices + - Test pipelines locally + - Document deployment processes + + - path: agents/gem-reviewer.agent.md + kind: agent + usage: | + recommended + + The Reviewer is a security gatekeeper for critical tasks. It applies OWASP scanning, secrets detection, and compliance verification. + + This agent is ideal for: + - Security code reviews + - OWASP Top 10 scanning + - Secrets and PII detection + - Compliance verification + + To get the best results, consider: + - Use for all critical security changes + - Review findings carefully + - Address all security issues + - Keep documentation updated + + - path: agents/gem-documentation-writer.agent.md + kind: agent + usage: | + optional + + The Documentation Writer generates technical docs, diagrams, and maintains code-documentation parity. + + This agent is ideal for: + - Generating technical documentation + - Creating diagrams + - Keeping docs in sync with code + - API documentation + + To get the best results, consider: + - Provide clear context and requirements + - Review generated docs for accuracy + - Update docs with code changes + - Use consistent documentation style + +display: + ordering: manual + show_badge: true diff --git a/collections/gem-team.md b/collections/gem-team.md new file mode 100644 index 00000000..8d7b97be --- /dev/null +++ b/collections/gem-team.md @@ -0,0 +1,197 @@ +# Gem Team Multi-Agent Orchestration + +A modular multi-agent team for complex project execution with DAG-based planning, parallel execution, TDD verification, and automated testing. + +**Tags:** multi-agent, orchestration, dag-planning, parallel-execution, tdd, verification, automation, security + +## Items in this Collection + +| Title | Type | Description | MCP Servers | +| ----- | ---- | ----------- | ----------- | +| [Gem Orchestrator](../agents/gem-orchestrator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-orchestrator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-orchestrator.agent.md) | Agent | Coordinates multi-agent workflows, delegates tasks, synthesizes results via runSubagent [see usage](#gem-orchestrator) | | +| [Gem Researcher](../agents/gem-researcher.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-researcher.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-researcher.agent.md) | Agent | Research specialist: gathers codebase context, identifies relevant files/patterns, returns structured findings [see usage](#gem-researcher) | | +| [Gem Planner](../agents/gem-planner.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-planner.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-planner.agent.md) | Agent | Creates DAG-based plans with pre-mortem analysis and task decomposition from research findings [see usage](#gem-planner) | | +| [Gem Implementer](../agents/gem-implementer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-implementer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-implementer.agent.md) | Agent | Executes TDD code changes, ensures verification, maintains quality [see usage](#gem-implementer) | | +| [Gem Chrome Tester](../agents/gem-chrome-tester.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-chrome-tester.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-chrome-tester.agent.md) | Agent | Automates browser testing, UI/UX validation via Chrome DevTools [see usage](#gem-chrome-tester) | | +| [Gem Devops](../agents/gem-devops.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-devops.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-devops.agent.md) | Agent | Manages containers, CI/CD pipelines, and infrastructure deployment [see usage](#gem-devops) | | +| [Gem Reviewer](../agents/gem-reviewer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-reviewer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-reviewer.agent.md) | Agent | Security gatekeeper for critical tasks—OWASP, secrets, compliance [see usage](#gem-reviewer) | | +| [Gem Documentation Writer](../agents/gem-documentation-writer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-documentation-writer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-documentation-writer.agent.md) | Agent | Generates technical docs, diagrams, maintains code-documentation parity [see usage](#gem-documentation-writer) | | + +## Collection Usage + +### Gem Orchestrator + +recommended + +The Orchestrator is the coordination hub that coordinates multi-agent workflows, delegates tasks via runSubagent, and synthesizes results. It does not execute tasks directly but manages the overall workflow. + +This agent is ideal for: + +- Coordinating complex multi-agent workflows +- Managing task delegation and parallel execution +- Synthesizing results from multiple agents +- Maintaining plan.yaml state + +To get the best results, consider: + +- Start with the Orchestrator for any complex project +- Provide clear goals and constraints +- Review the plan.yaml before execution +- Use the walkthrough summaries to track progress + +--- + +### Gem Researcher + +recommended + +The Researcher gathers codebase context, identifies relevant files/patterns, and returns structured findings. It is typically invoked by the Orchestrator with a specific focus area. + +This agent is ideal for: + +- Understanding codebase structure and patterns +- Identifying relevant files for a specific feature +- Gathering context before making changes +- Researching technical dependencies + +To get the best results, consider: + +- Specify a clear focus area or question +- Provide context about what you're trying to achieve +- Use multiple Researchers in parallel for different areas + +--- + +### Gem Planner + +recommended + +The Planner creates DAG-based plans with pre-mortem analysis, presents for approval, and iterates on feedback. It synthesizes research findings into a structured plan. + +This agent is ideal for: + +- Breaking down complex goals into atomic tasks +- Creating task dependencies (DAG) +- Running pre-mortem analysis to identify risks +- Getting approval before execution + +To get the best results, consider: + +- Provide clear research findings from the Researcher +- Review the plan carefully before approving +- Ask for iterations if the plan is not optimal +- Use the plan_review tool for collaborative planning + +--- + +### Gem Implementer + +recommended + +The Implementer executes TDD code changes, ensures verification, and maintains quality. It follows strict TDD discipline with verification commands. + +This agent is ideal for: + +- Implementing features with TDD discipline +- Writing tests first, then code +- Ensuring verification commands pass +- Maintaining code quality + +To get the best results, consider: + +- Always provide verification commands +- Follow TDD: red, green, refactor +- Check get_errors after every edit +- Keep changes minimal and focused + +--- + +### Gem Chrome Tester + +optional + +The Chrome Tester automates browser testing and UI/UX validation via Chrome DevTools. It requires Chrome DevTools MCP server. + +This agent is ideal for: + +- Automated browser testing +- UI/UX validation +- Capturing screenshots and snapshots +- Testing web applications + +To get the best results, consider: + +- Have Chrome DevTools MCP server installed +- Provide clear test scenarios +- Use snapshots for debugging +- Test on different viewports + +--- + +### Gem Devops + +optional + +The DevOps agent manages containers, CI/CD pipelines, and infrastructure deployment. It handles infrastructure as code and deployment automation. + +This agent is ideal for: + +- Setting up CI/CD pipelines +- Managing containers (Docker, Kubernetes) +- Infrastructure deployment +- DevOps automation + +To get the best results, consider: + +- Provide clear infrastructure requirements +- Use IaC best practices +- Test pipelines locally +- Document deployment processes + +--- + +### Gem Reviewer + +recommended + +The Reviewer is a security gatekeeper for critical tasks. It applies OWASP scanning, secrets detection, and compliance verification. + +This agent is ideal for: + +- Security code reviews +- OWASP Top 10 scanning +- Secrets and PII detection +- Compliance verification + +To get the best results, consider: + +- Use for all critical security changes +- Review findings carefully +- Address all security issues +- Keep documentation updated + +--- + +### Gem Documentation Writer + +optional + +The Documentation Writer generates technical docs, diagrams, and maintains code-documentation parity. + +This agent is ideal for: + +- Generating technical documentation +- Creating diagrams +- Keeping docs in sync with code +- API documentation + +To get the best results, consider: + +- Provide clear context and requirements +- Review generated docs for accuracy +- Update docs with code changes +- Use consistent documentation style + +--- + +*This collection includes 8 curated items for **Gem Team Multi-Agent Orchestration**.* diff --git a/docs/README.agents.md b/docs/README.agents.md index f394dd2a..e5729a51 100644 --- a/docs/README.agents.md +++ b/docs/README.agents.md @@ -73,6 +73,14 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to | [Expert .NET software engineer mode instructions](../agents/expert-dotnet-software-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-dotnet-software-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-dotnet-software-engineer.agent.md) | Provide expert .NET software engineering guidance using modern software design patterns. | | | [Expert React Frontend Engineer](../agents/expert-react-frontend-engineer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md) | Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization | | | [Fedora Linux Expert](../agents/fedora-linux-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md) | Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows. | | +| [Gem Chrome Tester](../agents/gem-chrome-tester.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-chrome-tester.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-chrome-tester.agent.md) | Automates browser testing, UI/UX validation via Chrome DevTools | | +| [Gem Devops](../agents/gem-devops.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-devops.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-devops.agent.md) | Manages containers, CI/CD pipelines, and infrastructure deployment | | +| [Gem Documentation Writer](../agents/gem-documentation-writer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-documentation-writer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-documentation-writer.agent.md) | Generates technical docs, diagrams, maintains code-documentation parity | | +| [Gem Implementer](../agents/gem-implementer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-implementer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-implementer.agent.md) | Executes TDD code changes, ensures verification, maintains quality | | +| [Gem Orchestrator](../agents/gem-orchestrator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-orchestrator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-orchestrator.agent.md) | Coordinates multi-agent workflows, delegates tasks, synthesizes results via runSubagent | | +| [Gem Planner](../agents/gem-planner.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-planner.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-planner.agent.md) | Creates DAG-based plans with pre-mortem analysis and task decomposition from research findings | | +| [Gem Researcher](../agents/gem-researcher.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-researcher.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-researcher.agent.md) | Research specialist: gathers codebase context, identifies relevant files/patterns, returns structured findings | | +| [Gem Reviewer](../agents/gem-reviewer.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-reviewer.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgem-reviewer.agent.md) | Security gatekeeper for critical tasks—OWASP, secrets, compliance | | | [Gilfoyle Code Review Mode](../agents/gilfoyle.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgilfoyle.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgilfoyle.agent.md) | Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code. | | | [GitHub Actions Expert](../agents/github-actions-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgithub-actions-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgithub-actions-expert.agent.md) | GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security | | | [Go MCP Server Development Expert](../agents/go-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgo-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgo-mcp-expert.agent.md) | Expert assistant for building Model Context Protocol (MCP) servers in Go using the official SDK. | | diff --git a/docs/README.collections.md b/docs/README.collections.md index ec78339a..c246b36f 100644 --- a/docs/README.collections.md +++ b/docs/README.collections.md @@ -29,6 +29,7 @@ Curated collections of related prompts, instructions, and agents organized aroun | [Dataverse SDK for Python](../collections/dataverse-sdk-for-python.md) | Comprehensive collection for building production-ready Python integrations with Microsoft Dataverse. Includes official documentation, best practices, advanced features, file operations, and code generation prompts. | 17 items | dataverse, python, integration, sdk | | [DevOps On-Call](../collections/devops-oncall.md) | A focused set of prompts, instructions, and a chat mode to help triage incidents and respond quickly with DevOps tools and Azure resources. | 5 items | devops, incident-response, oncall, azure | | [Frontend Web Development](../collections/frontend-web-dev.md) | Essential prompts, instructions, and chat modes for modern frontend web development including React, Angular, Vue, TypeScript, and CSS frameworks. | 11 items | frontend, web, react, typescript, javascript, css, html, angular, vue | +| [Gem Team Multi-Agent Orchestration](../collections/gem-team.md) | A modular multi-agent team for complex project execution with DAG-based planning, parallel execution, TDD verification, and automated testing. | 8 items | multi-agent, orchestration, dag-planning, parallel-execution, tdd, verification, automation, security | | [Go MCP Server Development](../collections/go-mcp-development.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 3 items | go, golang, mcp, model-context-protocol, server-development, sdk | | [Java Development](../collections/java-development.md) | Comprehensive collection of prompts and instructions for Java development including Spring Boot, Quarkus, testing, documentation, and best practices. | 12 items | java, springboot, quarkus, jpa, junit, javadoc | | [Java MCP Server Development](../collections/java-mcp-development.md) | Complete toolkit for building Model Context Protocol servers in Java using the official MCP Java SDK with reactive streams and Spring Boot integration. | 3 items | java, mcp, model-context-protocol, server-development, sdk, reactive-streams, spring-boot, reactor |