agents.dev 1.0.7 → 1.4.0

package/README.md

@@ -1,17 +1,23 @@
 # agents-dev (Universal Spec CLI)
 
-Ferramenta CLI para configurar automaticamente o ambiente de desenvolvimento e instalar agentes de IA (Auditor, Coder, etc.) para diversas ferramentas como Gemini CLI, Roo Code, Cline e Kilo Code.
+Ferramenta CLI para configurar automaticamente o ambiente de desenvolvimento e instalar agentes de IA (Auditor, Coder, etc.) para diversas ferramentas modernas de IA.
 
 ## Funcionalidades
 
 ### 1. Instalação de Agentes de IA
 Lê definições agnósticas (YAML) e converte para formatos específicos:
 *   **Gemini CLI:** Gera arquivos de configuração `.toml`.
-*   **Roo Code / Cline:** Gera modos customizados (`_custom_modes.json`).
+*   **Roo Code / Cline:** Gera modos customizados (`_custom_modes.json`) e regras de contexto em `.roo/` ou `.cline/`.
+*   **GitHub Copilot:** Gera instruções em `.github/copilot-instructions.md` e agentes em `.github/agents/`.
+*   **Cursor:** Gera regras em `.cursor/rules/*.mdc`.
+*   **Windsurf:** Gera regras em `.windsurfrules`.
+*   **Trae:** Gera instruções em `.trae/instructions.md`.
+*   **OpenCode:** Gera agentes em `.opencode/`.
+*   **OpenAI / Claude (Web):** Gera prompts em texto puro na pasta `prompts/`.
 *   **Kilo Code:** Gera prompts em Markdown (`.kilo/prompts/*.md`).
 
-### 2. Configuração
-Automatiza a criação de arquivos de configuração necessários para integrar agentes de IA ao seu fluxo de trabalho.
+### 2. Configuração de Workflow
+Automatiza a criação da estrutura de documentação (`docs/` e `docs/logs/`) para suportar o fluxo de trabalho dos agentes.
 
 ## Instalação e Uso
 
@@ -20,6 +26,7 @@ Você pode executar a ferramenta diretamente via `npx` sem instalação prévia:
 ```bash
 npx agents-dev
 ```
+*(ou `npx agents.dev`)*
 
 Ou instalar globalmente:
 
@@ -31,8 +38,8 @@ agents-dev
 ## Como funciona
 
 1.  Execute `npx agents-dev` na raiz do seu projeto.
