agentic-kdd 2.1.1 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-kdd",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Autonomous development pipeline with KDD — aa: · ag: · audit: · Visual Dashboard. Works with Cursor and Claude Code.",
   "main": "src/index.js",
   "bin": {

package/src/init.js

@@ -10,223 +10,6 @@ const inquirer = require('inquirer');
 const GITHUB_REPO = 'Adrianlpz211/Agentic-KDD';
 const TEMP_DIR = path.join(require('os').tmpdir(), 'agentic-kdd-download');
 
-// ── Plantillas por stack ────────────────────────────────────────
-const TEMPLATES = {
-  nextjs: {
-    nombre: 'Next.js App',
-    tipo: 'NUEVO',
-    modulos_impl: [
-      '| 1 | Auth y middleware | /login, /registro, middleware.ts |',
-      '| 2 | Layout y navegación | app/layout.tsx, componentes nav |',
-    ],
-    modulos_pend: [
-      '- [ ] Dashboard principal',
-      '- [ ] Módulo de usuarios',
-      '- [ ] API routes principales',
-    ],
-    reglas: [
-      '- App Router (no Pages Router)',
-      '- Server Components por defecto, Client Components solo cuando necesario',
-      '- Queries de base de datos solo en lib/queries/',
-      '- Tailwind CSS para estilos',
-      '- TypeScript estricto',
-    ],
-    descripcion: 'Aplicación web con Next.js 14 App Router, TypeScript y Tailwind CSS.',
-  },
-  laravel: {
-    nombre: 'Laravel App',
-    tipo: 'NUEVO',
-    modulos_impl: [
-      '| 1 | Auth y roles | routes/auth.php, AuthController |',
-      '| 2 | Modelos base | app/Models/, migraciones |',
-    ],
-    modulos_pend: [
-      '- [ ] Panel de administración',
-      '- [ ] API REST principal',
-      '- [ ] Jobs y queues',
-    ],
-    reglas: [
-      '- Lógica de negocio en Services, no en Controllers',
-      '- Queries complejas en Repositories',
-      '- Form Requests para validación',
-      '- Resources para transformar respuestas API',
-      '- Jobs para procesos en background',
-    ],
-    descripcion: 'Aplicación web con Laravel, MySQL y arquitectura MVC.',
-  },
-  node: {
-    nombre: 'Node.js API',
-    tipo: 'NUEVO',
-    modulos_impl: [
-      '| 1 | Servidor y configuración | index.js, config/, middleware |',
-      '| 2 | Auth JWT | routes/auth.js, middleware/auth.js |',
-    ],
-    modulos_pend: [
-      '- [ ] Endpoints principales',
-      '- [ ] Base de datos y modelos',
-      '- [ ] Tests de integración',
-    ],
-    reglas: [
-      '- Express con middleware centralizado',
-      '- Lógica en services/, no en routes',
-      '- Variables de entorno en .env, nunca hardcoded',
-      '- Manejo de errores centralizado',
-    ],
-    descripcion: 'API REST con Node.js, Express y base de datos.',
-  },
-  react: {
-    nombre: 'React App',
-    tipo: 'NUEVO',
-    modulos_impl: [
-      '| 1 | Estructura base | App.tsx, router, layout |',
-      '| 2 | Estado global | context o zustand |',
-    ],
-    modulos_pend: [
-      '- [ ] Componentes principales',
-      '- [ ] Integración con API',
-      '- [ ] Tests de componentes',
-    ],
-    reglas: [
-      '- Componentes funcionales con hooks',
-      '- Estado local con useState, global con Context/Zustand',
-      '- Llamadas API centralizadas en services/',
-      '- CSS Modules o Tailwind, no inline styles',
-    ],
-    descripcion: 'Aplicación React con TypeScript y gestión de estado.',
-  },
-  php: {
-    nombre: 'PHP App',
-    tipo: 'NUEVO',
-    modulos_impl: [
-      '| 1 | Configuración base | config.php, conexión DB |',
-      '| 2 | Auth | login.php, session |',
-    ],
-    modulos_pend: [
-      '- [ ] Módulo principal',
-      '- [ ] Panel de administración',
-    ],
-    reglas: [
-      '- Queries preparadas siempre (PDO)',
-      '- Validación en el servidor',
-      '- Sin lógica en las vistas',
-    ],
-    descripcion: 'Aplicación PHP con MySQL.',
-  },
-  python: {
-    nombre: 'Python App',
-    tipo: 'NUEVO',
-    modulos_impl: [
-      '| 1 | Estructura base | main.py, config.py |',
-      '| 2 | Auth | auth/, middleware |',
-    ],
-    modulos_pend: [
-      '- [ ] Endpoints principales',
-      '- [ ] Base de datos',
-      '- [ ] Tests',
-    ],
-    reglas: [
-      '- FastAPI o Django según el proyecto',
-      '- Pydantic para validación',
-      '- SQLAlchemy para queries',
-      '- pytest para tests',
-    ],
-    descripcion: 'Aplicación Python con FastAPI/Django.',
-  },
-};
-
-// ── Detectar stack ──────────────────────────────────────────────
-function detectStack(projectPath) {
-  const stack = {
-    framework: '—', language: '—', runtime: '—',
-    base_datos: '—', packageManager: 'npm',
-    templateKey: null,
-    commands: { install: 'npm install', dev: 'npm run dev', build: 'npm run build', test: 'npm test', lint: 'npm run lint' }
-  };
-
-  if (fs.existsSync(path.join(projectPath, 'package.json'))) {
-    const pkg = fs.readJsonSync(path.join(projectPath, 'package.json'), { throws: false }) || {};
-    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-    stack.language = deps['typescript'] ? 'TypeScript' : 'JavaScript';
-    stack.runtime = 'Node.js';
-
-    if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
-      stack.packageManager = 'pnpm';
-      stack.commands = { install: 'pnpm install', dev: 'pnpm dev', build: 'pnpm build', test: 'pnpm test', lint: 'pnpm lint' };
-    } else if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
-      stack.packageManager = 'yarn';
-      stack.commands = { install: 'yarn', dev: 'yarn dev', build: 'yarn build', test: 'yarn test', lint: 'yarn lint' };
-    }
-
-    if (deps['next']) {
-      stack.framework = `Next.js ${(deps['next']||'').replace(/[\^~]/,'')}`;
-      stack.templateKey = 'nextjs';
-      if (deps['@supabase/supabase-js']) stack.base_datos = 'Supabase PostgreSQL';
-      else if (deps['prisma'] || deps['@prisma/client']) stack.base_datos = 'Prisma';
-      else if (deps['mongoose']) stack.base_datos = 'MongoDB';
-    } else if (deps['vue']) {
-      stack.framework = `Vue ${(deps['vue']||'').replace(/[\^~]/,'')}`;
-    } else if (deps['react'] && !deps['next']) {
-      stack.framework = 'React';
-      stack.templateKey = 'react';
-    } else if (deps['express']) {
-      stack.framework = 'Express';
-      stack.templateKey = 'node';
-      stack.commands.dev = pkg.scripts?.dev || 'node index.js';
-    } else if (deps['fastify']) {
-      stack.framework = 'Fastify';
-      stack.templateKey = 'node';
-    } else if (deps['@nestjs/core']) {
-      stack.framework = 'NestJS';
-      stack.templateKey = 'node';
-      stack.commands.dev = 'npm run start:dev';
-    }
-  }
-
-  if (fs.existsSync(path.join(projectPath, 'composer.json'))) {
-    const composer = fs.readJsonSync(path.join(projectPath, 'composer.json'), { throws: false }) || {};
-    stack.language = 'PHP'; stack.runtime = 'PHP';
-    stack.packageManager = 'composer';
-    stack.commands = { install: 'composer install', dev: 'php artisan serve', build: 'composer build', test: './vendor/bin/phpunit', lint: 'composer lint' };
-    if ((composer.require || {})['laravel/framework']) {
-      stack.framework = `Laravel ${((composer.require||{})['laravel/framework']||'').replace(/[\^~]/,'')}`;
-      stack.templateKey = 'laravel';
-    } else {
-      stack.framework = 'PHP';
-      stack.templateKey = 'php';
-    }
-  }
-
-  if (fs.existsSync(path.join(projectPath, 'pyproject.toml')) ||
-      fs.existsSync(path.join(projectPath, 'requirements.txt'))) {
-    stack.language = 'Python'; stack.runtime = 'Python';
-    stack.packageManager = 'pip';
-    stack.templateKey = 'python';
-    stack.commands = { install: 'pip install -r requirements.txt', dev: 'uvicorn main:app --reload', build: 'pip install -e .', test: 'pytest', lint: 'flake8' };
-    if (fs.existsSync(path.join(projectPath, 'pyproject.toml'))) {
-      const toml = fs.readFileSync(path.join(projectPath, 'pyproject.toml'), 'utf8');
-      if (toml.includes('fastapi')) { stack.framework = 'FastAPI'; }
-      else if (toml.includes('django')) { stack.framework = 'Django'; }
-      else { stack.framework = 'Python'; }
-    }
-  }
-
-  return stack;
-}
-
-// ── Detectar si el proyecto tiene contenido ─────────────────────
-function detectProjectState(projectPath) {
-  const hasCode = fs.existsSync(path.join(projectPath, 'src')) ||
-                  fs.existsSync(path.join(projectPath, 'app')) ||
-                  fs.existsSync(path.join(projectPath, 'pages')) ||
-                  fs.existsSync(path.join(projectPath, 'api'));
-  const hasKnowledge = fs.existsSync(path.join(projectPath, '.agentic', 'conocimiento')) &&
-    fs.readdirSync(path.join(projectPath, '.agentic', 'conocimiento')).filter(f => f !== 'README.md').length > 0;
-  const hasPackageFile = fs.existsSync(path.join(projectPath, 'package.json')) ||
-                         fs.existsSync(path.join(projectPath, 'composer.json')) ||
-                         fs.existsSync(path.join(projectPath, 'pyproject.toml'));
-  return { hasCode, hasKnowledge, hasPackageFile };
-}
-
 // ── Descargar desde GitHub ──────────────────────────────────────
 async function downloadFromGitHub(spinner) {
   const tmpFile = path.join(require('os').tmpdir(), 'agentic-kdd.tar.gz');
@@ -243,110 +26,127 @@ async function downloadFromGitHub(spinner) {
 
 // ── Copiar archivos al proyecto ─────────────────────────────────
 function copyAgenticFiles(sourcePath, projectPath) {
-  const files = ['CLAUDE.md', '_LOCKS.md', '.cursorrules', 'dashboard.cjs', 'docs', '.cursor', '.audit'];
-  for (const file of files) {
-    const src = path.join(sourcePath, file);
+  const rootFiles = ['CLAUDE.md', '_LOCKS.md', '.cursorrules', 'dashboard.cjs', 'docs', '.cursor', '.audit'];
+  for (const file of rootFiles) {
+    const src  = path.join(sourcePath, file);
     const dest = path.join(projectPath, file);
     if (fs.existsSync(src)) fs.copySync(src, dest, { overwrite: true });
   }
 
-  const agSrc = path.join(sourcePath, '.agentic');
+  const agSrc  = path.join(sourcePath, '.agentic');
   const agDest = path.join(projectPath, '.agentic');
 
   if (fs.existsSync(agSrc)) {
     fs.copySync(path.join(agSrc, 'agentes'), path.join(agDest, 'agentes'), { overwrite: true });
-    fs.copySync(path.join(agSrc, 'grafo'), path.join(agDest, 'grafo'), { overwrite: true });
-    fs.ensureDirSync(path.join(agDest, 'specs'));
-    fs.ensureDirSync(path.join(projectPath, '_output'));
-
-    const memorySrc = path.join(agSrc, 'memoria');
-    const memoryDest = path.join(agDest, 'memoria');
-    if (!fs.existsSync(memoryDest)) fs.copySync(memorySrc, memoryDest);
+    fs.copySync(path.join(agSrc, 'grafo'),   path.join(agDest, 'grafo'),   { overwrite: true });
+
+    const onlyCreate = ['memoria', 'specs', 'conocimiento'];
+    for (const dir of onlyCreate) {
+      const dest = path.join(agDest, dir);
+      if (!fs.existsSync(dest)) {
+        const src = path.join(agSrc, dir);
+        if (fs.existsSync(src)) fs.copySync(src, dest);
+        else fs.ensureDirSync(dest);
+      }
+    }
 
     const planDest = path.join(agDest, 'PLAN.md');
-    if (!fs.existsSync(planDest)) fs.copySync(path.join(agSrc, 'PLAN.md'), planDest);
-
-    const knSrc = path.join(agSrc, 'conocimiento', 'README.md');
-    const knDest = path.join(agDest, 'conocimiento', 'README.md');
-    fs.ensureDirSync(path.dirname(knDest));
-    if (!fs.existsSync(knDest)) fs.copySync(knSrc, knDest);
+    if (!fs.existsSync(planDest)) {
+      const planSrc = path.join(agSrc, 'PLAN.md');
+      if (fs.existsSync(planSrc)) fs.copySync(planSrc, planDest);
+    }
   }
-}
-
-// ── Escribir config.md completo y listo ────────────────────────
-function writeConfig(projectPath, data) {
-  const { name, description, isNew, stack, template } = data;
-  const tpl = template || {};
-
-  const modulosImpl = tpl.modulos_impl ? tpl.modulos_impl.join('\n') : '_El agente Setup los detecta al correr aa: configurar_';
-  const modulosPend = tpl.modulos_pend ? tpl.modulos_pend.join('\n') : '_El agente Setup los detecta al correr aa: configurar_';
-  const reglas = tpl.reglas ? tpl.reglas.join('\n') : '_Se definen durante el desarrollo._';
-
-  const config = `# Agentic KDD — Configuración del proyecto
-CONFIGURADO: SI
-VERSION: 2.0
-
----
-
-## Proyecto
-Nombre: ${name}
-Descripción: ${description}
-Tipo: ${isNew ? 'NUEVO' : 'EXISTENTE'}
-
-## Stack
-\`\`\`yaml
-frontend:
-  framework: ${stack.framework}
-  language: ${stack.language}
 
-backend:
-  runtime: ${stack.runtime || stack.language}
-  framework: ${stack.framework}
-  base_datos: ${stack.base_datos || '—'}
-
-devops:
-  package_manager: ${stack.packageManager}
-
-commands:
-  install: ${stack.commands.install}
-  dev: ${stack.commands.dev}
-  build: ${stack.commands.build}
-  test: ${stack.commands.test}
-  lint: ${stack.commands.lint}
-\`\`\`
-
-## Módulos
-
-### Implementados
-| Fase | Módulo | Rutas clave |
-|------|--------|-------------|
-${modulosImpl}
-
-### Pendientes
-${modulosPend}
-
-## Archivos compartidos críticos
-_El Setup los detecta al correr aa: configurar._
-
-## Reglas del proyecto
-
-### Agentic KDD
-- \`aa:\` → pipeline completo sin pausas ni confirmaciones entre agentes
-- \`audit:\` → solo auditar, no modificar código
-- Context Guard: validar instrucción contra config/conocimiento/código
+  fs.ensureDirSync(path.join(projectPath, '_output'));
+}
 
-### Desarrollo ${stack.framework !== '—' ? stack.framework : ''}
-${reglas}
+// ── Detectar stack ──────────────────────────────────────────────
+function detectStack(projectPath) {
+  const stack = { framework: '—', language: '—', packageManager: 'npm' };
+  if (fs.existsSync(path.join(projectPath, 'package.json'))) {
+    const pkg  = fs.readJsonSync(path.join(projectPath, 'package.json'), { throws: false }) || {};
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    stack.language = deps['typescript'] ? 'TypeScript' : 'JavaScript';
+    if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml')))      stack.packageManager = 'pnpm';
+    else if (fs.existsSync(path.join(projectPath, 'yarn.lock')))       stack.packageManager = 'yarn';
+    if (deps['next'])    stack.framework = `Next.js ${(deps['next']||'').replace(/[\^~]/,'')}`;
+    else if (deps['react'] && !deps['next']) stack.framework = 'React';
+    else if (deps['express'])  stack.framework = 'Express';
+    else if (deps['fastify'])  stack.framework = 'Fastify';
+    else if (deps['@nestjs/core']) stack.framework = 'NestJS';
+  }
+  if (fs.existsSync(path.join(projectPath, 'composer.json'))) {
+    const composer = fs.readJsonSync(path.join(projectPath, 'composer.json'), { throws: false }) || {};
+    stack.language = 'PHP'; stack.packageManager = 'composer';
+    if ((composer.require||{})['laravel/framework']) stack.framework = 'Laravel';
+    else stack.framework = 'PHP';
+  }
+  if (fs.existsSync(path.join(projectPath, 'pyproject.toml')) ||
+      fs.existsSync(path.join(projectPath, 'requirements.txt'))) {
+    stack.language = 'Python'; stack.packageManager = 'pip';
+    stack.framework = 'Python';
+  }
+  return stack;
+}
 
-## Sinónimos del proyecto
-_Sin sinónimos registrados aún._
+// ── Consolidar docs en conocimiento/ ───────────────────────────
+function consolidarDocs(projectPath) {
+  const conocimientoPath = path.join(projectPath, '.agentic', 'conocimiento');
+  const consolidados = [];
+  const ignorar = ['node_modules', '.git', '.agentic', '_output', 'dist', 'build', '.next', 'vendor'];
+
+  // Extensiones útiles como conocimiento
+  const extensionesUtiles = ['.md', '.pdf', '.txt'];
+  // Nombres específicos que siempre son útiles
+  const nombresUtiles = ['README', 'SPEC', 'SPECS', 'CONTEXT', 'CONTEXTO', 'REQUIREMENTS',
+    'ARCHITECTURE', 'DISEÑO', 'DESIGN', 'BRIEF', 'PRD', 'CLAUDE', 'AGENTS'];
+
+  function esArchivoUtil(nombre) {
+    const upper = nombre.toUpperCase().replace(/\.[^.]+$/, '');
+    const ext   = path.extname(nombre).toLowerCase();
+    if (extensionesUtiles.includes(ext)) return true;
+    if (nombresUtiles.some(n => upper.includes(n))) return true;
+    return false;
+  }
 
-## Mapa BD → módulo
-_El agente Setup lo detecta._
-`;
+  function recorrer(dir, nivel) {
+    if (nivel > 3) return; // máximo 3 niveles de profundidad
+    let items;
+    try { items = fs.readdirSync(dir); } catch(e) { return; }
+
+    for (const item of items) {
+      if (ignorar.includes(item) || item.startsWith('.')) continue;
+      const fullPath = path.join(dir, item);
+      const stat = fs.statSync(fullPath);
+
+      if (stat.isDirectory()) {
+        recorrer(fullPath, nivel + 1);
+      } else if (stat.isFile() && esArchivoUtil(item)) {
+        // No mover repomix — solo usarlo como referencia
+        if (item.includes('repomix')) {
+          consolidados.push({ src: fullPath, nombre: item, tipo: 'referencia' });
+          continue;
+        }
+        // No copiar si ya está en conocimiento/
+        if (fullPath.startsWith(conocimientoPath)) continue;
+
+        const destNombre = item;
+        const destPath   = path.join(conocimientoPath, destNombre);
+        // Si ya existe uno con el mismo nombre, agregar prefijo del directorio padre
+        const finalDest = fs.existsSync(destPath)
+          ? path.join(conocimientoPath, path.basename(dir) + '_' + destNombre)
+          : destPath;
+
+        try {
+          fs.copySync(fullPath, finalDest, { overwrite: false });
+          consolidados.push({ src: fullPath, nombre: destNombre, tipo: 'copiado' });
+        } catch(e) {}
+      }
+    }
+  }
 
-  fs.ensureDirSync(path.join(projectPath, '.agentic'));
-  fs.writeFileSync(path.join(projectPath, '.agentic', 'config.md'), config, 'utf8');
+  recorrer(projectPath, 0);
+  return consolidados;
 }
 
 // ── Comando principal: akdd init ────────────────────────────────
@@ -357,46 +157,32 @@ async function init() {
   console.log(chalk.gray('  github.com/Adrianlpz211/Agentic-KDD\n'));
 
   // Verificar si ya está instalado
-  const alreadyInstalled = fs.existsSync(path.join(projectPath, '.agentic', 'config.md'));
-  if (alreadyInstalled) {
-    const content = fs.readFileSync(path.join(projectPath, '.agentic', 'config.md'), 'utf8');
-    if (content.includes('CONFIGURADO: SI')) {
-      const { confirm } = await inquirer.prompt([{
-        type: 'confirm', name: 'confirm',
-        message: chalk.yellow('Agentic KDD ya está instalado. ¿Reinstalar?'),
-        default: false
-      }]);
-      if (!confirm) {
-        console.log(chalk.gray('\n  Usa akdd update para actualizar los agentes sin perder tu memoria.\n'));
-        return;
-      }
-    }
+  if (fs.existsSync(path.join(projectPath, '.agentic', 'agentes'))) {
+    console.log(chalk.yellow('  Agentic KDD ya está instalado en este proyecto.'));
+    console.log(chalk.gray('  Para actualizar los agentes sin perder tu memoria: akdd update\n'));
+    return;
   }
 
-  // Detectar estado y stack automáticamente
-  const state = detectProjectState(projectPath);
+  // Detectar stack
   const stack = detectStack(projectPath);
+  const hasCode = fs.existsSync(path.join(projectPath, 'src')) ||
+                  fs.existsSync(path.join(projectPath, 'app')) ||
+                  fs.existsSync(path.join(projectPath, 'pages'));
 
-  // Mostrar lo que detectó
-  if (stack.framework !== '—') {
+  if (stack.framework !== '—')
     console.log(chalk.green(`  ✓ Stack detectado: ${stack.framework} · ${stack.language} · ${stack.packageManager}`));
-  }
-  if (state.hasCode) {
+  if (hasCode)
     console.log(chalk.green('  ✓ Código existente detectado'));
-  }
-  if (state.hasKnowledge) {
-    console.log(chalk.green('  ✓ Documentación encontrada en conocimiento/'));
-  }
   console.log('');
 
-  // ── PREGUNTA 1 — Nombre ─────────────────────────────────────────
+  // ── PREGUNTA 1: Nombre ──────────────────────────────────────
   const { name } = await inquirer.prompt([{
     type: 'input', name: 'name',
     message: 'Nombre del proyecto:',
     default: path.basename(projectPath)
   }]);
 
-  // ── PREGUNTA 2 — Nuevo o existente ──────────────────────────────
+  // ── PREGUNTA 2: Nuevo o existente ──────────────────────────
   const { isNew } = await inquirer.prompt([{
     type: 'list', name: 'isNew',
     message: '¿El proyecto es nuevo o ya tiene código?',
@@ -404,86 +190,79 @@ async function init() {
       { name: 'Nuevo — empezando desde cero', value: true },
       { name: 'Existente — ya tiene código o avance', value: false }
     ],
-    default: !state.hasCode
+    default: !hasCode
   }]);
 
-  // ── PREGUNTA 3 — Descripción (solo proyectos nuevos sin docs) ──
-  let description = '—';
-  if (isNew && !state.hasKnowledge) {
-    const { desc } = await inquirer.prompt([{
-      type: 'input', name: 'desc',
-      message: 'Describe brevemente qué hace el proyecto:',
-      validate: (v) => v.trim().length > 5 || 'Al menos 5 caracteres'
-    }]);
-    description = desc;
-  } else if (!isNew && state.hasCode) {
-    description = 'Proyecto existente — el agente Setup detectará módulos y describirá el proyecto al correr aa: configurar';
-  } else if (state.hasKnowledge) {
-    description = 'El agente Setup leerá conocimiento/ y generará la descripción';
-  }
-
-  // ── DOCUMENTACIÓN ──────────────────────────────────────────────
-  if (!state.hasKnowledge) {
-    const { hasDocs } = await inquirer.prompt([{
-      type: 'confirm', name: 'hasDocs',
-      message: '¿Tienes specs, wireframes o documentación del proyecto?',
-      default: false
-    }]);
-    if (hasDocs) {
-      console.log('\n' + chalk.cyan('  Sube tus archivos a:'));
-      console.log(chalk.bold('  .agentic/conocimiento/'));
-      console.log(chalk.gray('  (PDFs, Markdown, specs, wireframes — cualquier formato)\n'));
-      await inquirer.prompt([{ type: 'input', name: 'ready', message: 'Presiona Enter cuando hayas subido los archivos...' }]);
-    }
-  }
-
-  // ── Instalar ────────────────────────────────────────────────────
+  // ── INSTALAR — crear carpetas PRIMERO antes de preguntar docs ──
   const spinner = ora({ text: 'Descargando Agentic KDD...', color: 'magenta' }).start();
-
+  let sourcePath;
   try {
-    const sourcePath = await downloadFromGitHub(spinner);
-
+    sourcePath = await downloadFromGitHub(spinner);
     spinner.text = 'Instalando archivos...';
     copyAgenticFiles(sourcePath, projectPath);
-
-    spinner.text = 'Generando configuración...';
-    const template = stack.templateKey ? TEMPLATES[stack.templateKey] : null;
-    writeConfig(projectPath, { name, description, isNew, stack, template });
-
     fs.removeSync(TEMP_DIR);
-    spinner.succeed(chalk.green('¡Agentic KDD instalado!'));
-
-    // Resumen de lo instalado
-    console.log('\n' + chalk.bold('  Instalado:'));
-    console.log(chalk.gray('  .agentic/        — pipeline de agentes + memoria KDD'));
-    console.log(chalk.gray('  .audit/          — departamento QA (7 subagentes)'));
-    console.log(chalk.gray('  dashboard.cjs    — dashboard visual'));
-    console.log(chalk.gray('  CLAUDE.md        — activación aa: / ag: / audit:'));
-    console.log(chalk.gray('  .cursorrules     — reglas para Cursor'));
-    if (template) {
-      console.log(chalk.green(`\n  Plantilla aplicada: ${stack.framework}`));
-    }
-
-    console.log('\n' + chalk.bold('  Siguiente paso:\n'));
-    if (!isNew && state.hasCode) {
-      console.log('  ' + chalk.hex('#a78bfa')('aa: configurar') + chalk.gray('   ← el Setup leerá el código y configurará todo'));
-    } else {
-      console.log('  ' + chalk.hex('#a78bfa')('aa: configurar') + chalk.gray('   ← termina la configuración'));
-    }
-    console.log('  ' + chalk.hex('#10b981')('aa: [tu tarea]') + chalk.gray('  ← cuando esté listo, a construir'));
-    console.log('  ' + chalk.hex('#06b6d4')('node dashboard.cjs') + chalk.gray(' ← abrir dashboard visual\n'));
-
-    if (stack.templateKey === null) {
-      console.log(chalk.yellow('  💡 Stack no detectado automáticamente. Edita .agentic/config.md'));
-      console.log(chalk.yellow('     con tu stack y luego corre aa: configurar\n'));
-    }
-
+    spinner.succeed(chalk.green('Archivos instalados'));
   } catch (err) {
     spinner.fail(chalk.red('Error en la instalación'));
-    console.error(chalk.red('\n  ' + err.message));
-    console.log(chalk.gray('  Descarga manual: https://github.com/Adrianlpz211/Agentic-KDD\n'));
+    console.error(chalk.red('\n  ' + err.message + '\n'));
     process.exit(1);
   }
+
+  // ── PREGUNTA 3: Docs (DESPUÉS de crear carpetas) ───────────
+  const { hasDocs } = await inquirer.prompt([{
+    type: 'confirm', name: 'hasDocs',
+    message: '¿Tienes specs, wireframes o documentación del proyecto?',
+    default: false
+  }]);
+
+  if (hasDocs) {
+    // Recorrer el proyecto y consolidar docs automáticamente
+    console.log('');
+    const docsSpinner = ora({ text: 'Buscando archivos de conocimiento...', color: 'cyan' }).start();
+    const consolidados = consolidarDocs(projectPath);
+    const copiados    = consolidados.filter(d => d.tipo === 'copiado');
+    const referencias = consolidados.filter(d => d.tipo === 'referencia');
+
+    if (copiados.length > 0) {
+      docsSpinner.succeed(chalk.green(`Archivos de conocimiento centralizados en .agentic/conocimiento/`));
+      copiados.forEach(d => console.log(chalk.gray(`    ✓ ${d.nombre}`)));
+      if (referencias.length > 0) {
+        console.log(chalk.gray(`\n  Como referencia (no movido):`));
+        referencias.forEach(d => console.log(chalk.gray(`    ~ ${d.nombre}`)));
+      }
+    } else {
+      docsSpinner.warn(chalk.yellow('No se encontraron archivos de conocimiento en el proyecto.'));
+      console.log(chalk.gray('  Puedes agregarlos manualmente en .agentic/conocimiento/'));
+    }
+  } else {
+    console.log('');
+    console.log(chalk.gray('  Tip: puedes agregar specs, docs o wireframes en'));
+    console.log(chalk.gray('  .agentic/conocimiento/ en cualquier momento.'));
+    console.log(chalk.gray('  Agentic los usará automáticamente en el siguiente aa:'));
+  }
+
+  // ── RESUMEN FINAL ───────────────────────────────────────────
+  console.log('\n' + chalk.bold('  Instalado:'));
+  console.log(chalk.gray('  .agentic/agentes/      — pipeline de 9 agentes'));
+  console.log(chalk.gray('  .agentic/grafo/        — motor SQLite de conocimiento'));
+  console.log(chalk.gray('  .agentic/memoria/      — errores, patrones, decisiones'));
+  console.log(chalk.gray('  .agentic/conocimiento/ — documentación del proyecto'));
+  console.log(chalk.gray('  .agentic/specs/        — specs auto-generadas'));
+  console.log(chalk.gray('  .audit/                — departamento QA (7 subagentes)'));
+  console.log(chalk.gray('  dashboard.cjs          — dashboard visual'));
+  console.log(chalk.gray('  CLAUDE.md              — activa aa: / ag: / audit:'));
+  console.log(chalk.gray('  .cursorrules           — reglas para Cursor'));
+
+  // Instrucción final
+  console.log('\n' + chalk.dim('  ─────────────────────────────────────────────'));
+  console.log(chalk.bold('  Último paso — abre este proyecto en'));
+  console.log(chalk.bold('  Cursor o Claude Code y ejecuta:'));
+  console.log('');
+  console.log('  ' + chalk.bold.hex('#a78bfa')('aa: configurar'));
+  console.log('');
+  console.log(chalk.gray('  Esto completa la configuración leyendo tu'));
+  console.log(chalk.gray('  código real. Solo se hace una vez.'));
+  console.log(chalk.dim('  ─────────────────────────────────────────────\n'));
 }
 
 module.exports = { init };