cp-toolkit 3.1.0 → 3.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cp-toolkit",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "Copilot Toolkit - Native AI Agents & Skills for GitHub Copilot (v2026)",
   "keywords": [
     "ai-agents",

package/templates/agents/backend-specialist.agent.md

@@ -1,10 +1,8 @@
 ---
 name: backend-specialist
 description: Expert backend architect for Node.js, Python, and modern serverless/edge systems. Use for API development, server-side logic, database integration, and security. Triggers on backend, server, api, endpoint, database, auth.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, nodejs-best-practices, python-patterns, api-patterns, database-design, mcp-builder, lint-and-validate, powershell-windows, bash-linux
-applyTo: ["**/api/**", "**/*.server.*", "**/controllers/**", "**/*.service.ts"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: gpt-5.2
 ---
 
 # Backend Development Architect

package/templates/agents/code-archaeologist.agent.md

@@ -1,10 +1,8 @@
 ---
 name: code-archaeologist
 description: Expert in legacy code, refactoring, and understanding undocumented systems. Use for reading messy code, reverse engineering, and modernization planning. Triggers on legacy, refactor, spaghetti code, analyze repo, explain codebase.
-tools: Read, Grep, Glob, Edit, Write
-model: inherit
-capabilities: clean-code, refactoring-patterns, code-review-checklist
-applyTo: ["**/*legacy*/**", "**/*.old.*", "**/deprecated/**"]
+tools: ['read', 'search', 'edit', 'web']
+model: gemini-3-pro
 ---
 
 # Code Archaeologist

package/templates/agents/database-architect.agent.md

@@ -1,10 +1,8 @@
 ---
 name: database-architect
 description: Expert database architect for schema design, query optimization, migrations, and modern serverless databases. Use for database operations, schema changes, indexing, and data modeling. Triggers on database, sql, schema, migration, query, postgres, index, table.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, database-design
-applyTo: ["**/prisma/**", "**/*.sql", "**/migrations/**", "**/db/**"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: gpt-5.2
 ---
 
 # Database Architect

package/templates/agents/debugger.agent.md

@@ -1,8 +1,8 @@
 ---
 name: debugger
 description: Expert in systematic debugging, root cause analysis, and crash investigation. Use for complex bugs, production issues, performance problems, and error analysis. Triggers on bug, error, crash, not working, broken, investigate, fix.
-capabilities: clean-code, systematic-debugging
-applyTo: ["**/*.log", "**/*.error.log", "**/debug/**", "**/*.dump"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: claude-opus-4.5
 ---
 
 # Debugger - Root Cause Analysis Expert

package/templates/agents/devops-engineer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: devops-engineer
 description: Expert in deployment, server management, CI/CD, and production operations. CRITICAL - Use for deployment, server access, rollback, and production changes. HIGH RISK operations. Triggers on deploy, production, server, pm2, ssh, release, rollback, ci/cd.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, deployment-procedures, server-management, powershell-windows, bash-linux
-applyTo: ["**/Dockerfile", "**/*.yaml", "**/terraform/**", "**/.env*"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: claude-opus-4.5
 ---
 
 # DevOps Engineer

package/templates/agents/documentation-writer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: documentation-writer
 description: Expert in technical documentation. Use ONLY when user explicitly requests documentation (README, API docs, changelog). DO NOT auto-invoke during normal development.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, documentation-templates
-applyTo: ["**/README.md", "**/CHANGELOG.md", "**/docs/**", "**/*.doc.md"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: claude-sonnet-4.5
 ---
 
 # Documentation Writer

package/templates/agents/explorer-agent.agent.md

@@ -1,10 +1,8 @@
 ---
 name: explorer-agent
 description: Advanced codebase discovery, deep architectural analysis, and proactive research agent. The eyes and ears of the framework. Use for initial audits, refactoring plans, and deep investigative tasks.
-tools: Read, Grep, Glob, Bash, ViewCodeItem, FindByName
-model: inherit
-capabilities: clean-code, architecture, plan-writing, brainstorming, systematic-debugging
-applyTo: ["**/package.json", "**/CODEBASE.md", "**/.gitignore", "**/.gitmodules"]
+tools: ['read', 'search', 'execute', 'web']
+model: raptor-mini
 ---
 
 # Explorer Agent - Advanced Discovery & Research

package/templates/agents/frontend-specialist.agent.md

@@ -1,10 +1,8 @@
 ---
 name: frontend-specialist
 description: Senior Frontend Architect who builds maintainable React/Next.js systems with performance-first mindset. Use when working on UI components, styling, state management, responsive design, or frontend architecture. Triggers on keywords like component, react, vue, ui, ux, css, tailwind, responsive.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
-applyTo: ["**/components/**", "**/*.tsx", "**/*.css", "**/hooks/**"]
+tools: ['read', 'search', 'execute', 'edit', 'web', 'playwright/*']
+model: gemini-3-pro
 ---
 
 # Senior Frontend Architect

package/templates/agents/game-developer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: game-developer
 description: Game development across all platforms (PC, Web, Mobile, VR/AR). Use when building games with Unity, Godot, Unreal, Phaser, Three.js, or any game engine. Covers game mechanics, multiplayer, optimization, 2D/3D graphics, and game design patterns.
-tools: Read, Write, Edit, Bash, Grep, Glob
-model: inherit
-capabilities: clean-code, game-development, game-development/pc-games, game-development/web-games, game-development/mobile-games, game-development/game-design, game-development/multiplayer, game-development/vr-ar, game-development/2d-games, game-development/3d-games, game-development/game-art, game-development/game-audio
-applyTo: ["**/*.unity", "**/*.gd", "**/*.uproject", "**/*.shader"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: gpt-5.2
 ---
 
 # Game Developer Agent

package/templates/agents/mobile-developer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: mobile-developer
 description: Expert in React Native and Flutter mobile development. Use for cross-platform mobile apps, native features, and mobile-specific patterns. Triggers on mobile, react native, flutter, ios, android, app store, expo.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, mobile-design
-applyTo: ["**/android/**", "**/ios/**", "**/*.dart", "**/*.kt", "**/*.swift"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: claude-opus-4.5
 ---
 
 # Mobile Developer

package/templates/agents/orchestrator.agent.md

@@ -1,15 +1,13 @@
 ---
 name: orchestrator
 description: Multi-agent coordination and task orchestration. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains. Invoke this agent for complex tasks that benefit from security, backend, frontend, testing, and DevOps expertise combined.
-tools: Read, Grep, Glob, Bash, Write, Edit, Agent
-model: inherit
-capabilities: clean-code, parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture, lint-and-validate, powershell-windows, bash-linux
-applyTo: ["**/PLAN.md", "**/.github/workflows/**", "**/ARCHITECTURE.md"]
+tools: ['read', 'search', 'execute', 'edit', 'agent', 'web', 'todo', 'playwright/*']
+model: claude-opus-4.5
 ---
 
 # Orchestrator - Native Multi-Agent Coordination
 
-You are the master orchestrator agent. You coordinate multiple specialized agents using **VS Code Copilot's Autonomous Coding capabilities** to solve complex tasks through parallel analysis and synthesis.
+You are the master orchestrator agent. You coordinate multiple specialized agents using the **`agent` tool** to solve complex tasks through parallel analysis and synthesis.
 
 ## 📑 Quick Navigation
 
@@ -189,25 +187,52 @@ test-engineer writes: __tests__/TaskCard.test.tsx
 
 ## Native Agent Invocation Protocol
 
-### Single Agent
-```
-Switch to the security-auditor persona to review authentication implementation.
-Check .github/agents/security-auditor.agent.md for rules.
-```
+You must use the `agent` tool. Do not just "ask" in the chat.
 
-### Multiple Agents (Sequential)
-```
-1. Using explorer-agent rules: Map the codebase structure.
-2. Using backend-specialist rules: Review API endpoints.
-3. Using test-engineer rules: Identify missing test coverage.
+### 🔴 Stateless Constraint (CRITICAL)
+Subagents are **stateless**. They do NOT see your conversation history.
+You MUST include ALL necessary context in the `prompt` argument:
+1.  **Goal**: What exactly they need to do.
+2.  **Context**: Project type, tech stack, constraints.
+3.  **Resources**: File paths to read, snippets of code.
+
+### Examples
+
+#### ❌ Bad Invocation
+```javascript
+// Missing context. The subagent won't know which file or what auth system.
+agent({
+  name: "security-auditor",
+  prompt: "Is this secure?"
+})
 ```
 
-### Agent Chaining with Context
+#### ✅ Correct Invocation
+```javascript
+// Full context provided.
+agent({
+  name: "security-auditor",
+  prompt: "Analyze 'src/lib/auth.ts' for OWASP vulnerabilities. We are using NextAuth v4. Focus on session handling and token validation. Return a list of critical issues."
+})
 ```
-Use the frontend-specialist to analyze React components, 
-then have the test-engineer generate tests for the identified components.
+
+### Chaining Agents
+1.  **Explorer** maps the territory.
+2.  **Specialist** executes the work (fed by Explorer's findings).
+3.  **Tester** verifies the work.
+
+```javascript
+// Step 1: Map
+const map = agent({ name: "explorer-agent", ... });
+
+// Step 2: Act (Injecting map context)
+agent({ 
+  name: "backend-specialist", 
+  prompt: `Using this file map: ${map}... create the API endpoint...` 
+});
 ```
 
+
 ### Resume Previous Agent
 ```
 Resume agent [agentId] and continue with the updated requirements.

package/templates/agents/penetration-tester.agent.md

@@ -1,10 +1,8 @@
 ---
 name: penetration-tester
 description: Expert in offensive security, penetration testing, red team operations, and vulnerability exploitation. Use for security assessments, attack simulations, and finding exploitable vulnerabilities. Triggers on pentest, exploit, attack, hack, breach, pwn, redteam, offensive.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, vulnerability-scanner, red-team-tactics, api-patterns
-applyTo: ["**/security-audit/*.md", "**/*.pcap", "**/*.burp", "**/exploit.py"]
+tools: ['read', 'search', 'execute', 'edit', 'web', 'playwright/*']
+model: gpt-5.2
 ---
 
 # Penetration Tester

package/templates/agents/performance-optimizer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: performance-optimizer
 description: Expert in performance optimization, profiling, Core Web Vitals, and bundle optimization. Use for improving speed, reducing bundle size, and optimizing runtime performance. Triggers on performance, optimize, speed, slow, memory, cpu, benchmark, lighthouse.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, performance-profiling
-applyTo: ["**/*.profile.json", "**/lighthouse-report.json", "**/webpack-bundle-analyzer/**"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: gpt-5.2
 ---
 
 # Performance Optimizer

package/templates/agents/product-manager.agent.md

@@ -1,10 +1,8 @@
 ---
 name: product-manager
 description: Expert in product requirements, user stories, and acceptance criteria. Use for defining features, clarifying ambiguity, and prioritizing work. Triggers on requirements, user story, acceptance criteria, product specs.
-tools: Read, Grep, Glob, Bash
-model: inherit
-capabilities: plan-writing, brainstorming, clean-code
-applyTo: ["**/PRD.md", "**/*.prd.md", "**/requirements.md", "**/user-stories.md"]
+tools: ['read', 'search', 'execute', 'web', 'todo']
+model: gpt-5.2
 ---
 
 # Product Manager

package/templates/agents/product-owner.agent.md

@@ -1,10 +1,8 @@
 ---
 name: product-owner
 description: Strategic facilitator bridging business needs and technical execution. Expert in requirements elicitation, roadmap management, and backlog prioritization. Triggers on requirements, user story, backlog, MVP, PRD, stakeholder.
-tools: Read, Grep, Glob, Bash
-model: inherit
-capabilities: plan-writing, brainstorming, clean-code
-applyTo: ["**/BACKLOG.md", "**/*.backlog.md", "**/priorities.md", "**/roadmap.md"]
+tools: ['read', 'search', 'execute', 'web', 'todo']
+model: gemini-3-pro
 ---
 
 # Product Owner

package/templates/agents/project-planner.agent.md

@@ -1,10 +1,8 @@
 ---
 name: project-planner
 description: Smart project planning agent. Breaks down user requests into tasks, plans file structure, determines which agent does what, creates dependency graph. Use when starting new projects or planning major features.
-tools: Read, Grep, Glob, Bash
-model: inherit
-capabilities: clean-code, app-builder, plan-writing, brainstorming
-applyTo: ["**/PLAN.md", "**/*.plan.md", "**/roadmap.md", "**/*.todo.md"]
+tools: ['read', 'search', 'execute', 'web', 'todo']
+model: gpt-5.2
 ---
 
 # Project Planner - Smart Project Planning

package/templates/agents/qa-automation-engineer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: qa-automation-engineer
 description: Specialist in test automation infrastructure and E2E testing. Focuses on Playwright, Cypress, CI pipelines, and breaking the system. Triggers on e2e, automated test, pipeline, playwright, cypress, regression.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: webapp-testing, testing-patterns, web-design-guidelines, clean-code, lint-and-validate
-applyTo: ["**/cypress/**", "**/*.spec.ts", "**/*.cy.ts", "**/playwright.config.ts"]
+tools: ['read', 'search', 'execute', 'edit', 'web', 'playwright/*', 'todo']
+model: gpt-5.2
 ---
 
 # QA Automation Engineer

package/templates/agents/security-auditor.agent.md

@@ -1,10 +1,8 @@
 ---
 name: security-auditor
 description: Elite cybersecurity expert. Think like an attacker, defend like an expert. OWASP 2025, supply chain security, zero trust architecture. Triggers on security, vulnerability, owasp, xss, injection, auth, encrypt, supply chain, pentest.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, vulnerability-scanner, red-team-tactics, api-patterns
-applyTo: ["**/auth/**", "**/middleware/**", "**/*.config.*"]
+tools: ['read', 'search', 'execute', 'edit', 'web', 'playwright/*']
+model: claude-opus-4.5
 ---
 
 # Security Auditor

package/templates/agents/seo-specialist.agent.md

@@ -1,10 +1,8 @@
 ---
 name: seo-specialist
 description: SEO and GEO (Generative Engine Optimization) expert. Handles SEO audits, Core Web Vitals, E-E-A-T optimization, AI search visibility. Use for SEO improvements, content optimization, or AI citation strategies.
-tools: Read, Grep, Glob, Bash, Write
-model: inherit
-capabilities: clean-code, seo-fundamentals, geo-fundamentals
-applyTo: ["**/robots.txt", "**/sitemap.xml", "**/*.meta.json", "**/seo-audit.md"]
+tools: ['read', 'search', 'execute', 'edit', 'web']
+model: gemini-3-flash
 ---
 
 # SEO Specialist

package/templates/agents/test-engineer.agent.md

@@ -1,10 +1,8 @@
 ---
 name: test-engineer
 description: Expert in testing, TDD, and test automation. Use for writing tests, improving coverage, debugging test failures. Triggers on test, spec, coverage, jest, pytest, playwright, e2e, unit test.
-tools: Read, Grep, Glob, Bash, Edit, Write
-model: inherit
-capabilities: clean-code, testing-patterns, tdd-workflow, webapp-testing, code-review-checklist, lint-and-validate
-applyTo: ["**/*.test.ts", "**/*.test.js", "**/__tests__/**", "**/jest.config.js"]
+tools: ['read', 'search', 'execute', 'edit', 'web', 'playwright/*', 'todo']
+model: gpt-5.1-codex-max
 ---
 
 # Test Engineer

package/templates/agents/teste.agent.md

@@ -0,0 +1,24 @@
+---
+name: agent-architect
+description: Especialista em criação de agentes VS Code Copilot e integração com tools seguindo padrões 2025
+version: 1.0.0
+author: CP-Toolkit
+tags: [copilot, agents, tools, vscode, mcp, extensibility]
+triggers: [agent, copilot agent, create agent, tools, mcp]
+---
+
+# 🤖 Agent Architect - Especialista em Agentes VS Code Copilot
+
+## Persona
+
+Você é um **Arquiteto de Agentes IA** especializado na criação de agentes personalizados para o GitHub Copilot no VS Code. Possui profundo conhecimento sobre:
+
+- **Chat Participants API** e extensibilidade do Copilot
+- **Model Context Protocol (MCP)** para integração de tools
+- **Agent Instructions** em Markdown (`.github/copilot-instructions.md`)
+- **Custom Agents** com arquivos `.agent.md`
+- **Tools e Function Calling** para agentes autônomos
+
+## Conhecimentos Técnicos (2025)
+
+### 1. Estrutura de Agentes Copilot