-2.  A interface interativa perguntará quais configurações você deseja aplicar.
-3.  Os arquivos de configuração dos agentes serão gerados na pasta do seu projeto.
+2.  A interface interativa perguntará quais configurações você deseja aplicar e para qual ferramenta.
+3.  Os arquivos de configuração dos agentes serão gerados na pasta do seu projeto automaticamente.
 
 ## Estrutura do Projeto
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agents.dev",
-    "version": "1.0.7",
+    "version": "1.4.0",
     "description": "Instalador automático dos agentes de desenvolvimento",
     "main": "src/index.js",
     "bin": {

package/src/index.js

@@ -1,14 +1,23 @@
 #!/usr/bin/env node
 
 const fs = require('fs');
+const fsp = require('fs/promises');
 const path = require('path');
-const yaml = require('js-yaml');
 const { intro, outro, multiselect, select, spinner, note } = require('@clack/prompts');
 const pc = require('picocolors');
 
 // Módulos Internos
-const { AgentSchema } = require('./lib/schema');
-const { toGeminiTOML, toRooConfig, toKiloMarkdown } = require('./lib/transformers');
+const { loadAgents } = require('./lib/agents');
+const { 
+    toGeminiTOML, 
+    toRooConfig, 
+    toKiloMarkdown, 
+    toCopilotInstructions,
+    toCursorMDC,
+    toWindsurfRules,
+    toPlainSystemPrompt,
+    toTraeRules
+} = require('./lib/transformers');
 const { generateWorkflowGuide } = require('./lib/docs');
 
 async function main() {
@@ -21,7 +30,6 @@ async function main() {
         options: [
             { value: 'docs', label: 'Gerar Documentação de Workflow (docs/README.md)', hint: 'Essencial' },
             { value: 'agents', label: 'Instalar Agentes de IA', hint: 'Recomendado' },
-            { value: 'vscode', label: 'Configurar VS Code', hint: '(Simulado)' },
         ],
         required: true,
     });
@@ -47,9 +55,15 @@ async function main() {
             message: 'Onde você deseja instalar os Agentes?',
             options: [
                 { value: 'gemini', label: 'Gemini CLI', hint: '.gemini/commands/dev' },
-                { value: 'roo', label: 'Roo Code', hint: 'Gera roo_custom_modes.json' },
-                { value: 'cline', label: 'Cline', hint: 'Gera cline_custom_modes.json' },
+                { value: 'roo', label: 'Roo Code', hint: '.roo/ & custom_modes.json' },
+                { value: 'cline', label: 'Cline', hint: '.cline/ & custom_modes.json' },
+                { value: 'cursor', label: 'Cursor', hint: '.cursor/rules/*.mdc' },
+                { value: 'windsurf', label: 'Windsurf', hint: '.windsurfrules' },
+                { value: 'trae', label: 'Trae IDE', hint: '.trae/instructions.md' },
                 { value: 'kilo', label: 'Kilo Code', hint: '.kilo/prompts/*.md' },
+                { value: 'copilot', label: 'GitHub Copilot', hint: '.github/copilot-instructions.md' },
+                { value: 'web', label: 'OpenAI / Claude', hint: 'prompts/*.txt (Copiar & Colar)' },
+                { value: 'opencode', label: 'OpenCode', hint: '.opencode/*.md' },
             ],
         });
 
