cp-toolkit 2.2.11 → 2.2.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cp-toolkit",
-  "version": "2.2.11",
+  "version": "2.2.13",
   "description": "Copilot Toolkit - AI Agent framework for GitHub Copilot, Claude, Gemini CLI, and other AI assistants",
   "keywords": [
     "ai-agents",

package/src/commands/init.js

@@ -119,14 +119,14 @@ export async function initCommand(directory, options) {
     // 5. Setup .github/copilot-instructions.md
     spinner.text = 'Creating copilot-instructions.md...';
     const instructionsPath = path.join(targetDir, '.github', 'copilot-instructions.md');
-    const instructionsContent = generateCopilotInstructions(config);
-    await fs.writeFile(instructionsPath, instructionsContent);
+    const instructionsTemplatePath = path.join(templatesDir, 'copilot-instructions.md');
+    await fs.copy(instructionsTemplatePath, instructionsPath);
 
     // 6. Setup .github/cp-kit-models.yaml
     spinner.text = 'Creating cp-kit-models.yaml...';
     const modelsPath = path.join(targetDir, '.github', 'cp-kit-models.yaml');
-    const modelsContent = generateModelsConfig();
-    await fs.writeFile(modelsPath, modelsContent);
+    const modelsTemplatePath = path.join(templatesDir, 'cp-kit-models.yaml');
+    await fs.copy(modelsTemplatePath, modelsPath);
 
     // 7. Setup .vscode/mcp.json
     spinner.text = 'Configuring MCP Server...';
@@ -689,241 +689,6 @@ applyTo: ".github/workflows/**/*.yml,.github/workflows/**/*.yaml"
   }
 }
 
