@damenor/agent-docs 0.1.0

package/README.md

@@ -0,0 +1,115 @@
+<h1 align="center">
+  <img src="https://img.shields.io/badge/agents-docs-blueviolet?style=for-the-badge" alt="agent-docs">
+  <br>
+  @damenor/agent-docs
+</h1>
+
+<p align="center">
+  <strong>Documentación profesional para proyectos con agentes AI</strong>
+  <br>
+  <sub>CLI interactivo que genera estructura Diátaxis + ADR + AGENTS.md en segundos</sub>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/@damenor/agent-docs?style=flat-square" alt="npm version">
+  <img src="https://img.shields.io/npm/dt/@damenor/agent-docs?style=flat-square" alt="downloads">
+  <img src="https://img.shields.io/github/license/damenordev/doc-projects?style=flat-square" alt="license">
+  <img src="https://img.shields.io/node/v/@damenor/agent-docs?style=flat-square" alt="node version">
+</p>
+
+---
+
+## Quick start
+
+```bash
+npx @damenor/agent-docs
+```
+
+That's it. The wizard guides you through 7 steps and generates a complete documentation structure.
+
+## What it does
+
+```
+npx @damenor/agent-docs
+       │
+       ├── 1. Project name
+       ├── 2. Target directory
+       ├── 3. Stack detection (auto/manual/skip)
+       │      package.json · pyproject.toml · go.mod · Cargo.toml · pom.xml
+       ├── 4. Language (ES/EN)
+       ├── 5. Module selection
+       ├── 6. Git init
+       └── 7. Generate → docs/ ready to customize
+```
+
+## 9 selectable modules
+
+| Module | Generates |
+|--------|-----------|
+| Tutorials | quick-start, environment-setup, first-task |
+| Guides | deployment, troubleshooting, runbooks |
+| Reference | API, configuration, infrastructure, code-style |
+| Explanation | architecture.md |
+| Product | overview, roadmap |
+| Operations | monitoring, incidents, SLAs |
+| Design System | DESIGN.md with tokens |
+| AI Agent Skills | `.agents/` with 5 skills + 5 agents |
+| CI/CD | GitHub Actions docs-check workflow |
+
+**Plus**, every run includes the base layer: `AGENTS.md`, `CONTEXT.md`, `README.md`, ADR template, and shared config files.
+
+## Stack detection
+
+Automatically detects your tech stack from project files:
+
+| File detected | Stack |
+|---------------|-------|
+| `package.json` | Node.js (npm/pnpm/yarn/bun) |
+| `pyproject.toml` / `requirements.txt` | Python (pip/poetry) |
+| `go.mod` | Go |
+| `Cargo.toml` | Rust |
+| `pom.xml` / `build.gradle` | Java/Kotlin |
+
+Detected commands (`dev`, `build`, `test`, `lint`) are injected into templates automatically.
+
+## Output example
+
+```
+my-project/
+├── AGENTS.md              ← AI agent protocol
+├── docs/
+│   ├── CONTEXT.md         ← Domain language & glossary
+│   ├── README.md          ← Documentation index
+│   ├── tutorials/         ← Step-by-step learning
+│   ├── guides/            ← How-to guides
+│   ├── reference/         ← Technical reference
+│   ├── explanation/       ← Architecture & ADRs
+│   ├── product/           ← Overview & roadmap
+│   ├── operations/        ← Runbooks & monitoring
+│   ├── DESIGN.md          ← Design system tokens
+│   └── adr/               ← Architecture Decision Records
+├── .agents/               ← Skills & agent configs
+├── .github/workflows/     ← CI/CD for docs
+├── .editorconfig
+└── .markdownlint.json
+```
+
+## Why this exists
+
+Most projects have **no documentation structure**. When you add AI agents to the mix, they need a shared vocabulary (`CONTEXT.md`), operating rules (`AGENTS.md`), and a consistent organization system (Diátaxis).
+
+This CLI scaffolds all of that in one command, so your team and your AI agents speak the same language from day one.
+
+## Built for
+
+- **Developers** who want professional docs without starting from zero
+- **AI agents** that need structured context to work effectively
+- **Teams** that follow Diátaxis (Tutorials / How-to / Reference / Explanation)
+
+## Requirements
+
+- Node.js >= 18
+
+## License
+
+MIT — [github.com/damenordev/doc-projects](https://github.com/damenordev/doc-projects)

package/dist/index.js

@@ -0,0 +1,568 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import * as p from "@clack/prompts";
+import pc2 from "picocolors";
+import path4 from "path";
+
+// src/utils/colors.ts
+import pc from "picocolors";
+var brand = {
+  name: "@damenor/agent-docs",
+  version: "0.1.0",
+  /** Título con estilo */
+  title: (text2) => pc.bold(pc.cyan(text2)),
+  /** Texto de éxito */
+  success: (text2) => pc.bold(pc.green(text2)),
+  /** Texto de advertencia */
+  warn: (text2) => pc.bold(pc.yellow(text2)),
+  /** Texto de error */
+  error: (text2) => pc.bold(pc.red(text2)),
+  /** Texto sutil */
+  dim: (text2) => pc.dim(text2),
+  /** Texto de enlace/path */
+  path: (text2) => pc.underline(pc.cyan(text2)),
+  /** Texto destacado */
+  highlight: (text2) => pc.bold(pc.magenta(text2)),
+  /** Label de sección */
+  label: (text2) => pc.bold(pc.white(text2))
+};
+var icons = {
+  docs: "\u{1F4DA}",
+  check: "\u2705",
+  folder: "\u{1F4C1}",
+  file: "\u{1F4C4}",
+  rocket: "\u{1F680}",
+  gear: "\u2699\uFE0F",
+  search: "\u{1F50D}",
+  sparkle: "\u2728",
+  warning: "\u26A0\uFE0F",
+  bolt: "\u26A1",
+  shield: "\u{1F6E1}\uFE0F",
+  palette: "\u{1F3A8}",
+  robot: "\u{1F916}",
+  chart: "\u{1F4CA}",
+  wrench: "\u{1F527}",
+  package: "\u{1F4E6}"
+};
+
+// src/constants.ts
+var DOC_MODULES = [
+  {
+    value: "tutorials",
+    label: "Tutoriales",
+    hint: "quick-start, environment, first-task",
+    templateDir: "tutorials",
+    files: [
+      "docs/tutorials/quick-start.md",
+      "docs/tutorials/environment-setup.md",
+      "docs/tutorials/first-task.md"
+    ]
+  },
+  {
+    value: "guides",
+    label: "Gu\xEDas",
+    hint: "deployment, troubleshooting, runbooks",
+    templateDir: "guides",
+    files: [
+      "docs/guides/deployment.md",
+      "docs/guides/troubleshooting.md",
+      "docs/guides/runbooks/TEMPLATE.md"
+    ]
+  },
+  {
+    value: "reference",
+    label: "Referencia",
+    hint: "API, config, infra, code-style",
+    templateDir: "reference",
+    files: [
+      "docs/reference/api.md",
+      "docs/reference/configuration.md",
+      "docs/reference/infrastructure.md",
+      "docs/reference/code-style.md"
+    ]
+  },
+  {
+    value: "explanation",
+    label: "Explicaci\xF3n",
+    hint: "architecture",
+    templateDir: "explanation",
+    files: ["docs/explanation/architecture.md"]
+  },
+  {
+    value: "product",
+    label: "Producto",
+    hint: "overview, roadmap",
+    templateDir: "product",
+    files: ["docs/product/overview.md", "docs/roadmap.md"]
+  },
+  {
+    value: "operations",
+    label: "Operaciones",
+    hint: "monitoring, incidents, SLAs",
+    templateDir: "operations",
+    files: ["docs/operations/README.md"]
+  },
+  {
+    value: "design",
+    label: "Design System",
+    hint: "DESIGN.md con tokens",
+    templateDir: "design",
+    files: ["docs/DESIGN.md"]
+  },
+  {
+    value: "agents",
+    label: "Skills para agentes AI",
+    hint: ".agents/ con 5 skills + 5 agents",
+    templateDir: "agents",
+    files: [".agents/"]
+  },
+  {
+    value: "ci",
+    label: "CI/CD",
+    hint: "GitHub Actions docs check",
+    templateDir: "ci",
+    files: [".github/workflows/docs-check.yml"]
+  }
+];
+var LANGUAGES = [
+  { value: "es", label: "Espa\xF1ol", hint: "recomendado" },
+  { value: "en", label: "English" }
+];
+
+// src/detector.ts
+import fs from "fs";
+import path from "path";
+function detectStack(targetDir) {
+  const checks = [
+    {
+      file: "package.json",
+      detect: (content, dir) => detectNodeStack(content, dir)
+    },
+    {
+      file: "requirements.txt",
+      detect: () => ({
+        language: "Python",
+        packageManager: "pip",
+        devCommand: "python manage.py runserver",
+        testCommand: "pytest",
+        lintCommand: "ruff check ."
+      })
+    },
+    {
+      file: "pyproject.toml",
+      detect: (content) => ({
+        language: "Python",
+        framework: content.includes("django") ? "Django" : content.includes("fastapi") ? "FastAPI" : content.includes("flask") ? "Flask" : void 0,
+        packageManager: content.includes("[tool.poetry]") ? "poetry" : "pip",
+        devCommand: content.includes("django") ? "python manage.py runserver" : "uvicorn main:app --reload",
+        testCommand: "pytest",
+        lintCommand: "ruff check ."
+      })
+    },
+    {
+      file: "go.mod",
+      detect: () => ({
+        language: "Go",
+        packageManager: "go modules",
+        devCommand: "go run .",
+        testCommand: "go test ./...",
+        lintCommand: "golangci-lint run"
+      })
+    },
+    {
+      file: "Cargo.toml",
+      detect: () => ({
+        language: "Rust",
+        packageManager: "cargo",
+        devCommand: "cargo run",
+        buildCommand: "cargo build --release",
+        testCommand: "cargo test",
+        lintCommand: "cargo clippy"
+      })
+    },
+    {
+      file: "pom.xml",
+      detect: () => ({
+        language: "Java",
+        framework: "Spring Boot",
+        packageManager: "maven",
+        devCommand: "mvn spring-boot:run",
+        buildCommand: "mvn package",
+        testCommand: "mvn test",
+        lintCommand: "mvn checkstyle:check"
+      })
+    },
+    {
+      file: "build.gradle",
+      detect: () => ({
+        language: "Java/Kotlin",
+        framework: "Spring Boot",
+        packageManager: "gradle",
+        devCommand: "gradle bootRun",
+        buildCommand: "gradle build",
+        testCommand: "gradle test"
+      })
+    }
+  ];
+  for (const check of checks) {
+    const filePath = path.join(targetDir, check.file);
+    if (fs.existsSync(filePath)) {
+      const content = fs.readFileSync(filePath, "utf-8");
+      return check.detect(content, targetDir);
+    }
+  }
+  return null;
+}
+function detectNodeStack(packageJsonContent, dir) {
+  const pkg = JSON.parse(packageJsonContent);
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  let framework;
+  if (deps["next"]) framework = `Next.js ${deps["next"].replace("^", "").replace("~", "")}`;
+  else if (deps["nuxt"]) framework = `Nuxt ${deps["nuxt"].replace("^", "").replace("~", "")}`;
+  else if (deps["astro"]) framework = `Astro ${deps["astro"].replace("^", "").replace("~", "")}`;
+  else if (deps["svelte"] || deps["@sveltejs/kit"]) framework = "SvelteKit";
+  else if (deps["react"]) framework = `React ${deps["react"].replace("^", "").replace("~", "")}`;
+  else if (deps["vue"]) framework = `Vue ${deps["vue"].replace("^", "").replace("~", "")}`;
+  else if (deps["express"]) framework = "Express";
+  else if (deps["fastify"]) framework = "Fastify";
+  else if (deps["hono"]) framework = "Hono";
+  else if (deps["@nestjs/core"]) framework = "NestJS";
+  let packageManager = "npm";
+  if (fs.existsSync(path.join(dir, "pnpm-lock.yaml"))) packageManager = "pnpm";
+  else if (fs.existsSync(path.join(dir, "yarn.lock"))) packageManager = "yarn";
+  else if (fs.existsSync(path.join(dir, "bun.lockb"))) packageManager = "bun";
+  const scripts = pkg.scripts || {};
+  const run = packageManager === "npm" ? "npm run" : packageManager;
+  const hasTypeScript = deps["typescript"] || fs.existsSync(path.join(dir, "tsconfig.json"));
+  return {
+    language: hasTypeScript ? "TypeScript" : "JavaScript",
+    framework,
+    packageManager,
+    devCommand: scripts.dev ? `${run} dev` : void 0,
+    buildCommand: scripts.build ? `${run} build` : void 0,
+    testCommand: scripts.test ? `${run} test` : void 0,
+    lintCommand: scripts.lint ? `${run} lint` : void 0
+  };
+}
+function formatStack(stack) {
+  const parts = [stack.language];
+  if (stack.framework) parts.push(stack.framework);
+  if (stack.packageManager) parts.push(`(${stack.packageManager})`);
+  return parts.join(" + ");
+}
+
+// src/generator.ts
+import path3 from "path";
+import { fileURLToPath } from "url";
+
+// src/utils/fs.ts
+import fs2 from "fs";
+import path2 from "path";
+function ensureDir(dirPath) {
+  if (!fs2.existsSync(dirPath)) {
+    fs2.mkdirSync(dirPath, { recursive: true });
+  }
+}
+function writeFile(filePath, content) {
+  ensureDir(path2.dirname(filePath));
+  fs2.writeFileSync(filePath, content, "utf-8");
+}
+function isDirEmpty(dirPath) {
+  if (!fs2.existsSync(dirPath)) return true;
+  const files = fs2.readdirSync(dirPath);
+  return files.length === 0 || files.length === 1 && files[0] === ".git";
+}
+function copyTemplateDir(src, dest, replacements) {
+  ensureDir(dest);
+  const entries = fs2.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path2.join(src, entry.name);
+    const destPath = path2.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyTemplateDir(srcPath, destPath, replacements);
+    } else {
+      let content = fs2.readFileSync(srcPath, "utf-8");
+      if (isTextFile(entry.name)) {
+        for (const [placeholder, value] of Object.entries(replacements)) {
+          content = content.replaceAll(placeholder, value);
+        }
+      }
+      writeFile(destPath, content);
+    }
+  }
+}
+function isTextFile(filename) {
+  const textExtensions = [".md", ".yml", ".yaml", ".json", ".txt", ".editorconfig"];
+  return textExtensions.some((ext) => filename.endsWith(ext)) || filename.startsWith(".");
+}
+
+// src/generator.ts
+var __dirname = path3.dirname(fileURLToPath(import.meta.url));
+async function generate(options) {
+  const { projectName, targetDir, stack, modules, language } = options;
+  const createdFiles = [];
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const replacements = {
+    "{{PROJECT_NAME}}": projectName,
+    "{{TECH_STACK}}": stack ? formatStackForTemplate(stack) : "[TECNOLOG\xCDA PRINCIPAL]",
+    "{{DEV_COMMAND}}": stack?.devCommand || "[comando de dev]",
+    "{{BUILD_COMMAND}}": stack?.buildCommand || "[comando de build]",
+    "{{TEST_COMMAND}}": stack?.testCommand || "[comando de test]",
+    "{{LINT_COMMAND}}": stack?.lintCommand || "[comando de lint]",
+    "{{LANGUAGE}}": stack?.language || "[lenguaje]",
+    "{{FRAMEWORK}}": stack?.framework || "[framework]",
+    "{{PACKAGE_MANAGER}}": stack?.packageManager || "[package manager]",
+    "{{DATE}}": today,
+    // Mantener los placeholders originales para compatibilidad
+    "[NOMBRE DEL PROYECTO]": projectName
+  };
+  const templatesDir = await resolveTemplatesDir();
+  const baseDir = path3.join(templatesDir, "base");
+  copyTemplateDir(baseDir, targetDir, replacements);
+  createdFiles.push(...await listGeneratedFiles(baseDir, targetDir));
+  for (const moduleName of modules) {
+    const moduleDir = path3.join(templatesDir, "modules", moduleName);
+    copyTemplateDir(moduleDir, targetDir, replacements);
+    createdFiles.push(...await listGeneratedFiles(moduleDir, targetDir));
+  }
+  const sharedDir = path3.join(templatesDir, "shared");
+  copyTemplateDir(sharedDir, targetDir, replacements);
+  createdFiles.push(...await listGeneratedFiles(sharedDir, targetDir));
+  if (options.initGit) {
+    await initGit(targetDir);
+  }
+  return createdFiles;
+}
+async function resolveTemplatesDir() {
+  const prodPath = path3.resolve(__dirname, "..", "templates");
+  const devPath = path3.resolve(__dirname, "..", "..", "templates");
+  const { existsSync } = await import("fs");
+  if (existsSync(prodPath)) return prodPath;
+  if (existsSync(devPath)) return devPath;
+  throw new Error("No se encontr\xF3 el directorio de templates. \xBFSe instal\xF3 correctamente el paquete?");
+}
+async function listGeneratedFiles(templateDir, targetDir) {
+  const { readdirSync } = await import("fs");
+  const files = [];
+  function walk(dir, base) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const rel = path3.join(base, entry.name);
+      if (entry.isDirectory()) {
+        walk(path3.join(dir, entry.name), rel);
+      } else {
+        files.push(rel);
+      }
+    }
+  }
+  walk(templateDir, "");
+  return files;
+}
+async function initGit(dir) {
+  const { execSync } = await import("child_process");
+  try {
+    execSync("git init", { cwd: dir, stdio: "ignore" });
+    execSync("git add -A", { cwd: dir, stdio: "ignore" });
+    execSync('git commit -m "docs: inicializaci\xF3n de documentaci\xF3n con @damenor/agent-docs"', {
+      cwd: dir,
+      stdio: "ignore"
+    });
+  } catch {
+  }
+}
+function formatStackForTemplate(stack) {
+  const parts = [stack.language];
+  if (stack.framework) parts.push(stack.framework);
+  return parts.join(" + ");
+}
+
+// src/cli.ts
+async function cli() {
+  console.clear();
+  p.intro(
+    `${icons.docs} ${brand.title("@damenor/agent-docs")} ${pc2.dim("v0.1.0")}
+   ${pc2.dim("Documentaci\xF3n profesional para proyectos con agentes AI")}`
+  );
+  const projectName = await p.text({
+    message: `${icons.sparkle} Nombre del proyecto`,
+    placeholder: "mi-proyecto",
+    validate: (value) => {
+      if (!value.trim()) return "El nombre del proyecto es obligatorio.";
+      if (!/^[a-zA-Z0-9_-][a-zA-Z0-9_.\- ]*$/.test(value.trim())) {
+        return "Usa letras, n\xFAmeros, guiones o espacios.";
+      }
+    }
+  });
+  if (p.isCancel(projectName)) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  const targetDir = await p.text({
+    message: `${icons.folder} Directorio de destino`,
+    placeholder: "./",
+    initialValue: "./",
+    validate: (value) => {
+      if (!value.trim()) return "El directorio es obligatorio.";
+    }
+  });
+  if (p.isCancel(targetDir)) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  const resolvedDir = path4.resolve(targetDir.trim());
+  if (!isDirEmpty(resolvedDir)) {
+    const overwrite = await p.confirm({
+      message: `${icons.warning} El directorio no est\xE1 vac\xEDo. \xBFContinuar? (puede sobrescribir archivos)`,
+      initialValue: false
+    });
+    if (p.isCancel(overwrite) || !overwrite) {
+      p.cancel("Operaci\xF3n cancelada.");
+      process.exit(0);
+    }
+  }
+  const stackOption = await p.select({
+    message: `${icons.search} Stack tecnol\xF3gico`,
+    options: [
+      { value: "auto", label: "Auto-detectar", hint: "recomendado \u2014 analiza el proyecto" },
+      { value: "manual", label: "Configurar manualmente" },
+      { value: "skip", label: "Omitir", hint: "rellenar despu\xE9s" }
+    ]
+  });
+  if (p.isCancel(stackOption)) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  let stack = null;
+  if (stackOption === "auto") {
+    const s2 = p.spinner();
+    s2.start("Analizando proyecto...");
+    await new Promise((r) => setTimeout(r, 800));
+    stack = detectStack(resolvedDir);
+    if (stack) {
+      s2.stop(`${icons.check} Detectado: ${brand.highlight(formatStack(stack))}`);
+    } else {
+      s2.stop(`${icons.warning} No se detect\xF3 stack \u2014 los placeholders se rellenar\xE1n despu\xE9s`);
+    }
+  } else if (stackOption === "manual") {
+    const manualStack = await p.group(
+      {
+        language: () => p.select({
+          message: "Lenguaje principal",
+          options: [
+            { value: "TypeScript", label: "TypeScript" },
+            { value: "JavaScript", label: "JavaScript" },
+            { value: "Python", label: "Python" },
+            { value: "Go", label: "Go" },
+            { value: "Rust", label: "Rust" },
+            { value: "Java", label: "Java" },
+            { value: "Other", label: "Otro" }
+          ]
+        }),
+        framework: () => p.text({
+          message: "Framework (opcional)",
+          placeholder: "Next.js 14, Django 5, etc."
+        })
+      },
+      {
+        onCancel: () => {
+          p.cancel("Operaci\xF3n cancelada.");
+          process.exit(0);
+        }
+      }
+    );
+    stack = {
+      language: manualStack.language,
+      framework: manualStack.framework?.trim() || void 0
+    };
+  }
+  const language = await p.select({
+    message: `${icons.docs} Idioma de la documentaci\xF3n`,
+    options: LANGUAGES.map((lang) => ({
+      value: lang.value,
+      label: lang.label,
+      hint: lang.hint
+    }))
+  });
+  if (p.isCancel(language)) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  const selectedModules = await p.multiselect({
+    message: `${icons.package} M\xF3dulos a incluir ${pc2.dim("(espacio para seleccionar)")}`,
+    options: DOC_MODULES.map((mod) => ({
+      value: mod.value,
+      label: mod.label,
+      hint: mod.hint
+    })),
+    required: false
+  });
+  if (p.isCancel(selectedModules)) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  const initGit2 = await p.confirm({
+    message: `${icons.gear} \xBFInicializar repositorio git?`,
+    initialValue: true
+  });
+  if (p.isCancel(initGit2)) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  const modulesLabel = selectedModules.length > 0 ? selectedModules.join(", ") : pc2.dim("ninguno (solo archivos base)");
+  p.note(
+    [
+      `${brand.label("Proyecto")}:     ${projectName}`,
+      `${brand.label("Directorio")}:   ${brand.path(resolvedDir)}`,
+      `${brand.label("Stack")}:        ${stack ? formatStack(stack) : pc2.dim("no detectado")}`,
+      `${brand.label("Idioma")}:       ${language === "es" ? "Espa\xF1ol" : "English"}`,
+      `${brand.label("M\xF3dulos")}:      ${modulesLabel}`,
+      `${brand.label("Git")}:          ${initGit2 ? "S\xED" : "No"}`
+    ].join("\n"),
+    `${icons.chart} Resumen`
+  );
+  const confirmed = await p.confirm({
+    message: "\xBFGenerar documentaci\xF3n?",
+    initialValue: true
+  });
+  if (p.isCancel(confirmed) || !confirmed) {
+    p.cancel("Operaci\xF3n cancelada.");
+    process.exit(0);
+  }
+  const s = p.spinner();
+  s.start("Creando estructura de documentaci\xF3n...");
+  await new Promise((r) => setTimeout(r, 400));
+  s.message("Generando archivos base (AGENTS.md, CONTEXT.md, ADR...)");
+  await new Promise((r) => setTimeout(r, 500));
+  if (selectedModules.length > 0) {
+    s.message(`A\xF1adiendo m\xF3dulos: ${selectedModules.join(", ")}`);
+    await new Promise((r) => setTimeout(r, 400));
+  }
+  const createdFiles = await generate({
+    projectName: projectName.trim(),
+    targetDir: resolvedDir,
+    stack,
+    modules: selectedModules,
+    language,
+    initGit: initGit2
+  });
+  if (initGit2) {
+    s.message("Inicializando repositorio git...");
+    await new Promise((r) => setTimeout(r, 300));
+  }
+  s.stop(`${icons.check} ${brand.success(`${createdFiles.length} archivos generados`)}`);
+  const nextSteps = [
+    `${pc2.bold("1.")} Rellenar ${brand.path("docs/CONTEXT.md")} con los t\xE9rminos del dominio`,
+    `${pc2.bold("2.")} Revisar ${brand.path("AGENTS.md")} y ajustar stack/comandos`,
+    `${pc2.bold("3.")} Ejecutar ${pc2.cyan("npx @damenor/agent-docs --help")} para m\xE1s opciones`
+  ];
+  p.note(nextSteps.join("\n"), `${icons.rocket} Pr\xF3ximos pasos`);
+  p.outro(
+    `${icons.sparkle} ${brand.title("\xA1Documentaci\xF3n lista!")} ${pc2.dim("\u2014 github.com/damenordev/doc-projects")}`
+  );
+}
+
+// src/index.ts
+cli().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});