maestro-bundle 1.0.0 → 1.2.0

package/README.md

@@ -1,91 +1,83 @@
 # maestro-bundle
 
-Um comando. Bundle instalado. Agente governado.
+Um comando. Bundle instalado. Agente governado. Funciona com **qualquer editor AI**.
 
 ```bash
-npx maestro-bundle ai-agents
+npx maestro-bundle ai-agents claude
 ```
 
-Instala automaticamente:
-- `AGENTS.md` na raiz (compatível com Cursor, Claude Code, Copilot, Windsurf, etc.)
-- `skills/` com todas as skills do bundle
-- `.spec/constitution.md` do GitHub Spec Kit
-- `references/` com docs de referência
-- Instala o GitHub Spec Kit se necessário
+## Editores suportados
 
-## Bundles disponíveis
-
-```bash
-npx maestro-bundle ai-agents              # Python + LangChain + LangGraph + FastAPI
-npx maestro-bundle jhipster-monorepo       # Java 21 + Spring Boot + Angular + PostgreSQL
-npx maestro-bundle jhipster-microservices  # Java 21 + Spring Boot + Kafka + Consul + K8s
-npx maestro-bundle data-pipeline           # Python + Pandas + Scikit-learn + MLflow
-npx maestro-bundle frontend-spa            # React + TypeScript + Tailwind + Vite
-```
+| Editor | Comando | O que instala |
+|---|---|---|
+| **Claude Code** | `npx maestro-bundle <bundle> claude` | `CLAUDE.md` + `.claude/rules/` |
+| **Cursor** | `npx maestro-bundle <bundle> cursor` | `.cursorrules` + `.cursor/rules/` |
+| **OpenAI Codex** | `npx maestro-bundle <bundle> codex` | `AGENTS.md` |
+| **GitHub Copilot** | `npx maestro-bundle <bundle> copilot` | `.github/copilot-instructions.md` + `.github/instructions/` |
+| **Windsurf** | `npx maestro-bundle <bundle> windsurf` | `.windsurfrules` |
+| **Todos** | `npx maestro-bundle <bundle> all` | Tudo acima de uma vez |
 
-## Uso
+## Bundles disponíveis
 
 ```bash
-# Instalar no diretório atual
-npx maestro-bundle ai-agents
-
-# Instalar em outro diretório
-npx maestro-bundle jhipster-monorepo ./meu-projeto
-
-# Ver bundles disponíveis
-npx maestro-bundle --help
+npx maestro-bundle ai-agents claude              # Agentes AI com LangChain
+npx maestro-bundle jhipster-monorepo cursor       # JHipster monolítico
+npx maestro-bundle jhipster-microservices all     # JHipster microsserviços
+npx maestro-bundle data-pipeline codex            # Pipeline dados/ML
+npx maestro-bundle frontend-spa copilot           # React SPA
 ```
 
 ## O que acontece
 
 ```
-$ npx maestro-bundle ai-agents
+$ npx maestro-bundle ai-agents all
 
-  Instalando: Sistema Multi-Agente com AI
-  Destino:    /home/user/meu-projeto
+  Bundle:  Sistema Multi-Agente com AI
+  Editor:  Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Windsurf
 
-  ✔ Estrutura criada
-  ✔ AGENTS.md instalado na raiz
-  ✔ 14 skills instaladas
-  ✔ .spec/constitution.md instalado
-  ✔ References instalados
-  ✔ Spec Kit já disponível
-  ✔ Spec Kit inicializado
+  ✔ Claude Code: CLAUDE.md + AGENTS.md, 14 rules em .claude/rules/
+  ✔ Cursor: .cursorrules, 14 rules em .cursor/rules/
+  ✔ OpenAI Codex: AGENTS.md
+  ✔ GitHub Copilot: .github/copilot-instructions.md, 14 rules em .github/instructions/
+  ✔ Windsurf: .windsurfrules
+  ✔ 14 skills canônicas
+  ✔ .spec/constitution.md (GitHub Spec Kit)
+  ✔ Spec Kit instalado
 
   Pronto!
-
-  Arquivos instalados:
-    AGENTS.md                Comportamento do agente (qualquer editor AI)
-    .spec/constitution.md    Princípios do projeto (GitHub Spec Kit)
-    skills/ (14 skills)      Capacidades do agente
-    references/              Documentos de referência
-
-  Próximos passos:
-    1. Abra o projeto no seu editor AI (Cursor, Claude Code, Copilot, etc.)
-    2. O agente já conhece os padrões do projeto
-    3. Para nova demanda: /speckit.specify
 ```
 