-function generateCopilotInstructions(config) {
-  return `# GitHub Copilot Instructions
-
-> **Copilot Kit v2** - Project: ${config.projectName}
-
-## 🤖 Agent System
-
-This project uses specialized AI agents located in \`.github/agents/\`.
-
-### Available Agents
-
-| Agent | Specialty |
-|-------|-----------|
-| orchestrator | Multi-agent coordination, complex tasks |
-| frontend-specialist | React, Next.js, CSS, accessibility |
-| backend-specialist | Node.js, Python, APIs, microservices |
-| database-architect | Schema design, SQL, Prisma, migrations |
-| security-auditor | OWASP, auth, vulnerability analysis |
-| test-engineer | Testing strategies, coverage, TDD |
-| debugger | Troubleshooting, root cause analysis |
-| devops-engineer | CI/CD, Docker, Kubernetes, infrastructure |
-| performance-optimizer | Web vitals, profiling, optimization |
-| documentation-writer | Technical docs, API documentation |
-
-### How to Use Agents
-
-To invoke an agent, reference it in your prompt:
-- "Use the **orchestrator** to plan this feature"
-- "Ask the **security-auditor** to review this code"
-- "Have the **debugger** analyze this error"
-
-## 📋 Language Instructions
-
-Context-specific rules are in \`.github/instructions/\`:
-- \`typescript-development.instructions.md\` - TypeScript files
-- \`javascript-development.instructions.md\` - JavaScript files
-- \`react-development.instructions.md\` - React components
-- \`nextjs-development.instructions.md\` - Next.js applications
-- \`python-development.instructions.md\` - Python files
-- \`security-development.instructions.md\` - Auth/security code
-- \`database-development.instructions.md\` - Database/ORM code
-- \`testing-development.instructions.md\` - Test files
-- \`api-development.instructions.md\` - API endpoints
-- \`github-actions.instructions.md\` - GitHub Actions workflows
-
-## 🔧 MCP Servers
-
-Configured in \`.vscode/mcp.json\`:
-- **filesystem** - File system access
-- **memory** - Persistent memory across sessions
-
-## 🚀 Workflows
-
-Workflow templates in \`.github/copilot-workflows/\`:
-- \`/create\` - Scaffold new features
-- \`/debug\` - Systematic debugging
-- \`/test\` - Generate test suites
-- \`/plan\` - Architecture planning
-
-## 📝 General Guidelines
-
-1. **Read before writing** - Understand existing patterns
-2. **Small, focused changes** - One concern per commit
-3. **Test coverage** - Write tests for new features
-4. **Security first** - Validate inputs, sanitize outputs
-`;
-}
-
-function generateModelsConfig() {
-  return `# .github/cp-kit-models.yaml
-# Matriz de Alocação de Modelos v3.0 (Full 20-Agent Suite)
-# Strategy: Architect-Builder Pattern (Hybrid) + Community Consensus 2026
-
-defaults:
-  temperature_planner: 0.1 # Raciocínio frio
-  temperature_executor: 0.3 # Criatividade controlada para código
-  fallback_model: "gpt-5.1-codex"
-
-agents:
-  # ==============================================================================
-  # 1. LIDERANÇA E ESTRATÉGIA (Pure Reasoning)
-  # ==============================================================================
-  orchestrator:
-    mode: "single"
-    model: "claude-opus-4.5"
-    reason: "Capacidade superior de manter o contexto de múltiplos agentes e passos."
-
-  product-manager:
-    mode: "single"
-    model: "gpt-5.2"
-    reason: "Equilíbrio ideal entre visão de negócios e viabilidade técnica."
-
-  product-owner:
-    mode: "single"
-    model: "gemini-3-pro" # (Preview)
-    reason: "Context window massiva para ingerir todo o histórico e backlog do produto."
-
-  project-planner:
-    mode: "single"
-    model: "gpt-5.2"
-    reason: "Lógica temporal robusta para cronogramas, dependências e caminho crítico."
-
-  # ==============================================================================
-  # 2. DESENVOLVIMENTO CORE (Architect-Builder Hybrid)
-  # ==============================================================================
-  backend-specialist:
-    mode: "hybrid"
-    planner:
-      model: "gpt-5.2"
-      task: "Arquitetura de API, segurança e modelagem de dados."
-    executor:
-      model: "gpt-5.2-codex"
-      task: "Implementação estrita de rotas e serviços com tipagem perfeita."
-
-  frontend-specialist:
-    mode: "hybrid"
-    planner:
-      model: "claude-opus-4.5"
-      task: "Definição de UX, Acessibilidade e Component Tree."
-    executor:
-      model: "claude-sonnet-4.5"
-      task: "Geração de React/CSS visualmente fiel e sem alucinações de layout."
-
-  mobile-developer:
-    mode: "hybrid"
-    planner:
-      model: "claude-opus-4.5"
-      task: "Arquitetura nativa vs híbrida e gerenciamento de estado complexo."
-    executor:
-      model: "claude-sonnet-4.5"
-      task: "Escrita de SwiftUI/Kotlin com sintaxe declarativa aninhada."
-
-  game-developer:
-    mode: "hybrid"
-    planner:
-      model: "gpt-5.2"
-      task: "Design de sistemas de jogo, física e loop principal."
-    executor:
-      model: "gpt-5.1-codex-max"
-      task: "Cálculos vetoriais pesados e otimização de C++/C#."
-
-  # ==============================================================================
-  # 3. INFRAESTRUTURA E OPERAÇÕES (High Cost Savings)
-  # ==============================================================================
-  devops-engineer:
-    mode: "hybrid"
-    planner:
-      model: "claude-opus-4.5"
-      task: "Estratégia de Cloud, segurança de pipelines e disaster recovery."
-    executor:
-      model: "grok-code-fast-1" # Economia extrema aqui
-      task: "Geração rápida de YAMLs, Dockerfiles e scripts Bash."
-
-  database-architect:
-    mode: "hybrid"
-    planner:
-      model: "gpt-5.2"
-      task: "Modelagem ER, normalização e estratégia de indexação."
-    executor:
-      model: "gpt-5.1-codex"
-      task: "Geração de SQL complexo, migrations e triggers."
-
-  security-auditor:
-    mode: "single"
-    model: "claude-opus-4.5"
-    reason: "Raciocínio paranoico necessário para auditoria (Red Teaming)."
-
-  penetration-tester:
-    mode: "hybrid"
-    planner:
-      model: "gpt-5.2"
-      task: "Planejamento de vetores de ataque e engenharia social."
-    executor:
-      model: "gpt-5.2-codex"
-      task: "Criação de exploits e scripts de teste de penetração."
-
-  # ==============================================================================
-  # 4. QUALIDADE E OTIMIZAÇÃO
-  # ==============================================================================
-  qa-automation-engineer:
-    mode: "hybrid"
-    planner:
-      model: "gpt-5.2"
-      task: "Estratégia de testes E2E e cobertura de cenários críticos."
-    executor:
-      model: "gpt-5.1-codex-mini" # (Preview)
-      task: "Escrita em massa de scripts Cypress/Playwright."
-
-  test-engineer:
-    mode: "single"
-    model: "gpt-5.1-codex-max"
-    reason: "Foco total em cobertura de testes unitários e mocks."
-
-  debugger:
-    mode: "single"
-    model: "claude-opus-4.5"
-    reason: "Melhor modelo para análise causal de logs e stack traces."
-
-  performance-optimizer:
-    mode: "hybrid"
-    planner:
-      model: "gpt-5.2"
-      task: "Profiling e identificação de gargalos algorítmicos."
-    executor:
-      model: "gpt-5.1-codex-max"
-      task: "Refatoração de código para redução de complexidade Big O."
-
-  # ==============================================================================
-  # 5. ESPECIALISTAS E PESQUISA
-  # ==============================================================================
-  code-archaeologist:
-    mode: "hybrid"
-    planner:
-      model: "gemini-3-pro" # (Preview)
-      task: "Leitura de todo o repositório legado para entender dependências."
-    executor:
-      model: "gpt-5.1-codex"
-      task: "Refatoração cirúrgica sem quebrar compatibilidade."
-
-  documentation-writer:
-    mode: "single"
-    model: "claude-sonnet-4.5"
-    reason: "Texto técnico mais natural, empático e bem formatado."
-
-  seo-specialist:
-    mode: "single"
-    model: "gemini-3-flash" # (Preview)
-    reason: "Acesso rápido a dados da web e tendências de busca em tempo real."
-
-  explorer-agent:
-    mode: "single"
-    model: "raptor-mini" # (Preview)
-    reason: "Pensamento lateral rápido e brainstorming divergente."`;
-}
-
 export default initCommand;
 
 

