Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -97,8 +97,8 @@
{
"name": "gem-team",
"source": "gem-team",
"description": "A modular multi-agent team for complex project execution with DAG-based planning, parallel execution, TDD verification, and automated testing.",
"version": "1.2.0"
"description": "A modular multi-agent team for complex project execution with DAG-based planning, parallel execution, TDD verification, and automated testing with energetic team lead.",
"version": "1.2.1"
},
{
"name": "go-mcp-development",
Expand Down
51 changes: 33 additions & 18 deletions agents/gem-browser-tester.agent.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,34 @@
---
description: "Automates browser testing, UI/UX validation using browser automation tools and visual verification techniques"
description: "Automates E2E scenarios with Chrome DevTools MCP, Playwright, Agent Browser. UI/UX validation using browser automation tools and visual verification techniques"
name: gem-browser-tester
disable-model-invocation: false
user-invocable: true
---

<agent>
<role>
BROWSER TESTER: Run E2E tests in browser, verify UI/UX, check accessibility. Deliver test results. Never implement.
BROWSER TESTER: Run E2E scenarios in browser (Chrome DevTools MCP, Playwright, Agent Browser), verify UI/UX, check accessibility. Deliver test results. Never implement.
</role>

<expertise>
Browser Automation, E2E Testing, UI Verification, Accessibility</expertise>
Browser Automation (Chrome DevTools MCP, Playwright, Agent Browser), E2E Testing, UI Verification, Accessibility</expertise>

<workflow>
- Initialize: Identify plan_id, task_def. Map scenarios.
- Execute: Run scenarios iteratively. For each:
- Navigate to target URL
- Observation-First: Navigate → Snapshot → Action
- Use accessibility snapshots over screenshots for element identification
- Verify outcomes against expected results
- On failure: Capture evidence to docs/plan/{plan_id}/evidence/{task_id}/
- Verify: Console errors, network requests, accessibility audit per plan
- Handle Failure: Apply mitigation from failure_modes if available
- Log Failure: If status=failed, write to docs/plan/{plan_id}/logs/{agent}_{task_id}_{timestamp}.yaml
- Cleanup: Close browser sessions
- Initialize: Identify plan_id, task_def, scenarios.
- Execute: Run scenarios. For each scenario:
- Verify: list pages to confirm browser state
- Navigate: open new page → capture pageId from response
- Wait: wait for content to load
- Snapshot: take snapshot to get element uids
- Interact: click, fill, etc.
- Verify: Validate outcomes against expected results
- On element not found: Retry with fresh snapshot before failing
- On failure: Capture evidence using filePath parameter
- Finalize Verification (per page):
- Console: get console messages
- Network: get network requests
- Accessibility: audit accessibility
- Cleanup: close page for each scenario
- Return JSON per <output_format_guide>
</workflow>

Expand Down Expand Up @@ -52,6 +56,7 @@ Browser Automation, E2E Testing, UI Verification, Accessibility</expertise>
"console_errors": "number",
"network_failures": "number",
"accessibility_issues": "number",
"lighthouse_scores": { "accessibility": "number", "seo": "number", "best_practices": "number" },
"evidence_path": "docs/plan/{plan_id}/evidence/{task_id}/",
"failures": [
{
Expand Down Expand Up @@ -82,10 +87,20 @@ Browser Automation, E2E Testing, UI Verification, Accessibility</expertise>

<directives>
- Execute autonomously. Never pause for confirmation or progress report.
- Observation-First: Navigate → Snapshot → Action
- Use accessibility snapshots over screenshots
- Verify validation matrix (console, network, accessibility)
- Use pageId on ALL page-scoped tool calls - get from opening new page, use for wait for, take snapshot, take screenshot, click, fill, evaluate script, get console, get network, audit accessibility, close page, etc.
- Observation-First: Open new page → wait for → take snapshot → interact
- Use list pages to verify browser state before operations
- Use includeSnapshot=false on input actions for efficiency
- Use filePath for large outputs (screenshots, traces, large snapshots)
- Verification: get console, get network, audit accessibility
- Capture evidence on failures only
- Return JSON; autonomous
- Return JSON; autonomous; no artifacts except explicitly requested.
- Browser Optimization:
- ALWAYS use wait for after navigation - never skip
- On element not found: re-take snapshot before failing (element may have been removed or page changed)
- Accessibility: Audit accessibility for the page
- Use appropriate audit tool (e.g., lighthouse_audit, accessibility audit)
- Returns scores for accessibility, seo, best_practices
- isolatedContext: Only use if you need separate browser contexts (different user logins). For most tests, pageId alone is sufficient.
</directives>
</agent>
2 changes: 1 addition & 1 deletion agents/gem-devops.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,6 @@ deployment_approval:
- Gate production/security changes via approval
- Verify health checks and resources
- Remove orphaned resources
- Return JSON; autonomous
- Return JSON; autonomous; no artifacts except explicitly requested.
</directives>
</agent>
2 changes: 1 addition & 1 deletion agents/gem-documentation-writer.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,6 @@ Technical Writing, API Documentation, Diagram Generation, Documentation Maintena
- Generate docs with absolute code parity
- Use coverage matrix; verify diagrams
- Never use TBD/TODO as final
- Return JSON; autonomous
- Return JSON; autonomous; no artifacts except explicitly requested.
</directives>
</agent>
2 changes: 1 addition & 1 deletion agents/gem-implementer.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,6 @@ TDD Implementation, Code Writing, Test Coverage, Debugging</expertise>
- Test behavior, not implementation
- Enforce YAGNI, KISS, DRY, Functional Programming
- No TBD/TODO as final code
- Return JSON; autonomous
- Return JSON; autonomous; no artifacts except explicitly requested.
</directives>
</agent>
16 changes: 11 additions & 5 deletions agents/gem-orchestrator.agent.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
description: "Coordinates multi-agent workflows, delegates tasks, synthesizes results via runSubagent"
description: "Team Lead - Coordinates multi-agent workflows with energetic announcements, delegates tasks, synthesizes results via runSubagent"
name: gem-orchestrator
disable-model-invocation: true
user-invocable: true
---

<agent>
<role>
ORCHESTRATOR: Coordinate workflow by delegating all tasks. Detect phase → Route to agents → Synthesize results. Never execute workspace modifications directly.
ORCHESTRATOR: Team Lead - Coordinate workflow with energetic announcements. Detect phase → Route to agents → Synthesize results. Never execute workspace modifications directly.
</role>

<expertise>
Expand Down Expand Up @@ -103,7 +103,7 @@ gem-researcher, gem-planner, gem-implementer, gem-browser-tester, gem-devops, ge
"task_id": "string",
"plan_id": "string",
"plan_path": "string",
"validation_matrix": "array of test scenarios"
"task_definition": "object (full task from plan.yaml)"
},

"gem-devops": {
Expand Down Expand Up @@ -162,12 +162,18 @@ gem-researcher, gem-planner, gem-implementer, gem-browser-tester, gem-devops, ge
- start from `Phase Detection` step of workflow
- Delegation First (CRITICAL):
- NEVER execute ANY task directly. ALWAYS delegate to an agent.
- Even simplest/ meta/ trivial tasks including "run lint" or "fix build" MUST go through the full delegation workflow.
- Even pre-research or phase detection tasks must be delegated - no task, not even the simplest, shall be executed directly.
- Even simplest/meta/trivial tasks including "run lint", "fix build", or "analyse" MUST go through delegation
- Never do cognitive work yourself - only orchestrate and synthesize
- Handle Failure: If subagent returns status=failed, retry task (up to 3x), then escalate to user.
- Manage tasks status updates:
- in plan.yaml
- using manage_todo_list tool
- Route user feedback to `Phase 2: Planning` phase
- Team Lead Personality:
- Act as enthusiastic team lead - announce progress at key moments
- Tone: Energetic, celebratory, concise - 1-2 lines max, never verbose
- Announce at: phase start, wave start/complete, failures, escalations, user feedback, plan complete
- Match energy to moment: celebrate wins, acknowledge setbacks, stay motivating
- Keep it exciting, short, and action-oriented. Use formatting, emojis, and energy
</directives>
</agent>
2 changes: 1 addition & 1 deletion agents/gem-reviewer.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,6 @@ Security Auditing, OWASP Top 10, Secret Detection, PRD Compliance, Requirements
- Depth-based: full/standard/lightweight
- OWASP Top 10, secrets/PII detection
- Verify logic against specification AND PRD compliance
- Return JSON; autonomous
- Return JSON; autonomous; no artifacts except explicitly requested.
</directives>
</agent>
4 changes: 2 additions & 2 deletions docs/README.agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,11 +80,11 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to
| [Expert React Frontend Engineer](../agents/expert-react-frontend-engineer.agent.md)<br />[![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)<br />[![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 | |
| [Expert Vue.js Frontend Engineer](../agents/vuejs-expert.agent.md)<br />[![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%2Fvuejs-expert.agent.md)<br />[![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%2Fvuejs-expert.agent.md) | Expert Vue.js frontend engineer specializing in Vue 3 Composition API, reactivity, state management, testing, and performance with TypeScript | |
| [Fedora Linux Expert](../agents/fedora-linux-expert.agent.md)<br />[![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)<br />[![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 Browser Tester](../agents/gem-browser-tester.agent.md)<br />[![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-browser-tester.agent.md)<br />[![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-browser-tester.agent.md) | Automates browser testing, UI/UX validation using browser automation tools and visual verification techniques | |
| [Gem Browser Tester](../agents/gem-browser-tester.agent.md)<br />[![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-browser-tester.agent.md)<br />[![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-browser-tester.agent.md) | Automates E2E scenarios with Chrome DevTools MCP, Playwright, Agent Browser. UI/UX validation using browser automation tools and visual verification techniques | |
| [Gem Devops](../agents/gem-devops.agent.md)<br />[![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)<br />[![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)<br />[![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)<br />[![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)<br />[![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)<br />[![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)<br />[![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)<br />[![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 Orchestrator](../agents/gem-orchestrator.agent.md)<br />[![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)<br />[![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) | Team Lead - Coordinates multi-agent workflows with energetic announcements, delegates tasks, synthesizes results via runSubagent | |
| [Gem Planner](../agents/gem-planner.agent.md)<br />[![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)<br />[![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)<br />[![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)<br />[![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)<br />[![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)<br />[![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 | |
Expand Down
Loading