-## Resultado no projeto
+## Onde cada editor procura
 
 ```
 seu-projeto/
-├── AGENTS.md                     # Lido por qualquer editor AI
-├── .spec/
-│   └── constitution.md           # Princípios (GitHub Spec Kit)
-├── skills/
-│   ├── commit-pattern/SKILL.md   # Do bundle-base
-│   ├── code-review/SKILL.md      # Do bundle-base
-│   ├── rag-pipeline/SKILL.md     # Do bundle escolhido
-│   ├── agent-orchestration/SKILL.md
+├── CLAUDE.md                              ← Claude Code
+├── AGENTS.md                              ← Codex, agents.md universal
+├── .cursorrules                           ← Cursor
+├── .windsurfrules                         ← Windsurf
+├── .claude/rules/*.md                     ← Claude Code (skills como rules)
+├── .cursor/rules/*.md                     ← Cursor (skills como rules)
+├── .github/copilot-instructions.md        ← Copilot
+├── .github/instructions/*.instructions.md ← Copilot (skills)
+├── .spec/constitution.md                  ← GitHub Spec Kit (SDD)
+├── skills/                                ← Canônicas (Deep Agents, referência)
+│   ├── rag-pipeline/SKILL.md
+│   ├── clean-architecture/SKILL.md
 │   └── ...
-├── references/
-│   └── ...
-└── src/
+└── references/                            ← Docs sob demanda
 ```
 
-## Compatibilidade
+## Uso avançado
+
+```bash
+# Instalar em diretório específico
+npx maestro-bundle jhipster-monorepo cursor ./meu-projeto
+
+# Ver bundles e editores disponíveis
+npx maestro-bundle --help
+```
 