package/templates/copilot-instructions.md

@@ -0,0 +1,75 @@
+# GitHub Copilot Agent Toolkit (CP-Toolkit) - System Instructions
+
+Você é assistido por um **Sistema Multi-Agente Avançado** definido no diretório `.github/agents/`.
+Sua tarefa primária é identificar a intenção do usuário ou o contexto do arquivo e adotar a **Persona**, **Regras** e **Limitações** do agente especialista apropriado.
+
+## 🚦 Roteamento de Agentes (Master Router)
+
+Quando o usuário invocar um agente (ex: "Atue como QA") ou o contexto exigir, carregue as instruções do arquivo correspondente:
+
+### 1. Liderança & Estratégia
+| Gatilho / Intenção | Agente (Alias) | Fonte de Instruções |
+| :--- | :--- | :--- |
+| Coordenação geral, Workflow | **@Orchestrator** | `.github/agents/orchestrator.md` |
+| Visão de produto, Negócios | **@ProductManager** | `.github/agents/product-manager.md` |
+| Backlog, User Stories, Requisitos | **@ProductOwner** | `.github/agents/product-owner.md` |
+| Cronogramas, Prazos, Gantt | **@ProjectPlanner** | `.github/agents/project-planner.md` |
+
+### 2. Desenvolvimento Core
+| Gatilho / Intenção | Agente (Alias) | Fonte de Instruções |
+| :--- | :--- | :--- |
+| API, Node, Python, Server-side | **@Backend** | `.github/agents/backend-specialist.md` |
+| React, CSS, UX, Interface | **@Frontend** | `.github/agents/frontend-specialist.md` |
+| iOS, Android, Swift, Kotlin, RN | **@Mobile** | `.github/agents/mobile-developer.md` |
+| Unity, Unreal, C++, Gamedev | **@GameDev** | `.github/agents/game-developer.md` |
+
+### 3. Infraestrutura & Dados
+| Gatilho / Intenção | Agente (Alias) | Fonte de Instruções |
+| :--- | :--- | :--- |
+| SQL, Prisma, Modelagem ER | **@DBA** | `.github/agents/database-architect.md` |
+| Docker, CI/CD, AWS, Terraform | **@DevOps** | `.github/agents/devops-engineer.md` |
+
+### 4. Qualidade & Segurança
+| Gatilho / Intenção | Agente (Alias) | Fonte de Instruções |
+| :--- | :--- | :--- |
+| Scripts de Teste (E2E/Unit) | **@QA** | `.github/agents/qa-automation-engineer.md` |
+| TDD, Cobertura de Testes | **@Tester** | `.github/agents/test-engineer.md` |
+| Análise de Vulnerabilidades | **@Security** | `.github/agents/security-auditor.md` |
+| Pentest, Ataque Ético | **@RedTeam** | `.github/agents/penetration-tester.md` |
+| Bugs complexos, Logs | **@Debugger** | `.github/agents/debugger.md` |
+| Performance, Otimização, Latência | **@PerfOptimizer** | `.github/agents/performance-optimizer.md` |
+
+### 5. Especialistas & Pesquisa
+| Gatilho / Intenção | Agente (Alias) | Fonte de Instruções |
+| :--- | :--- | :--- |
+| Código Legado, Refatoração | **@Archaeologist** | `.github/agents/code-archaeologist.md` |
+| Documentação Técnica, Markdown | **@TechWriter** | `.github/agents/documentation-writer.md` |
+| SEO, Meta tags, Analytics | **@SEO** | `.github/agents/seo-specialist.md` |
+| Ideação, Brainstorming, R&D | **@Explorer** | `.github/agents/explorer-agent.md` |
+
+---
+
+## ⚡ Protocolos de Ativação
+
+### 1. Invocação Explícita
+Se o usuário disser: *"Aja como [Agente]"*, *"Como [Agente] faria isso?"* ou usar o alias (ex: *"@DevOps, corrija o pipeline"*), você **DEVE** carregar o arquivo `.md` correspondente no contexto imediatamente.
+
+### 2. Contexto Inteligente (Smart Context)
+Se nenhum agente for chamado, verifique o arquivo aberto:
+* Arquivo `.tsx` ou `.css` → Ative **@Frontend**.
+* Arquivo `Dockerfile` ou `.yml` → Ative **@DevOps**.
+* Arquivo `.sql` ou `schema.prisma` → Ative **@DBA**.
+* Arquivos com "legacy" ou "old" no nome → Ative **@Archaeologist**.
+
+### 3. Protocolo Architect-Builder (Para tarefas complexas)
+Para solicitações grandes (ex: "Crie um novo módulo de pagamentos"):
+1.  Comece com o **@Orchestrator** ou **@Backend** (Planner Mode) para gerar um arquivo `PLAN.md`.
+2.  **NÃO escreva código de implementação** até que o plano seja aprovado.
+3.  Após o plano, mude para o agente executor (ex: @Backend Executor) para implementar o código passo-a-passo.
+
+---
+
+## 🛡️ Diretrizes Globais
+* **Segurança:** Nunca gere chaves de API reais ou senhas hardcoded.
+* **Qualidade:** Sempre prefira código limpo, tipado (TypeScript) e testável.
+* **Idioma:** Responda no idioma do usuário (Português por padrão), mas mantenha termos técnicos em inglês quando padrão da indústria.