@@ -65,69 +79,121 @@ async function processAgentsInstallation(tool) {
     const s = spinner();
     s.start('Carregando definições...');
 
-    const definitionsDir = path.join(__dirname, '..', 'definitions');
-    if (!fs.existsSync(definitionsDir)) {
-        s.stop('Falha');
-        note(`Pasta de definições não encontrada: ${definitionsDir}`, 'Erro Fatal');
-        return;
-    }
-
-    const files = fs.readdirSync(definitionsDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
-    const validAgents = [];
+    try {
+        const validAgents = await loadAgents();
 
-    // Validação e Carregamento
-    for (const file of files) {
-        try {
-            const content = fs.readFileSync(path.join(definitionsDir, file), 'utf8');
-            const raw = yaml.load(content);
-            
-            // Validação com Zod
-            const parsed = AgentSchema.safeParse(raw);
-            if (!parsed.success) {
-                console.warn(pc.yellow(`⚠️  Ignorando ${file}: Inválido`));
-                continue;
-            }
-
-            const agent = parsed.data;
-            agent.slug = file.replace(/\.ya?ml$/, '').replace(/\./g, '-'); // dev.coder -> dev-coder
-            validAgents.push(agent);
-
-        } catch (e) {
-            console.error(pc.red(`Erro ao ler ${file}: ${e.message}`));
+        if (validAgents.length === 0) {
+            s.stop('Nenhum agente válido encontrado.');
+            return;
         }
-    }
 
-    s.message(`Instalando ${validAgents.length} agentes para ${tool}...`);
+        s.message(`Instalando ${validAgents.length} agentes para ${tool}...`);
 
-    // Instalação Específica por Ferramenta
-    try {
+        // Instalação Específica por Ferramenta
         if (tool === 'gemini') {
             const targetDir = path.join(process.cwd(), '.gemini', 'commands', 'dev');
-            if (!fs.existsSync(targetDir)) fs.mkdirSync(targetDir, { recursive: true });
+            await fsp.mkdir(targetDir, { recursive: true });
 
-            for (const agent of validAgents) {
+            await Promise.all(validAgents.map(agent => {
                 const toml = toGeminiTOML(agent);
-                // Nome original com pontos (dev.coder.toml) é preferível para Gemini CLI
-                const fileName = `${agent.slug.replace(/-/g, '.')}.toml`; 
-                fs.writeFileSync(path.join(targetDir, fileName), toml);
-            }
+                // Usa originalName para manter pontos (dev.coder.toml)
+                const fileName = `${agent.originalName}.toml`; 
+                return fsp.writeFile(path.join(targetDir, fileName), toml);
+            }));
         } 
         else if (tool === 'roo' || tool === 'cline') {
+            const configDir = tool === 'roo' ? '.roo' : '.cline';
+            const targetDir = path.join(process.cwd(), configDir);
+            await fsp.mkdir(targetDir, { recursive: true });
+
+            // 1. Gera arquivos Markdown (Contexto)
+            await Promise.all(validAgents.map(agent => {
+                const md = toKiloMarkdown(agent); // Reutiliza formato Markdown padrão
+                return fsp.writeFile(path.join(targetDir, `${agent.slug}.md`), md);
+            }));
+
+            // 2. Gera JSON para Custom Modes (Configuração da Extensão)
             const modes = validAgents.map(agent => toRooConfig(agent, agent.slug));
             const jsonContent = JSON.stringify({ customModes: modes }, null, 2);
             const fileName = `${tool}_custom_modes.json`;
-            fs.writeFileSync(path.join(process.cwd(), fileName), jsonContent);
-            note(`Copie o conteúdo de '${fileName}' para as configurações da extensão.`, 'Ação Manual');
+            await fsp.writeFile(path.join(process.cwd(), fileName), jsonContent);
+            
+            note(`1. Arquivos de contexto salvos em '${configDir}/'\n2. Copie o conteúdo de '${fileName}' para configurar os modos na extensão.`, 'Configuração Híbrida');
         } 
         else if (tool === 'kilo') {
             const targetDir = path.join(process.cwd(), '.kilo', 'prompts');
-            if (!fs.existsSync(targetDir)) fs.mkdirSync(targetDir, { recursive: true });
+            await fsp.mkdir(targetDir, { recursive: true });
 
-            for (const agent of validAgents) {
+            await Promise.all(validAgents.map(agent => {
                 const md = toKiloMarkdown(agent);
-                fs.writeFileSync(path.join(targetDir, `${agent.slug}.md`), md);
-            }
+                return fsp.writeFile(path.join(targetDir, `${agent.slug}.md`), md);
+            }));
+        }
+        else if (tool === 'copilot') {
+            const githubDir = path.join(process.cwd(), '.github');
+            const agentsDir = path.join(githubDir, 'agents');
+            await fsp.mkdir(agentsDir, { recursive: true });
+
+            // 1. Gera todos os agentes individuais
+            await Promise.all(validAgents.map(agent => {
+                const md = toCopilotInstructions(agent);
+                return fsp.writeFile(path.join(agentsDir, `${agent.slug}.md`), md);
+            }));
+
+            // 2. Define o copilot-instructions.md principal
+            // Tenta achar o 'dev.coder' ou usa o primeiro da lista
+            const mainAgent = validAgents.find(a => a.slug.includes('coder')) || validAgents[0];
+            const mainInstructions = toCopilotInstructions(mainAgent);
+            
+            await fsp.writeFile(path.join(githubDir, 'copilot-instructions.md'), mainInstructions);
+            note(`Agente principal (${mainAgent.name}) definido em .github/copilot-instructions.md\nOutros agentes salvos em .github/agents/`, 'Configuração Copilot');
+        }
+        else if (tool === 'cursor') {
+            const rulesDir = path.join(process.cwd(), '.cursor', 'rules');
+            await fsp.mkdir(rulesDir, { recursive: true });
+
+            await Promise.all(validAgents.map(agent => {
+                const mdc = toCursorMDC(agent);
+                return fsp.writeFile(path.join(rulesDir, `${agent.slug}.mdc`), mdc);
+            }));
+            note(`Regras salvas em .cursor/rules/*.mdc`, 'Configuração Cursor');
+        }
+        else if (tool === 'windsurf') {
+            const mainAgent = validAgents.find(a => a.slug.includes('coder')) || validAgents[0];
+            const rules = toWindsurfRules(mainAgent);
+            await fsp.writeFile(path.join(process.cwd(), '.windsurfrules'), rules);
+            note(`Regras salvas em .windsurfrules usando o perfil do agente ${mainAgent.name}`, 'Configuração Windsurf');
+        }
+        else if (tool === 'trae') {
+            const traeDir = path.join(process.cwd(), '.trae');
+            await fsp.mkdir(traeDir, { recursive: true });
+            
+            const mainAgent = validAgents.find(a => a.slug.includes('coder')) || validAgents[0];
+            const rules = toTraeRules(mainAgent);
+            await fsp.writeFile(path.join(traeDir, 'instructions.md'), rules);
+            note(`Instruções salvas em .trae/instructions.md`, 'Configuração Trae');
+        }
+        else if (tool === 'web') {
+            const targetDir = path.join(process.cwd(), 'prompts');
+            await fsp.mkdir(targetDir, { recursive: true });
+
+            await Promise.all(validAgents.map(agent => {
+                const txt = toPlainSystemPrompt(agent);
+                return fsp.writeFile(path.join(targetDir, `${agent.slug}.txt`), txt);
+            }));
+            note(`Prompts salvos na pasta 'prompts/'. Copie e cole no ChatGPT ou Claude.`, 'Configuração Web');
+        }
+        else if (tool === 'opencode') {
+            const targetDir = path.join(process.cwd(), '.opencode');
+            await fsp.mkdir(targetDir, { recursive: true });
+
+            await Promise.all(validAgents.map(agent => {
+                const md = toKiloMarkdown(agent); // Reutiliza Markdown padrão
+                return fsp.writeFile(path.join(targetDir, `${agent.slug}.md`), md);
+            }));
+            note(`Agentes salvos em .opencode/*.md`, 'Configuração OpenCode');
         }
+        
         s.stop('Instalação finalizada!');
 
     } catch (e) {

package/src/lib/agents.js

@@ -0,0 +1,68 @@
+const fs = require('fs/promises');
+const path = require('path');
+const yaml = require('js-yaml');
+const { AgentSchema } = require('./schema');
+const pc = require('picocolors');
+
+/**
+ * Carrega e valida todas as definições de agentes da pasta definitions
+ * @returns {Promise<Array>} Lista de agentes validados
+ */
+async function loadAgents() {
+    const definitionsDir = path.join(__dirname, '..', '..', 'definitions');
+    
+    try {
+        await fs.access(definitionsDir);
+    } catch {
+        throw new Error(`Pasta de definições não encontrada: ${definitionsDir}`);
+    }
+
+    const files = await fs.readdir(definitionsDir);
+    const yamlFiles = files.filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    
+    // Leitura e processamento em paralelo
+    const results = await Promise.all(yamlFiles.map(async (file) => {
+        try {
+            const content = await fs.readFile(path.join(definitionsDir, file), 'utf8');
+            const raw = yaml.load(content);
+            
+            const parsed = AgentSchema.safeParse(raw);
+            if (!parsed.success) {
+                return { 
+                    success: false, 
+                    file, 
+                    error: 'Validação do Schema falhou',
+                    details: parsed.error.format()
+                };
+            }
+
+            const agent = parsed.data;
+            // Normaliza o slug: dev.coder -> dev-coder
+            agent.slug = file.replace(/\.ya?ml$/, '').replace(/\./g, '-');
+            // Mantém o nome original do arquivo para referência (útil para Gemini CLI)
+            agent.originalName = file.replace(/\.ya?ml$/, '');
+            
+            return { success: true, agent };
+
+        } catch (e) {
+            return { success: false, file, error: e.message };
+        }
+    }));
+
+    // Separa sucessos e falhas
+    const validAgents = [];
+    const errors = [];
+
+    results.forEach(res => {
+        if (res.success) {
+            validAgents.push(res.agent);
+        } else {
+            errors.push(res);
+            console.warn(pc.yellow(`⚠️  Ignorando ${res.file}: ${res.error}`));
+        }
+    });
+
+    return validAgents;
+}
+
+module.exports = { loadAgents };

package/src/lib/docs.js

@@ -3,12 +3,18 @@ const path = require('path');
 const pc = require('picocolors');
 
 /**
- * Gera o guia de workflow do projeto
+ * Gera o guia de workflow e a estrutura de pastas necessária para os agentes
  */
 function generateWorkflowGuide(baseDir) {
     const docsDir = path.join(baseDir, 'docs');
+    const logsDir = path.join(docsDir, 'logs');
     
-    // Conteúdo baseado no exemplo provided
+    // Cria a estrutura de pastas recursivamente (Funciona em Windows, Mac e Linux)
+    if (!fs.existsSync(logsDir)) {
+        fs.mkdirSync(logsDir, { recursive: true });
+    }
+
+    // Conteúdo do README.md
     const content = `# 🤖 Agent Workflow Guide
 
 Este documento descreve o fluxo de desenvolvimento padrão usando os Agentes instalados.
@@ -19,10 +25,10 @@ O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iter
 ## 1. 🏗️ Project Spec (@Project Architect)
 **Role:** O Visionário.
 **Goal:** Traduzir sua ideia vaga em uma Especificação concreta com "Project Principles" definidos.
-- **Comando:** \
+- **Comando:** \\
 /dev:project "Eu quero um App de Todo que..."
 - **Saída:** 
-`docs/project.md`
+\`docs/project.md\`
 
 ## 2. 🧱 Requirements Engineering (@Requirements Engineer)
 **Role:** O Tech Lead.
@@ -31,7 +37,7 @@ O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iter
 - **Comando:** 
 /dev:requirements
 - **Saída:** 
-`docs/requirements.md`
+\`docs/requirements.md\`
 
 ## 3. 🗺️ Roadmap Strategy (@Milestone Manager)
 **Role:** O Estrategista.
@@ -39,7 +45,7 @@ O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iter
 - **Comando:** 
 /dev:milestone
 - **Saída:** 
-`docs/milestones.md`
+\`docs/milestones.md\`
 
 ## 4. 📋 Task Planning (@Task Planner)
 **Role:** O Gerente.
@@ -48,7 +54,7 @@ O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iter
 - **Comando:** 
 /dev:tasks <Milestone_ID>
 - **Saída:** 
-`docs/task.md`
+\`docs/task.md\`
 
 ## 5. 🕵️ Blueprint Audit (@Auditor)
 **Role:** O Guardião.
@@ -56,16 +62,16 @@ O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iter
 - **Comando:** 
 /dev:auditor
 - **Saída:** 
-`audit_report.md`
+\`audit_report.md\`
 
 ## 6. 💻 Implementation (@Coder)
 **Role:** O Construtor.
 **Goal:** Executar *uma tarefa por vez* do arquivo 
-`task.md`.
+\`task.md\`.
 - **Comando:** 
 /dev:coder <Task_ID>
 - **Buffer:** 
-`work_log.md`
+\`work_log.md\`
 
 ## 7. ⚖️ Quality Assurance (@QA Engineer)
 **Role:** O Inspetor.
@@ -73,25 +79,26 @@ O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iter
 - **Comando:** 
 /dev:review <Task_ID>
 - **Saída:** 
-`docs/logs/review_log.md`
+\`docs/logs/review_log.md\`
 
 ## 8. 📦 Release Management (@Release Manager)
 **Role:** O Historiador.
 **Goal:** Consolidar o 
-`work_log.md` em um 
-`changelog.md` permanente.
+\`work_log.md\` em um 
+\`changelog.md\` permanente.
 - **Comando:** 
 /dev:log
 - **Saída:** 
-`changelog.md`
+\`changelog.md\`
 `;
 
-    if (!fs.existsSync(docsDir)) {
-        fs.mkdirSync(docsDir, { recursive: true });
-        fs.writeFileSync(path.join(docsDir, 'README.md'), content);
+    const readmePath = path.join(docsDir, 'README.md');
+    if (!fs.existsSync(readmePath)) {
+        fs.writeFileSync(readmePath, content);
         return true;
     }
-    return false;
+    
+    return true; // Retorna true indicando que a estrutura foi garantida
 }
 
 module.exports = { generateWorkflowGuide };

package/src/lib/transformers.js

@@ -86,4 +86,114 @@ function toKiloMarkdown(agent) {
     return parts.join('\n');
 }
 
-module.exports = { toGeminiTOML, toRooConfig, toKiloMarkdown };
+/**
+ * Converte para Instruções do GitHub Copilot (.github/copilot-instructions.md)
+ */
+function toCopilotInstructions(agent) {
+    const parts = [
+        `<!-- GitHub Copilot Instructions for ${agent.name} -->`,
+        `# Identity and Role`,
+        `You are **${agent.name}** ${agent.emoji}.`,
+        `**Role**: ${agent.role}`,
+        `\n## Core Instructions`,
+        agent.systemPrompt.trim(),
+        '\n'
+    ];
+
+    if (agent.rules && agent.rules.length > 0) {
+        parts.push(`## Rules & Guidelines`);
+        agent.rules.forEach(rule => parts.push(`- ${rule}`));
+    }
+    
+    // Adiciona uma seção de estilo de resposta para garantir conformidade
+    parts.push(`\n## Response Style`);
+    parts.push(`- Be concise and objective.`);
+    parts.push(`- Use Portuguese (Brazil) unless told otherwise.`);
+    parts.push(`- Follow the project conventions defined in the workspace.`);
+
+    return parts.join('\n');
+}
+
+/**
+ * Converte para Cursor Rules (.mdc)
+ * Inclui Frontmatter para Contexto
+ */
+function toCursorMDC(agent) {
+    // Tenta inferir globs baseados no papel do agente
+    let globs = "*";
+    const roleLower = agent.slug.toLowerCase();
+    
+    if (roleLower.includes('test') || roleLower.includes('qa')) globs = "*.test.*, *.spec.*, **/tests/**";
+    if (roleLower.includes('css') || roleLower.includes('style')) globs = "*.css, *.scss, *.tailwind";
+    if (roleLower.includes('sql') || roleLower.includes('db')) globs = "*.sql, *.prisma, *.schema";
+
+    return `---
+description: ${agent.description || agent.role}
+globs: ${globs}
+---
+# ${agent.name} ${agent.emoji}
+
+Role: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${agent.rules && agent.rules.length > 0 ? '## Rules\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para Windsurf (.windsurfrules)
+ */
+function toWindsurfRules(agent) {
+    return `# ${agent.name} ${agent.emoji} Rules
+
+Role: ${agent.role}
+
+## Core Logic
+${agent.systemPrompt.trim()}
+
+${agent.rules && agent.rules.length > 0 ? '## Guidelines\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para System Prompt Puro (OpenAI/Claude/Web)
+ */
+function toPlainSystemPrompt(agent) {
+    return `You are ${agent.name} ${agent.emoji}
+Role: ${agent.role}
+
+[SYSTEM INSTRUCTIONS]
+${agent.systemPrompt.trim()}
+
+${agent.rules && agent.rules.length > 0 ? '[GUIDELINES]\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para Trae Instructions
+ */
+function toTraeRules(agent) {
+    return `<!-- Trae Workspace Rules -->
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## Context & Instructions
+${agent.systemPrompt.trim()}
+
+${agent.rules && agent.rules.length > 0 ? '## Constraints\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+module.exports = { 
+    toGeminiTOML, 
+    toRooConfig, 
+    toKiloMarkdown, 
+    toCopilotInstructions,
+    toCursorMDC,
+    toWindsurfRules,
+    toPlainSystemPrompt,
+    toTraeRules
+};