-O `AGENTS.md` segue o padrão [agents.md](https://agents.md/) e funciona com 30+ editores AI.
+## Links
 
-O `.spec/` segue o padrão [GitHub Spec Kit](https://github.com/github/spec-kit) para SDD.
+- [AGENTS.md spec](https://agents.md/) — Padrão universal para instruções de agentes
+- [GitHub Spec Kit](https://github.com/github/spec-kit) — SDD (Specification-Driven Development)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maestro-bundle",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Instala bundles de governança para projetos com AI agents. Um comando, tudo configurado.",
   "bin": {
     "maestro-bundle": "./src/cli.mjs"

package/src/cli.mjs

@@ -9,183 +9,398 @@ import ora from "ora";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
+// ============================================================
+// BUNDLES
+// ============================================================
 const BUNDLES = {
   "ai-agents": {
     name: "Sistema Multi-Agente com AI",
-    description: "Python + LangChain + LangGraph + FastAPI + pgvector",
+    desc: "Python + LangChain + LangGraph + FastAPI + pgvector",
   },
   "jhipster-monorepo": {
     name: "JHipster Monorepo",
-    description: "Java 21 + Spring Boot + Angular + PostgreSQL + Liquibase",
+    desc: "Java 21 + Spring Boot + Angular + PostgreSQL + Liquibase",
   },
   "jhipster-microservices": {
     name: "JHipster Microservices",
-    description: "Java 21 + Spring Boot + Angular + Kafka + Consul + K8s",
+    desc: "Java 21 + Spring Boot + Angular + Kafka + Consul + K8s",
   },
   "data-pipeline": {
     name: "Pipeline de Dados e ML",
-    description: "Python + Pandas + Scikit-learn + MLflow + Airflow",
+    desc: "Python + Pandas + Scikit-learn + MLflow + Airflow",
   },
   "frontend-spa": {
     name: "Frontend SPA",
-    description: "React + TypeScript + Tailwind + Vite",
+    desc: "React + TypeScript + Tailwind + Vite",
   },
 };
 
+// ============================================================
+// EDITORS — paths corretos para cada editor
+//
+// Claude Code:
+//   Instruções:  CLAUDE.md (raiz) com @AGENTS.md
+//   Skills:      .claude/skills/<nome>/SKILL.md
+//   Rules:       .claude/rules/<nome>.md
+//
+// Cursor:
+//   Instruções:  .cursor/rules/ (rules .mdc ou .md)
+//   Também lê:   AGENTS.md (raiz)
+//
+// Codex (OpenAI):
+//   Instruções:  AGENTS.md (raiz)
+//   Sem pasta de skills/rules
+//
+// Copilot:
+//   Instruções:  .github/copilot-instructions.md
+//   Rules:       .github/instructions/<nome>.instructions.md
+//
+// Windsurf:
+//   Instruções:  .windsurfrules (raiz)
+//   Sem pasta de skills/rules
+// ============================================================
+const EDITORS = {
+  claude: {
+    name: "Claude Code",
+    instructionsFile: "CLAUDE.md",
+    skillsDir: ".claude/skills",         // Skills como SKILL.md com frontmatter
+    rulesDir: ".claude/rules",           // Rules curtas (padrões gerais)
+    needsAgentsMd: true,                 // CLAUDE.md faz @AGENTS.md
+  },
+  cursor: {
+    name: "Cursor",
+    instructionsFile: null,              // Cursor lê AGENTS.md na raiz
+    skillsDir: ".cursor/skills",         // Skills como SKILL.md (mesmo formato do Claude)
+    rulesDir: null,                      // Não usar rules, usar skills
+    needsAgentsMd: true,                 // Cursor lê AGENTS.md na raiz
+  },
+  codex: {
+    name: "OpenAI Codex",
+    instructionsFile: "AGENTS.md",
+    skillsDir: null,
+    rulesDir: null,
+    needsAgentsMd: false,                // AGENTS.md É o arquivo principal
+  },
+  copilot: {
+    name: "GitHub Copilot",
+    instructionsFile: ".github/copilot-instructions.md",
+    skillsDir: null,
+    rulesDir: ".github/instructions",    // .instructions.md com frontmatter
+    needsAgentsMd: false,
+  },
+  windsurf: {
+    name: "Windsurf",
+    instructionsFile: ".windsurfrules",
+    skillsDir: null,
+    rulesDir: null,
+    needsAgentsMd: false,
+  },
+  all: {
+    name: "Todos os editores",
+  },
+};
+
+// ============================================================
+// HELP
+// ============================================================
 function showHelp() {
   console.log("");
   console.log(chalk.bold("  maestro-bundle") + " — Instala bundles de governança para projetos com AI");
   console.log("");
   console.log(chalk.dim("  Uso:"));
-  console.log(`    npx maestro-bundle ${chalk.green("<bundle>")} ${chalk.dim("[diretório]")}`);
-  console.log("");
-  console.log(chalk.dim("  Bundles disponíveis:"));
+  console.log(`    npx maestro-bundle ${chalk.green("<bundle>")} ${chalk.yellow("<editor>")} ${chalk.dim("[diretório]")}`);
   console.log("");
+  console.log(chalk.dim("  Bundles:"));
   for (const [key, info] of Object.entries(BUNDLES)) {
-    console.log(`    ${chalk.green(key.padEnd(26))} ${info.name}`);
-    console.log(`    ${"".padEnd(26)} ${chalk.dim(info.description)}`);
-    console.log("");
+    console.log(`    ${chalk.green(key.padEnd(26))} ${info.desc}`);
   }
+  console.log("");
+  console.log(chalk.dim("  Editores:"));
+  console.log(`    ${chalk.yellow("claude".padEnd(12))} CLAUDE.md + .claude/skills/<nome>/SKILL.md`);
+  console.log(`    ${chalk.yellow("cursor".padEnd(12))} AGENTS.md + .cursor/skills/<nome>/SKILL.md`);
+  console.log(`    ${chalk.yellow("codex".padEnd(12))} AGENTS.md (tudo em um arquivo)`);
+  console.log(`    ${chalk.yellow("copilot".padEnd(12))} .github/copilot-instructions.md + .github/instructions/`);
+  console.log(`    ${chalk.yellow("windsurf".padEnd(12))} .windsurfrules (tudo em um arquivo)`);
+  console.log(`    ${chalk.yellow("all".padEnd(12))} Instala para todos os editores no mesmo repo`);
+  console.log("");
   console.log(chalk.dim("  Exemplos:"));
-  console.log(`    npx maestro-bundle ai-agents`);
-  console.log(`    npx maestro-bundle jhipster-monorepo ./meu-projeto`);
-  console.log(`    npx maestro-bundle frontend-spa .`);
+  console.log(`    npx maestro-bundle ai-agents claude`);
+  console.log(`    npx maestro-bundle jhipster-monorepo cursor ./meu-projeto`);
+  console.log(`    npx maestro-bundle frontend-spa all`);
   console.log("");
 }
 
-function countSkills(dir) {
-  if (!existsSync(dir)) return 0;
-  let count = 0;
-  for (const item of readdirSync(dir, { withFileTypes: true })) {
-    if (item.isDirectory()) {
-      const skillFile = join(dir, item.name, "SKILL.md");
-      if (existsSync(skillFile)) count++;
+// ============================================================
+// UTILS
+// ============================================================
+function ensureDir(dir) { mkdirSync(dir, { recursive: true }); }
+function copyDir(src, dest) { if (existsSync(src)) cpSync(src, dest, { recursive: true }); }
+function readFile(path) { return existsSync(path) ? readFileSync(path, "utf-8") : ""; }
+
+function getSkillDirs(templatesDir, bundleName) {
+  const baseSkills = join(templatesDir, "bundle-base", "skills");
+  const bundleSkills = join(templatesDir, `bundle-${bundleName}`, "skills");
+  return [baseSkills, bundleSkills].filter(existsSync);
+}
+
+function listSkills(skillDirs) {
+  const skills = [];
+  for (const dir of skillDirs) {
+    for (const item of readdirSync(dir, { withFileTypes: true })) {
+      if (item.isDirectory() && existsSync(join(dir, item.name, "SKILL.md"))) {
+        skills.push({ name: item.name, dir: join(dir, item.name) });
+      }
     }
   }
-  return count;
+  return skills;
 }
 
+// ============================================================
+// INSTALL PER EDITOR
+// ============================================================
+function installForEditor(editorKey, agentsMd, skills, targetDir) {
+  const editor = EDITORS[editorKey];
+  const installed = [];
+
+  // --- AGENTS.md (universal) ---
+  if (editor.needsAgentsMd || editorKey === "codex") {
+    writeFileSync(join(targetDir, "AGENTS.md"), agentsMd);
+    installed.push("AGENTS.md");
+  }
+
+  // --- Arquivo de instruções principal ---
+  if (editor.instructionsFile) {
+    const filePath = join(targetDir, editor.instructionsFile);
+    ensureDir(dirname(filePath));
+
+    if (editorKey === "claude") {
+      // CLAUDE.md aponta para @AGENTS.md (sem duplicar conteúdo)
+      writeFileSync(filePath, "@AGENTS.md\n");
+      installed.push("CLAUDE.md → @AGENTS.md");
+    } else if (editorKey === "codex") {
+      // AGENTS.md já foi escrito acima
+    } else {
+      // Copilot, Windsurf: copiar conteúdo completo
+      writeFileSync(filePath, agentsMd);
+      installed.push(editor.instructionsFile);
+    }
+  }
+
+  // --- Skills (Claude Code: .claude/skills/<nome>/SKILL.md) ---
+  if (editor.skillsDir) {
+    const skillsPath = join(targetDir, editor.skillsDir);
+    ensureDir(skillsPath);
+    for (const skill of skills) {
+      const destDir = join(skillsPath, skill.name);
+      copyDir(skill.dir, destDir);
+    }
+    installed.push(`${skills.length} skills em ${editor.skillsDir}/`);
+  }
+
+  // --- Rules por editor ---
+  if (editor.rulesDir) {
+    const rulesPath = join(targetDir, editor.rulesDir);
+    ensureDir(rulesPath);
+
+    for (const skill of skills) {
+      const content = readFileSync(join(skill.dir, "SKILL.md"), "utf-8");
+
+      if (editorKey === "copilot") {
+        // Copilot: .instructions.md
+        writeFileSync(join(rulesPath, `${skill.name}.instructions.md`), content);
+
+      } else if (editorKey === "claude") {
+        // Claude rules: regras curtas derivadas do AGENTS.md
+        // Skills já vão em .claude/skills/, rules é só para padrões gerais
+        // Não duplicar skills como rules
+      }
+    }
+
+    if (editorKey !== "claude") {
+      const ruleFiles = readdirSync(rulesPath).length;
+      installed.push(`${ruleFiles} rules em ${editor.rulesDir}/`);
+    }
+  }
+
+  return installed;
+}
+
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) return { description: "", body: content };
+
+  const fm = match[1];
+  const body = match[2];
+  const descMatch = fm.match(/description:\s*(.+)/);
+  const description = descMatch ? descMatch[1].trim() : "";
+  return { description, body };
+}
+
+// ============================================================
+// MAIN
+// ============================================================
 async function main() {
   const args = process.argv.slice(2);
 
-  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+  if (args.length < 2 || args.includes("--help") || args.includes("-h")) {
     showHelp();
-    process.exit(0);
+    process.exit(args.length < 2 && !args.includes("--help") ? 1 : 0);
   }
 
   const bundleName = args[0];
-  const targetDir = resolve(args[1] || ".");
+  const editorArg = args[1];
+  const targetDir = resolve(args[2] || ".");
 
   if (!BUNDLES[bundleName]) {
     console.error(chalk.red(`\n  Bundle "${bundleName}" não encontrado.\n`));
     showHelp();
     process.exit(1);
   }
+  if (!EDITORS[editorArg]) {
+    console.error(chalk.red(`\n  Editor "${editorArg}" não encontrado.\n`));
+    showHelp();
+    process.exit(1);
+  }
 
-  const info = BUNDLES[bundleName];
+  const bundleInfo = BUNDLES[bundleName];
   const templatesDir = join(__dirname, "..", "templates");
   const baseDir = join(templatesDir, "bundle-base");
   const bundleDir = join(templatesDir, `bundle-${bundleName}`);
 
   if (!existsSync(bundleDir)) {
-    console.error(chalk.red(`\n  Templates do bundle "${bundleName}" não encontrados em ${bundleDir}\n`));
+    console.error(chalk.red(`\n  Templates de "${bundleName}" não encontrados.\n`));
     process.exit(1);
   }
 
-  console.log("");
-  console.log(chalk.bold(`  Instalando: ${chalk.green(info.name)}`));
-  console.log(chalk.dim(`  Destino:    ${targetDir}`));
-  console.log("");
+  // Montar AGENTS.md (base + bundle)
+  let agentsMd = readFile(join(baseDir, "AGENTS.md"));
+  const bundleAgents = readFile(join(bundleDir, "AGENTS.md"));
+  if (bundleAgents) agentsMd += "\n\n---\n\n" + bundleAgents;
 
-  // 1. Criar diretórios
-  let spinner = ora("Criando estrutura").start();
-  for (const dir of ["skills", ".spec", "references"]) {
-    mkdirSync(join(targetDir, dir), { recursive: true });
-  }
-  spinner.succeed("Estrutura criada");
+  // Listar skills
+  const skillDirs = getSkillDirs(templatesDir, bundleName);
+  const skills = listSkills(skillDirs);
 
-  // 2. AGENTS.md (base + bundle concatenados)
-  spinner = ora("Instalando AGENTS.md").start();
-  let agentsMd = "";
-  const baseAgentsPath = join(baseDir, "AGENTS.md");
-  const bundleAgentsPath = join(bundleDir, "AGENTS.md");
+  // Editores a instalar
+  const editorsToInstall = editorArg === "all"
+    ? ["claude", "cursor", "codex", "copilot", "windsurf"]
+    : [editorArg];
 
-  if (existsSync(baseAgentsPath)) {
-    agentsMd += readFileSync(baseAgentsPath, "utf-8");
-  }
-  if (existsSync(bundleAgentsPath)) {
-    agentsMd += "\n\n---\n\n";
-    agentsMd += readFileSync(bundleAgentsPath, "utf-8");
-  }
-  writeFileSync(join(targetDir, "AGENTS.md"), agentsMd);
-  spinner.succeed("AGENTS.md instalado na raiz");
+  const editorNames = editorsToInstall.map(e => EDITORS[e].name).join(", ");
 
-  // 3. Skills (base + bundle)
-  spinner = ora("Instalando skills").start();
-  const skillsDir = join(targetDir, "skills");
-  if (existsSync(join(baseDir, "skills"))) {
-    cpSync(join(baseDir, "skills"), skillsDir, { recursive: true });
-  }
-  if (existsSync(join(bundleDir, "skills"))) {
-    cpSync(join(bundleDir, "skills"), skillsDir, { recursive: true });
+  console.log("");
+  console.log(chalk.bold(`  Bundle:  ${chalk.green(bundleInfo.name)}`));
+  console.log(chalk.bold(`  Editor:  ${chalk.yellow(editorNames)}`));
+  console.log(chalk.dim(`  Destino: ${targetDir}`));
+  console.log("");
+
+  // 1. Instalar para cada editor
+  for (const editorKey of editorsToInstall) {
+    const spinner = ora(`Instalando para ${EDITORS[editorKey].name}`).start();
+    const results = installForEditor(editorKey, agentsMd, skills, targetDir);
+    spinner.succeed(`${EDITORS[editorKey].name}: ${results.join(", ")}`);
   }
-  const skillCount = countSkills(skillsDir);
-  spinner.succeed(`${skillCount} skills instaladas`);
 
-  // 4. .spec/constitution.md
-  spinner = ora("Instalando constitution (Spec Kit)").start();
-  if (existsSync(join(bundleDir, ".spec"))) {
-    cpSync(join(bundleDir, ".spec"), join(targetDir, ".spec"), { recursive: true });
+  // 2. Skills canônicas (sempre, para Deep Agents e referência)
+  const spinner2 = ora("Instalando skills canônicas").start();
+  const skillsDest = join(targetDir, "skills");
+  ensureDir(skillsDest);
+  for (const skill of skills) {
+    copyDir(skill.dir, join(skillsDest, skill.name));
   }
-  spinner.succeed(".spec/constitution.md instalado");
+  spinner2.succeed(`${skills.length} skills canônicas em skills/`);
 
-  // 5. References
-  spinner = ora("Instalando references").start();
-  if (existsSync(join(bundleDir, "references"))) {
-    cpSync(join(bundleDir, "references"), join(targetDir, "references"), { recursive: true });
+  // 3. References
+  const spinner3 = ora("Instalando references").start();
+  const refsSrc = join(bundleDir, "references");
+  ensureDir(join(targetDir, "references"));
+  if (existsSync(refsSrc)) {
+    copyDir(refsSrc, join(targetDir, "references"));
   }
-  spinner.succeed("References instalados");
+  spinner3.succeed("references/ pronto");
+
+  // 4. GitHub Spec Kit — instalar CLI + inicializar no projeto
+  // Mapear editor para flag --ai do specify
+  const aiFlags = {
+    claude: "claude",
+    cursor: "cursor",
+    codex: "codex",
+    copilot: "copilot",
+    windsurf: "windsurf",
+  };
+  // Usar o primeiro editor como --ai (ou claude como default)
+  const primaryEditor = editorsToInstall[0];
+  const aiFlag = aiFlags[primaryEditor] || "claude";
 
-  // 6. GitHub Spec Kit
-  spinner = ora("Verificando GitHub Spec Kit").start();
-  let specKitInstalled = false;
+  // 4a. Instalar specify-cli se não tiver
+  const spinner4 = ora("Verificando GitHub Spec Kit (specify-cli)").start();
+  let specifyInstalled = false;
   try {
     execSync("specify --version", { stdio: "ignore" });
-    specKitInstalled = true;
-    spinner.succeed("Spec Kit já disponível");
+    specifyInstalled = true;
+    spinner4.succeed("specify-cli já instalado");
   } catch {
-    spinner.info("Spec Kit não encontrado");
-    spinner = ora("Instalando GitHub Spec Kit...").start();
+    spinner4.info("specify-cli não encontrado");
+    const spinner4b = ora("Instalando specify-cli...").start();
     try {
-      execSync(
-        "uv tool install specify-cli --from git+https://github.com/github/spec-kit.git",
-        { stdio: "ignore", timeout: 120000 }
-      );
-      specKitInstalled = true;
-      spinner.succeed("Spec Kit instalado");
+      execSync("uv tool install specify-cli --from git+https://github.com/github/spec-kit.git", {
+        stdio: "ignore", timeout: 120000,
+      });
+      specifyInstalled = true;
+      spinner4b.succeed("specify-cli instalado");
     } catch {
       try {
-        execSync(
-          "pip install specify-cli",
-          { stdio: "ignore", timeout: 60000 }
-        );
-        specKitInstalled = true;
-        spinner.succeed("Spec Kit instalado via pip");
+        execSync("pip install specify-cli", { stdio: "ignore", timeout: 60000 });
+        specifyInstalled = true;
+        spinner4b.succeed("specify-cli instalado via pip");
       } catch {
-        spinner.warn("Instale o Spec Kit manualmente:");
+        spinner4b.warn("Não foi possível instalar. Instale manualmente:");
         console.log(chalk.dim("    uv tool install specify-cli --from git+https://github.com/github/spec-kit.git"));
       }
     }
   }
 
-  // 7. Inicializar Spec Kit
-  if (specKitInstalled) {
-    spinner = ora("Inicializando Spec Kit").start();
-    try {
-      execSync(`specify init "${targetDir}"`, { stdio: "ignore", timeout: 15000, cwd: targetDir });
-      spinner.succeed("Spec Kit inicializado");
-    } catch {
-      spinner.info("Execute 'specify init .' no diretório do projeto");
+  // 4b. Rodar specify init no projeto para criar .specify/ e registrar /speckit.* commands
+  if (specifyInstalled) {
+    const spinner4c = ora(`Inicializando Spec Kit no projeto (--ai ${aiFlag})`).start();
+    const specifyEnv = { ...process.env, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1" };
+    let specInitOk = false;
+    const initCmds = [
+      `specify init --here --ai ${aiFlag}`,
+      `specify init . --ai ${aiFlag}`,
+      `specify init --here --ai ${aiFlag} --no-git`,
+    ];
+    for (const cmd of initCmds) {
+      try {
+        execSync(cmd, { stdio: "ignore", timeout: 30000, cwd: targetDir, env: specifyEnv });
+        specInitOk = true;
+        break;
+      } catch { /* try next */ }
+    }
+    if (specInitOk) {
+      spinner4c.succeed(`Spec Kit inicializado (/speckit.* commands disponíveis)`);
+    } else {
+      spinner4c.warn("Inicialize manualmente no terminal:");
+      console.log(chalk.dim(`    cd ${targetDir}`));
+      console.log(chalk.dim(`    specify init --here --ai ${aiFlag}`));
+    }
+
+    // 4c. Copiar constitution.md do bundle para dentro do .specify/memory/
+    const specifyMemoryDir = join(targetDir, ".specify", "memory");
+    const bundleConstitution = join(bundleDir, ".spec", "constitution.md");
+    if (existsSync(bundleConstitution)) {
+      ensureDir(specifyMemoryDir);
+      const constitutionDest = join(specifyMemoryDir, "constitution.md");
+      // Append os princípios do bundle ao constitution gerado pelo specify
+      if (existsSync(constitutionDest)) {
+        const existing = readFileSync(constitutionDest, "utf-8");
+        const bundleContent = readFileSync(bundleConstitution, "utf-8");
+        writeFileSync(constitutionDest, existing + "\n\n---\n\n" + bundleContent);
+      } else {
+        cpSync(bundleConstitution, constitutionDest);
+      }
+      const spinner4d = ora("Constitution do bundle integrado ao Spec Kit").start();
+      spinner4d.succeed("Constitution do bundle integrado ao Spec Kit");
     }
   }
 
@@ -193,16 +408,38 @@ async function main() {
   console.log("");
   console.log(chalk.green.bold("  Pronto!"));
   console.log("");
-  console.log("  Arquivos instalados:");
-  console.log(`    ${chalk.cyan("AGENTS.md")}                Comportamento do agente (qualquer editor AI)`);
-  console.log(`    ${chalk.cyan(".spec/constitution.md")}     Princípios do projeto (GitHub Spec Kit)`);
-  console.log(`    ${chalk.cyan(`skills/ (${skillCount} skills)`)}       Capacidades do agente`);
-  console.log(`    ${chalk.cyan("references/")}              Documentos de referência`);
+  console.log("  Estrutura instalada:");
+
+  for (const editorKey of editorsToInstall) {
+    const e = EDITORS[editorKey];
+    console.log(`    ${chalk.yellow(e.name)}:`);
+    if (editorKey === "claude") {
+      console.log(`      ${chalk.cyan("CLAUDE.md")} → @AGENTS.md`);
+      console.log(`      ${chalk.cyan(".claude/skills/")} (${skills.length} skills com SKILL.md)`);
+    } else if (editorKey === "cursor") {
+      console.log(`      ${chalk.cyan("AGENTS.md")} (instruções gerais)`);
+      console.log(`      ${chalk.cyan(".cursor/skills/")} (${skills.length} skills com SKILL.md)`);
+    } else if (editorKey === "codex") {
+      console.log(`      ${chalk.cyan("AGENTS.md")} (tudo em um arquivo)`);
+    } else if (editorKey === "copilot") {
+      console.log(`      ${chalk.cyan(".github/copilot-instructions.md")}`);
+      console.log(`      ${chalk.cyan(".github/instructions/")} (${skills.length} .instructions.md)`);
+    } else if (editorKey === "windsurf") {
+      console.log(`      ${chalk.cyan(".windsurfrules")}`);
+    }
+  }
+  console.log(`    ${chalk.cyan("skills/")} (${skills.length} canônicas para Deep Agents)`);
+  console.log(`    ${chalk.cyan(".specify/")} (GitHub Spec Kit — /speckit.* commands)`);
+  console.log("");
+  console.log("  Comandos SDD disponíveis no editor:");
+  console.log(`    ${chalk.cyan("/speckit.constitution")}  — Definir princípios do projeto`);
+  console.log(`    ${chalk.cyan("/speckit.specify")}       — Especificar O QUE e POR QUÊ`);
+  console.log(`    ${chalk.cyan("/speckit.plan")}          — Planejar arquitetura e stack`);
+  console.log(`    ${chalk.cyan("/speckit.tasks")}         — Quebrar em tasks atômicas`);
+  console.log(`    ${chalk.cyan("/speckit.implement")}     — Executar as tasks`);
   console.log("");
-  console.log("  Próximos passos:");
-  console.log(`    1. Abra o projeto no seu editor AI ${chalk.dim("(Cursor, Claude Code, Copilot, etc.)")}`);
-  console.log("    2. O agente já conhece os padrões do projeto");
-  console.log(`    3. Para nova demanda: ${chalk.cyan("/speckit.specify")}`);
+  console.log("  Próximo passo:");
+  console.log("    Abra o projeto no editor AI e use " + chalk.cyan("/speckit.specify") + " para começar");
   console.log("");
 }