package/templates/cp-kit-models.yaml

@@ -0,0 +1,164 @@
+# .github/cp-kit-models.yaml
+# Matriz de Alocação de Modelos v3.0 (Full 20-Agent Suite)
+# Strategy: Architect-Builder Pattern (Hybrid) + Community Consensus 2026
+
+defaults:
+  temperature_planner: 0.1 # Raciocínio frio
+  temperature_executor: 0.3 # Criatividade controlada para código
+  fallback_model: "gpt-5.1-codex"
+
+agents:
+  # ==============================================================================
+  # 1. LIDERANÇA E ESTRATÉGIA (Pure Reasoning)
+  # ==============================================================================
+  orchestrator:
+    mode: "single"
+    model: "claude-opus-4.5"
+    reason: "Capacidade superior de manter o contexto de múltiplos agentes e passos."
+
+  product-manager:
+    mode: "single"
+    model: "gpt-5.2"
+    reason: "Equilíbrio ideal entre visão de negócios e viabilidade técnica."
+
+  product-owner:
+    mode: "single"
+    model: "gemini-3-pro" # (Preview)
+    reason: "Context window massiva para ingerir todo o histórico e backlog do produto."
+
+  project-planner:
+    mode: "single"
+    model: "gpt-5.2"
+    reason: "Lógica temporal robusta para cronogramas, dependências e caminho crítico."
+
+  # ==============================================================================
+  # 2. DESENVOLVIMENTO CORE (Architect-Builder Hybrid)
+  # ==============================================================================
+  backend-specialist:
+    mode: "hybrid"
+    planner:
+      model: "gpt-5.2"
+      task: "Arquitetura de API, segurança e modelagem de dados."
+    executor:
+      model: "gpt-5.2-codex"
+      task: "Implementação estrita de rotas e serviços com tipagem perfeita."
+
+  frontend-specialist:
+    mode: "hybrid"
+    planner:
+      model: "claude-opus-4.5"
+      task: "Definição de UX, Acessibilidade e Component Tree."
+    executor:
+      model: "claude-sonnet-4.5"
+      task: "Geração de React/CSS visualmente fiel e sem alucinações de layout."
+
+  mobile-developer:
+    mode: "hybrid"
+    planner:
+      model: "claude-opus-4.5"
+      task: "Arquitetura nativa vs híbrida e gerenciamento de estado complexo."
+    executor:
+      model: "claude-sonnet-4.5"
+      task: "Escrita de SwiftUI/Kotlin com sintaxe declarativa aninhada."
+
+  game-developer:
+    mode: "hybrid"
+    planner:
+      model: "gpt-5.2"
+      task: "Design de sistemas de jogo, física e loop principal."
+    executor:
+      model: "gpt-5.1-codex-max"
+      task: "Cálculos vetoriais pesados e otimização de C++/C#."
+
+  # ==============================================================================
+  # 3. INFRAESTRUTURA E OPERAÇÕES (High Cost Savings)
+  # ==============================================================================
+  devops-engineer:
+    mode: "hybrid"
+    planner:
+      model: "claude-opus-4.5"
+      task: "Estratégia de Cloud, segurança de pipelines e disaster recovery."
+    executor:
+      model: "grok-code-fast-1" # Economia extrema aqui
+      task: "Geração rápida de YAMLs, Dockerfiles e scripts Bash."
+
+  database-architect:
+    mode: "hybrid"
+    planner:
+      model: "gpt-5.2"
+      task: "Modelagem ER, normalização e estratégia de indexação."
+    executor:
+      model: "gpt-5.1-codex"
+      task: "Geração de SQL complexo, migrations e triggers."
+
+  security-auditor:
+    mode: "single"
+    model: "claude-opus-4.5"
+    reason: "Raciocínio paranoico necessário para auditoria (Red Teaming)."
+
+  penetration-tester:
+    mode: "hybrid"
+    planner:
+      model: "gpt-5.2"
+      task: "Planejamento de vetores de ataque e engenharia social."
+    executor:
+      model: "gpt-5.2-codex"
+      task: "Criação de exploits e scripts de teste de penetração."
+
+  # ==============================================================================
+  # 4. QUALIDADE E OTIMIZAÇÃO
+  # ==============================================================================
+  qa-automation-engineer:
+    mode: "hybrid"
+    planner:
+      model: "gpt-5.2"
+      task: "Estratégia de testes E2E e cobertura de cenários críticos."
+    executor:
+      model: "gpt-5.1-codex-mini" # (Preview)
+      task: "Escrita em massa de scripts Cypress/Playwright."
+
+  test-engineer:
+    mode: "single"
+    model: "gpt-5.1-codex-max"
+    reason: "Foco total em cobertura de testes unitários e mocks."
+
+  debugger:
+    mode: "single"
+    model: "claude-opus-4.5"
+    reason: "Melhor modelo para análise causal de logs e stack traces."
+
+  performance-optimizer:
+    mode: "hybrid"
+    planner:
+      model: "gpt-5.2"
+      task: "Profiling e identificação de gargalos algorítmicos."
+    executor:
+      model: "gpt-5.1-codex-max"
+      task: "Refatoração de código para redução de complexidade Big O."
+
+  # ==============================================================================
+  # 5. ESPECIALISTAS E PESQUISA
+  # ==============================================================================
+  code-archaeologist:
+    mode: "hybrid"
+    planner:
+      model: "gemini-3-pro" # (Preview)
+      task: "Leitura de todo o repositório legado para entender dependências."
+    executor:
+      model: "gpt-5.1-codex"
+      task: "Refatoração cirúrgica sem quebrar compatibilidade."
+
+  documentation-writer:
+    mode: "single"
+    model: "claude-sonnet-4.5"
+    reason: "Texto técnico mais natural, empático e bem formatado."
+
+  seo-specialist:
+    mode: "single"
+    model: "gemini-3-flash" # (Preview)
+    reason: "Acesso rápido a dados da web e tendências de busca em tempo real."
+
+  explorer-agent:
+    mode: "single"
+    model: "raptor-mini" # (Preview)
+    reason: "Pensamento lateral rápido e brainstorming divergente."