@damenor/agent-docs 0.1.1 → 0.4.0

package/dist/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import * as p from "@clack/prompts";
-import pc2 from "picocolors";
-import path4 from "path";
-import fs3 from "fs";
+import * as p2 from "@clack/prompts";
+import pc4 from "picocolors";
+import path7 from "path";
+import fs7 from "fs";
 import url from "url";
 
 // src/utils/colors.ts
@@ -55,34 +55,21 @@ var DOC_MODULES = [
     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"
-    ]
+    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"
-    ]
+    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"
-    ]
+    files: ["docs/reference/api.md", "docs/reference/configuration.md", "docs/reference/infrastructure.md", "docs/reference/code-style.md"]
   },
   {
     value: "explanation",
@@ -225,96 +212,3729 @@ function detectStack(targetDir) {
   }
   return null;
 }
-function detectNodeStack(packageJsonContent, dir) {
-  const pkg2 = JSON.parse(packageJsonContent);
-  const deps = { ...pkg2.dependencies, ...pkg2.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 = pkg2.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 detectNodeStack(packageJsonContent, dir) {
+  const pkg2 = JSON.parse(packageJsonContent);
+  const deps = { ...pkg2.dependencies, ...pkg2.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 = pkg2.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 path6 from "path";
+import { fileURLToPath } from "url";
+import fs6 from "fs";
+
+// src/conflict-resolver.ts
+import * as p from "@clack/prompts";
+import pc3 from "picocolors";
+import fs5 from "fs";
+import path5 from "path";
+
+// src/conflict-detector.ts
+import fs2 from "fs";
+import path2 from "path";
+function detectConflicts(plannedFiles, targetDir) {
+  const entries = [];
+  for (const plannedFile of plannedFiles) {
+    const targetPath = path2.join(targetDir, plannedFile.relativePath);
+    const exists = fs2.existsSync(targetPath);
+    const status = exists ? "conflict" : "no-conflict";
+    entries.push({
+      plannedFile,
+      status,
+      resolution: "skip",
+      result: exists ? "skipped" : "created"
+    });
+  }
+  return entries;
+}
+
+// src/merge-agents.ts
+var HEADING_RE = /^## (.+)$/gm;
+function parseSections(content) {
+  const sections = [];
+  let preamble = "";
+  let match;
+  HEADING_RE.lastIndex = 0;
+  const headingMatches = [];
+  while ((match = HEADING_RE.exec(content)) !== null) {
+    headingMatches.push({ index: match.index, heading: match[1] });
+  }
+  if (headingMatches.length === 0) {
+    return { preamble: content, sections: [] };
+  }
+  preamble = content.slice(0, headingMatches[0].index).trimEnd();
+  for (let i = 0; i < headingMatches.length; i++) {
+    const current = headingMatches[i];
+    const next = headingMatches[i + 1];
+    const sectionContent = next ? content.slice(current.index, next.index) : content.slice(current.index);
+    sections.push({
+      heading: current.heading,
+      content: sectionContent.trimEnd()
+    });
+  }
+  return { preamble, sections };
+}
+function mergeAgentsMd(existingContent, templateContent) {
+  const existing = parseSections(existingContent);
+  const template = parseSections(templateContent);
+  const existingHeadings = new Set(existing.sections.map((s) => s.heading));
+  const resultParts = [existing.preamble, ""];
+  for (const section of existing.sections) {
+    resultParts.push(section.content);
+  }
+  for (const section of template.sections) {
+    if (!existingHeadings.has(section.heading)) {
+      resultParts.push(section.content);
+    }
+  }
+  return resultParts.join("\n\n").trim() + "\n";
+}
+function isAgentsMd(relativePath) {
+  return relativePath.toLowerCase().endsWith("agents.md");
+}
+
+// src/report.ts
+import pc2 from "picocolors";
+function groupByResult(entries) {
+  const groups = { created: [], overwritten: [], skipped: [], merged: [] };
+  for (const entry of entries) {
+    switch (entry.result) {
+      case "created":
+        groups.created.push(entry.plannedFile.relativePath);
+        break;
+      case "overwritten":
+        groups.overwritten.push(entry.plannedFile.relativePath);
+        break;
+      case "skipped":
+        groups.skipped.push(entry.plannedFile.relativePath);
+        break;
+      case "merged":
+        groups.merged.push(entry.plannedFile.relativePath);
+        break;
+    }
+  }
+  return groups;
+}
+function formatFileList(files, maxDisplay = 5) {
+  if (files.length === 0) return "";
+  const display = files.slice(0, maxDisplay);
+  const remaining = files.length - maxDisplay;
+  const suffix = remaining > 0 ? `, ... (+${remaining})` : "";
+  return display.join(", ") + suffix;
+}
+function printReport(entries) {
+  const groups = groupByResult(entries);
+  const rows = [];
+  const statusMap = [
+    { icon: "\u2705", label: "Created", files: groups.created, count: groups.created.length },
+    { icon: "\u{1F504}", label: "Overwritten", files: groups.overwritten, count: groups.overwritten.length },
+    { icon: "\u23ED\uFE0F", label: "Skipped", files: groups.skipped, count: groups.skipped.length },
+    { icon: "\u{1F500}", label: "Merged", files: groups.merged, count: groups.merged.length }
+  ];
+  rows.push(`
+${pc2.bold("\u{1F4CA} Report:")}
+`);
+  rows.push(`  ${pc2.dim("Status".padEnd(20))} ${pc2.dim("Count")}`);
+  rows.push(`  ${pc2.dim("\u2500".repeat(20))} ${pc2.dim("\u2500".repeat(5))}`);
+  for (const { icon, label, files, count } of statusMap) {
+    if (count > 0) {
+      const fileList = formatFileList(files);
+      rows.push(`  ${icon} ${pc2.bold(label.padEnd(14))} ${String(count).padStart(3)}   ${pc2.dim(fileList)}`);
+    }
+  }
+  console.log(rows.join("\n"));
+}
+function printSkippedWarning(entries) {
+  const skipped = entries.filter((e) => e.result === "skipped");
+  if (skipped.length === 0) return;
+  const fileList = skipped.map((e) => `   - ${e.plannedFile.relativePath}`).join("\n");
+  console.log(
+    `
+${pc2.yellow(`${icons.warning} ${pc2.bold(`${skipped.length} archivo${skipped.length > 1 ? "s" : ""} saltado${skipped.length > 1 ? "s" : ""}`)} \u2014 tu documentaci\xF3n puede estar incompleta:`)}
+${pc2.yellow(fileList)}
+
+${pc2.dim("\u{1F4A1} Ejecuta de nuevo con ")}${pc2.cyan("--force")}${pc2.dim(' para sobrescribir, o elige "overwrite" para esos archivos.')}`
+  );
+}
+function printDryRunReport(entries) {
+  const conflicts = entries.filter((e) => e.status === "conflict");
+  const clean = entries.filter((e) => e.status === "no-conflict");
+  console.log(`
+${pc2.blue("\u2139 Dry run \u2014 no files will be written")}
+`);
+  console.log(`${pc2.bold("\u{1F4CA} Would generate:")}
+`);
+  if (clean.length > 0) {
+    const fileList = formatFileList(clean.map((e) => e.plannedFile.relativePath));
+    console.log(`  \u2705 ${pc2.bold("Would create".padEnd(14))} ${String(clean.length).padStart(3)}   ${pc2.dim(fileList)}`);
+  }
+  if (conflicts.length > 0) {
+    const fileList = formatFileList(conflicts.map((e) => e.plannedFile.relativePath));
+    console.log(`  \u26A0\uFE0F  ${pc2.yellow(pc2.bold("Conflict".padEnd(14)))} ${String(conflicts.length).padStart(3)}   ${pc2.dim(fileList)}`);
+  }
+  console.log(`
+${pc2.dim("Run without --dry-run to execute.")}`);
+}
+
+// src/utils/fs.ts
+import fs3 from "fs";
+import path3 from "path";
+function ensureDir(dirPath) {
+  if (!fs3.existsSync(dirPath)) {
+    fs3.mkdirSync(dirPath, { recursive: true });
+  }
+}
+function isDirEmpty(dirPath) {
+  if (!fs3.existsSync(dirPath)) return true;
+  const files = fs3.readdirSync(dirPath);
+  return files.length === 0 || files.length === 1 && files[0] === ".git";
+}
+
+// src/conditional.ts
+import fs4 from "fs";
+import path4 from "path";
+var FRONTEND_FRAMEWORKS = ["next.js", "nuxt", "astro", "svelte", "sveltekit", "react", "vue", "angular", "solid", "qwik"];
+var BACKEND_FRAMEWORKS = [
+  "express",
+  "fastify",
+  "hono",
+  "nestjs",
+  "nest",
+  "django",
+  "fastapi",
+  "flask",
+  "gin",
+  "echo",
+  "fiber",
+  "actix",
+  "axum",
+  "rocket",
+  "spring boot"
+];
+var DB_FILE_PATTERNS = [
+  "prisma/schema.prisma",
+  "drizzle.config.ts",
+  "drizzle.config.js",
+  "typeorm.config.ts",
+  "knexfile.ts",
+  "knexfile.js",
+  "sequelize.config.js",
+  "alembic.ini",
+  "migrations"
+];
+function buildConditionContext(stack, targetDir) {
+  const lang = (stack?.language || "").toLowerCase();
+  const fw = (stack?.framework || "").toLowerCase();
+  const isNode = lang.includes("javascript") || lang.includes("typescript");
+  const isPython = lang.includes("python");
+  const isGo = lang.includes("go");
+  const isRust = lang.includes("rust");
+  const isJava = lang.includes("java") || lang.includes("kotlin");
+  const hasFrontend = FRONTEND_FRAMEWORKS.some((f) => fw.includes(f));
+  const hasBackend = BACKEND_FRAMEWORKS.some((f) => fw.includes(f));
+  const hasTypeScript = lang.includes("typescript");
+  let hasDatabase = false;
+  if (targetDir) {
+    hasDatabase = DB_FILE_PATTERNS.some((pattern) => {
+      const fullPath = path4.join(targetDir, pattern);
+      return fs4.existsSync(fullPath);
+    });
+    if (!hasDatabase && (fw.includes("django") || fw.includes("spring"))) {
+      hasDatabase = true;
+    }
+  }
+  let hasDocker = false;
+  if (targetDir) {
+    hasDocker = fs4.existsSync(path4.join(targetDir, "Dockerfile")) || fs4.existsSync(path4.join(targetDir, "docker-compose.yml")) || fs4.existsSync(path4.join(targetDir, "docker-compose.yaml"));
+  }
+  let hasCI = false;
+  if (targetDir) {
+    hasCI = fs4.existsSync(path4.join(targetDir, ".github", "workflows")) || fs4.existsSync(path4.join(targetDir, ".gitlab-ci.yml")) || fs4.existsSync(path4.join(targetDir, ".circleci"));
+  }
+  let hasMonorepo = false;
+  if (targetDir) {
+    const pkgPath = path4.join(targetDir, "package.json");
+    if (fs4.existsSync(pkgPath)) {
+      try {
+        const pkg2 = JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
+        hasMonorepo = !!(pkg2.workspaces || pkg2.pnpm?.workspaces);
+      } catch {
+      }
+    }
+    if (!hasMonorepo) {
+      hasMonorepo = fs4.existsSync(path4.join(targetDir, "packages"));
+    }
+  }
+  return {
+    hasDatabase,
+    hasFrontend,
+    hasBackend,
+    hasDocker,
+    hasCI,
+    isNode,
+    isPython,
+    isGo,
+    isRust,
+    isJava,
+    hasMonorepo,
+    hasTypeScript
+  };
+}
+function renderConditionalBlocks(content, ctx) {
+  const blockRegex = /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\s+\1\}\}/g;
+  let result = content;
+  let prevResult = "";
+  let iterations = 0;
+  const MAX_ITERATIONS = 10;
+  while (result !== prevResult && iterations < MAX_ITERATIONS) {
+    prevResult = result;
+    result = result.replace(blockRegex, (_match, condition, block) => {
+      const value = ctx[condition];
+      return value ? block : "";
+    });
+    iterations++;
+  }
+  result = result.replace(/\n{3,}/g, "\n\n");
+  return result;
+}
+
+// src/conflict-resolver.ts
+async function resolveConflicts(entries, options) {
+  const conflicts = entries.filter((e) => e.status === "conflict");
+  if (options.dryRun) {
+    printDryRunReport(entries);
+    return entries;
+  }
+  if (options.force) {
+    for (const entry of entries) {
+      if (entry.status === "conflict") {
+        entry.resolution = "overwrite";
+        entry.result = "overwritten";
+      } else {
+        entry.resolution = "skip";
+        entry.result = "created";
+      }
+    }
+    return entries;
+  }
+  if (conflicts.length === 0) {
+    for (const entry of entries) {
+      entry.resolution = "skip";
+      entry.result = "created";
+    }
+    return entries;
+  }
+  if (!isInteractive()) {
+    const skipped = conflicts.map((e) => e.plannedFile.relativePath).join(", ");
+    console.log(`${icons.warning} ${pc3.yellow(`${conflicts.length} file(s) conflict \u2014 skipping (non-interactive): ${skipped}`)}`);
+    for (const entry of entries) {
+      if (entry.status === "conflict") {
+        entry.resolution = "skip";
+        entry.result = "skipped";
+      }
+    }
+    return entries;
+  }
+  console.log(`
+${icons.warning} ${pc3.yellow(pc3.bold(`${conflicts.length} conflicting file${conflicts.length > 1 ? "s" : ""} detected:`))}
+`);
+  const MAX_DISPLAY = 10;
+  const displayedConflicts = conflicts.slice(0, MAX_DISPLAY);
+  const remaining = conflicts.length - MAX_DISPLAY;
+  for (const entry of displayedConflicts) {
+    const isAgent = isAgentsMd(entry.plannedFile.relativePath);
+    const actionHint = isAgent ? `${pc3.dim("(merge recommended)")}` : "";
+    console.log(`  ${icons.docs} ${brand.path(entry.plannedFile.relativePath)} ${actionHint}`);
+  }
+  if (remaining > 0) {
+    console.log(`  ${pc3.dim(`...and ${remaining} more`)}`);
+  }
+  console.log("");
+  const defaultAction = await p.select({
+    message: "Default action for conflicting files",
+    options: [
+      { value: "skip", label: "Skip", hint: "keep existing files (recommended)" },
+      { value: "overwrite", label: "Overwrite", hint: "replace all with template content" }
+    ]
+  });
+  if (p.isCancel(defaultAction)) {
+    p.cancel("Operation cancelled.");
+    process.exit(0);
+  }
+  let perFileOverride = false;
+  if (conflicts.length <= 10) {
+    perFileOverride = true;
+  } else {
+    const wantsOverride = await p.confirm({
+      message: `You have ${conflicts.length} conflicts. Override per file?`,
+      initialValue: false
+    });
+    if (!p.isCancel(wantsOverride)) {
+      perFileOverride = wantsOverride;
+    }
+  }
+  for (const entry of conflicts) {
+    let resolution = defaultAction;
+    if (perFileOverride) {
+      const isAgent = isAgentsMd(entry.plannedFile.relativePath);
+      const options2 = [
+        { value: "skip", label: "Skip", hint: "keep existing" },
+        { value: "overwrite", label: "Overwrite", hint: "replace" }
+      ];
+      if (isAgent) {
+        options2.push({ value: "merge", label: "Merge", hint: "add missing sections" });
+      }
+      const picked = await p.select({
+        message: `${entry.plannedFile.relativePath}`,
+        options: options2,
+        initialValue: isAgent ? "merge" : "skip"
+      });
+      if (p.isCancel(picked)) {
+        p.cancel("Operation cancelled.");
+        process.exit(0);
+      }
+      resolution = picked;
+    }
+    entry.resolution = resolution;
+  }
+  return entries;
+}
+function executePlan(entries, options) {
+  for (const entry of entries) {
+    const targetPath = path5.join(options.targetDir, entry.plannedFile.relativePath);
+    switch (entry.resolution) {
+      case "skip": {
+        if (entry.status === "no-conflict") {
+          ensureDir(path5.dirname(targetPath));
+          writeWithReplacements(targetPath, entry.plannedFile.sourcePath, entry.plannedFile.replacements, options.conditionCtx, entry.plannedFile.content);
+          entry.result = "created";
+        } else {
+          entry.result = "skipped";
+        }
+        break;
+      }
+      case "overwrite": {
+        ensureDir(path5.dirname(targetPath));
+        writeWithReplacements(targetPath, entry.plannedFile.sourcePath, entry.plannedFile.replacements, options.conditionCtx, entry.plannedFile.content);
+        entry.result = entry.status === "conflict" ? "overwritten" : "created";
+        break;
+      }
+      case "merge": {
+        const existingContent = fs5.readFileSync(targetPath, "utf-8");
+        let templateContent = fs5.readFileSync(entry.plannedFile.sourcePath, "utf-8");
+        if (options.conditionCtx) {
+          templateContent = renderConditionalBlocks(templateContent, options.conditionCtx);
+        }
+        const merged = mergeAgentsMd(existingContent, templateContent);
+        let finalContent = merged;
+        for (const [key, value] of Object.entries(entry.plannedFile.replacements)) {
+          finalContent = finalContent.replaceAll(key, value);
+        }
+        fs5.writeFileSync(targetPath, finalContent, "utf-8");
+        entry.result = "merged";
+        break;
+      }
+    }
+  }
+  return entries;
+}
+function writeWithReplacements(targetPath, sourcePath, replacements, conditionCtx, inlineContent) {
+  let content;
+  if (inlineContent !== void 0) {
+    content = inlineContent;
+  } else {
+    content = fs5.readFileSync(sourcePath, "utf-8");
+    if (conditionCtx) {
+      content = renderConditionalBlocks(content, conditionCtx);
+    }
+  }
+  for (const [key, value] of Object.entries(replacements)) {
+    content = content.replaceAll(key, value);
+  }
+  fs5.writeFileSync(targetPath, content, "utf-8");
+}
+function isInteractive() {
+  if (process.env.CI === "true" || process.env.CI === "1") return false;
+  if (process.env.NODE_ENV === "test") return false;
+  return process.stdout.isTTY === true;
+}
+async function processConflicts(plannedFiles, options) {
+  const entries = detectConflicts(plannedFiles, options.targetDir);
+  const resolved = await resolveConflicts(entries, options);
+  if (options.dryRun) {
+    return [];
+  }
+  const results = executePlan(resolved, {
+    targetDir: options.targetDir,
+    conditionCtx: options.conditionCtx
+  });
+  printReport(results);
+  printSkippedWarning(results);
+  return results.filter((e) => e.result === "created" || e.result === "overwritten" || e.result === "merged").map((e) => e.plannedFile.relativePath);
+}
+
+// src/generators/i18n.ts
+var registry = {};
+function registerLabels(template, language, labels31) {
+  if (!registry[template]) {
+    registry[template] = {};
+  }
+  registry[template][language] = labels31;
+}
+function loadLabels(template, language) {
+  const langLabels = registry[template]?.[language];
+  if (langLabels) return langLabels;
+  const esLabels = registry[template]?.["es"];
+  if (esLabels) return esLabels;
+  return {};
+}
+
+// src/generators/agents/labels/es.ts
+var labels = {
+  // ── Frontmatter ──
+  fmType: "agent-protocol",
+  fmTags: "agents, protocolo, operativo, ia",
+  // ── Título ──
+  title: "AGENTS.md \u2014 Protocolo Operativo",
+  subtitle: "Reglas que TODO agente de IA debe seguir al trabajar en este proyecto. Gu\xEDa extendida: `docs/internal/agent-guide.md`.",
+  // ── STOP ──
+  stopTitle: "STOP \u2014 Lee esto ANTES de hacer nada",
+  stop1: "**TRIAGE**: Clasifica la tarea (SMALL/MEDIUM/LARGE). No saltes este paso.",
+  stop2: "**LEE**: Lee la documentaci\xF3n indicada en la tabla ANTES de escribir c\xF3digo.",
+  stop3: "**PREGUNTA**: Si hay ambig\xFCedad, haz TODAS las preguntas en UN solo mensaje.",
+  stop4: "**NO IMPLEMENTES** sin seguir el protocolo completo (MEDIUM/LARGE).",
+  stop5: "**@reviewer**: Invoca ANTES de marcar la tarea como completada (MEDIUM/LARGE).",
+  // ── Triage ──
+  triageTitle: "Triage de tarea",
+  triageIntro: "Antes de ejecutar el protocolo, clasificar la tarea:",
+  triageSizeHeader: "Tama\xF1o",
+  triageCriteriaHeader: "Criterio",
+  triageProtocolHeader: "Protocolo",
+  triageSmall: "**SMALL**",
+  triageSmallCriteria: "\u22642 archivos, <50 l\xEDneas",
+  triageSmallProtocol: "Leer CONTEXT.md \u2192 implementar \u2192 lint \u2192 done",
+  triageMedium: "**MEDIUM**",
+  triageMediumCriteria: "3-10 archivos, feature moderada",
+  triageMediumProtocol: "Protocolo completo (sin subdelegaci\xF3n)",
+  triageLarge: "**LARGE**",
+  triageLargeCriteria: "Multi-d\xEDa, arquitectural",
+  triageLargeProtocol: "Protocolo completo + ADR + subdelegaci\xF3n",
+  triageExamples: "**Ejemplos**: SMALL = fix typo, cambiar color, corregir import. MEDIUM = nuevo endpoint, nuevo componente, nuevo servicio simple. LARGE = sistema de auth, integraci\xF3n con provider externo, sistema de notificaciones multi-canal.",
+  triageEscalate: "Si empiezas SMALL y la tarea crece \u2192 escalar a MEDIUM.",
+  // ── Stack ──
+  stackTitle: "Stack y convenciones",
+  stackSectionTitle: "Stack",
+  stackFrontend: "**Frontend**",
+  stackBackend: "**Backend**",
+  stackDatabase: "**Base de datos**",
+  stackCICD: "**CI/CD**",
+  stackPlaceholder: "[framework y versi\xF3n \u2014 ej.",
+  stackDbPlaceholder: "[tipo y versi\xF3n \u2014 ej.",
+  stackCIPlaceholder: "[plataforma \u2014 ej.",
+  stackAutoDetectTitle: "Detecci\xF3n autom\xE1tica de stack",
+  stackAutoDetectDesc: "Si el stack no est\xE1 rellenado arriba, el agente debe detectarlo:",
+  stackFileHeader: "Archivo detectado",
+  stackEcosystemHeader: "Ecosistema",
+  stackCommandsHeader: "Comandos probables",
+  // ── Convenciones ──
+  conventionsTitle: "Convenios obligatorios",
+  convLang: "**Idioma**: C\xF3digo en **ingl\xE9s**. Comentarios y docs en **espa\xF1ol**.",
+  convNaming: "**Nombramiento**: [convenci\xF3n de nombres \u2014 ej. camelCase variables/funciones, PascalCase componentes]",
+  convStructure: "**Estructura**: [convenci\xF3n \u2014 ej. feature-based folders]",
+  convTesting: "**Testing**: Todo c\xF3digo nuevo DEBE incluir tests.",
+  convLinting: "**Linting**: Pasar `npm run lint` sin errores antes de completar.",
+  convCommits: "**Commits**: Conventional Commits en espa\xF1ol: `tipo(alcance): descripci\xF3n`.",
+  convSecurity: "**Seguridad**: Nunca commitear secrets. Usar variables de entorno.",
+  convDeps: "**Dependencias**: No a\xF1adir sin justificaci\xF3n. Si se a\xF1ade \u2192 documentar en ADR.",
+  convA11y: "**Accesibilidad**: Todo componente UI cumple WCAG 2.1 AA.",
+  // ── Comandos ──
+  commandsTitle: "Comandos",
+  commandsHeaderCmd: "Comando",
+  commandsHeaderUsage: "Uso",
+  cmdDev: "Desarrollo con hot-reload",
+  cmdBuild: "Build producci\xF3n",
+  cmdTest: "Tests unitarios e integraci\xF3n",
+  cmdTestE2E: "Tests end-to-end",
+  cmdLint: "Linter (debe pasar sin errores)",
+  cmdTypecheck: "Verificaci\xF3n de tipos",
+  commandsDetail: "> **Detalle completo** de convenciones de git, commits, PRs y testing en [`docs/dev-workflow.md`](docs/dev-workflow.md).",
+  // ── ANTES ──
+  beforeTitle: "ANTES de cada tarea (MEDIUM/LARGE)",
+  before1Title: "1. Leer docs seg\xFAn tipo de tarea",
+  beforeTaskTypeHeader: "Tipo de tarea",
+  beforeDocHeader: "Documentaci\xF3n a leer primero",
+  beforeAny: "Cualquier tarea",
+  beforeFeature: "Feature nueva",
+  beforeBug: "Bug/UI/Estilo",
+  beforeAPI: "API/Backend",
+  beforeDeploy: "Deploy/Infra",
+  beforeArch: "Arquitectura",
+  before2Title: "2. Verificar ADRs existentes",
+  before2Desc: "Buscar en `docs/adr/` antes de tomar decisiones:",
+  before2Accept: "**Existe ADR aceptado** \u2192 SEGUIRLO. No reinventar.",
+  before2Contradict: "**Contradice lo que vas a hacer** \u2192 Plantear discusi\xF3n antes.",
+  before2None: "**No existe** \u2192 Evaluar si merece ADR (ver criterio y ejemplos en [`docs/adr/TEMPLATE.md`](docs/adr/TEMPLATE.md)).",
+  before3Title: "3. Verificar CONTEXT.md",
+  before3Desc: "Si la tarea usa t\xE9rminos que no est\xE1n en `docs/CONTEXT.md` \u2192 preparar para actualizar al terminar.",
+  before3Completeness: "Si `CONTEXT.md` tiene `completeness < 50%` \u2192 prioridad: completar CONTEXT.md antes de implementar features.",
+  before4Title: "4. Preguntar si hay ambig\xFCedad",
+  before4Desc: "Si despu\xE9s de leer la documentaci\xF3n hay ambig\xFCedad \u2192 **batch TODAS las preguntas en un solo mensaje**. Cada pregunta con opciones cuando sea posible. No preguntar una por una.",
+  before4DontAsk: "No preguntes si la tarea est\xE1 clara, es implementaci\xF3n est\xE1ndar, o la info est\xE1 en los docs.",
+  // ── DESPUÉS ──
+  afterTitle: "DESPU\xC9S de cada tarea (MEDIUM/LARGE)",
+  afterTreeTitle: "\xC1rbol post-tarea",
+  afterTreeNode1: "\xBFTomaste una decisi\xF3n?",
+  afterTreeNode1a: "Arquitect\xF3nica \u2192 docs/adr/ (ADR formal)",
+  afterTreeNode1b: "Implementaci\xF3n no obvia \u2192 JSDoc + docs/adr/ai-decisions.md",
+  afterTreeNode1c: "No \u2192 siguiente",
+  afterTreeNode2: "\xBFT\xE9rminos nuevos del dominio? \u2192 docs/CONTEXT.md",
+  afterTreeNode3: "\xBFEndpoints cambiados? \u2192 docs/reference/api.md",
+  afterTreeNode4: "\xBFUI/UX cambiada? \u2192 docs/DESIGN.md",
+  afterTreeNode5: "\xBFDeploy a producci\xF3n? \u2192 CHANGELOG.md + docs/guides/deployment.md",
+  afterTreeNode6: "\xBFFeature completado? \u2192 docs/roadmap.md",
+  afterTreeNode7: "\xBFGotcha descubierto? \u2192 docs/guides/troubleshooting.md",
+  afterTreeNode8: "\xBFRefactor de patrones? \u2192 Revisar architecture.md y ADRs",
+  afterGuide: "> **Gu\xEDa extendida** con diagramas y ejemplos en [`docs/internal/agent-guide.md`](docs/internal/agent-guide.md).",
+  afterSkill: "> **Alternativa**: Invocar skill `doc-maintain` para detectar cambios y sugerir actualizaciones autom\xE1ticamente.",
+  afterGoldenRule: "**Regla de oro**: Si cambias el c\xF3digo, cambias la documentaci\xF3n.",
+  // ── Quality Gate ──
+  qgTitle: "Quality Gate \u2014 @reviewer (MEDIUM/LARGE)",
+  qgIntro: "**ANTES de completar**, invocar `@reviewer` para verificar:",
+  qgItem1: "\u2705 Code style conforme a convenciones",
+  qgItem2: "\u2705 Sin duplicaci\xF3n \u2014 usa componentes/utilidades existentes",
+  qgItem3: "\u2705 Sigue la arquitectura del proyecto y respeta ADRs",
+  qgItem4: "\u2705 Sin vulnerabilidades de seguridad",
+  qgItem5: "\u2705 Tests incluidos para c\xF3digo nuevo",
+  qgItem6: "\u2705 Documentaci\xF3n actualizada",
+  qgItem7: "\u2705 Sin problemas de performance evidentes",
+  qgBlocking: "**\u274C BLOQUEANTE** \u2192 arreglar antes de completar.",
+  qgSuggested: "**\u26A0\uFE0F SUGERIDO** \u2192 recomendado pero no bloquea.",
+  // ── Subdelegación ──
+  subdelTitle: "Subdelegaci\xF3n",
+  subdelIntro: "Instrucciones m\xEDnimas al subagente:",
+  subdelExample: "> Lee AGENTS.md y sigue el protocolo completo. Tarea: [descripci\xF3n]. Docs relevantes: [lista].",
+  subdelNote: "No repitas convenciones \u2014 ya est\xE1n en AGENTS.md. Ver ejemplo completo en `docs/internal/agent-guide.md`.",
+  // ── Skills ──
+  skillsTitle: "Skills y agentes disponibles",
+  skillsList: "**Skills**: `doc-scaffold`, `doc-write`, `doc-design`, `doc-review`, `doc-maintain` \u2014 ver `.agents/skills/`",
+  agentsList: "**Agentes**: `@reviewer` (quality gate), `@doc-writer`, `@doc-reviewer`, `@doc-designer`, `@doc-maintainer` \u2014 ver `.agents/agents/`",
+  skillsGuide: "**Gu\xEDa extendida**: `docs/internal/agent-guide.md`",
+  // ── Tabla de detección de stack ──
+  stackRowPackage: "`package.json`",
+  stackRowNodeEco: "Node.js (npm/pnpm/yarn)",
+  stackRowNodeCmds: "`npm run dev`, `npm run build`",
+  stackRowPyReq: "`requirements.txt` / `pyproject.toml`",
+  stackRowPyEco: "Python (pip/poetry)",
+  stackRowPyCmds: "`python manage.py runserver`, `pytest`",
+  stackRowGo: "`go.mod`",
+  stackRowGoEco: "Go",
+  stackRowGoCmds: "`go run .`, `go test ./...`",
+  stackRowRust: "`Cargo.toml`",
+  stackRowRustEco: "Rust",
+  stackRowRustCmds: "`cargo run`, `cargo test`",
+  stackRowJava: "`pom.xml` / `build.gradle`",
+  stackRowJavaEco: "Java/Kotlin",
+  stackRowJavaCmds: "`mvn spring-boot:run`, `gradle bootRun`",
+  // ── Tabla de docs (ANTES) ──
+  beforeDocAny: "`docs/CONTEXT.md`",
+  beforeDocFeature: "`docs/roadmap.md`, `docs/explanation/architecture.md`, ADRs relevantes",
+  beforeDocBug: "`docs/DESIGN.md`, `docs/CONTEXT.md`",
+  beforeDocApi: "`docs/reference/api.md`, `docs/reference/configuration.md`",
+  beforeDocDeploy: "`docs/guides/deployment.md`, `docs/reference/infrastructure.md`",
+  beforeDocArch: "`docs/explanation/architecture.md`, `docs/adr/` (todos)",
+  // ── Comandos (valores) ──
+  cmdDevVal: "{{DEV_COMMAND}}",
+  cmdBuildVal: "{{BUILD_COMMAND}}",
+  cmdTestVal: "{{TEST_COMMAND}}",
+  cmdTestE2EVal: "[comando e2e]",
+  cmdLintVal: "{{LINT_COMMAND}}",
+  cmdTypecheckVal: "[comando typecheck]"
+};
+
+// src/generators/agents/labels/en.ts
+var labels2 = {
+  // ── Frontmatter ──
+  fmType: "agent-protocol",
+  fmTags: "agents, protocol, operational, ai",
+  // ── Title ──
+  title: "AGENTS.md \u2014 Operational Protocol",
+  subtitle: "Rules that EVERY AI agent must follow when working on this project. Extended guide: `docs/internal/agent-guide.md`.",
+  // ── STOP ──
+  stopTitle: "STOP \u2014 Read this BEFORE doing anything",
+  stop1: "**TRIAGE**: Classify the task (SMALL/MEDIUM/LARGE). Don't skip this step.",
+  stop2: "**READ**: Read the documentation indicated in the table BEFORE writing code.",
+  stop3: "**ASK**: If there's ambiguity, ask ALL questions in ONE message.",
+  stop4: "**DON'T IMPLEMENT** without following the full protocol (MEDIUM/LARGE).",
+  stop5: "**@reviewer**: Invoke BEFORE marking the task as completed (MEDIUM/LARGE).",
+  // ── Triage ──
+  triageTitle: "Task Triage",
+  triageIntro: "Before executing the protocol, classify the task:",
+  triageSizeHeader: "Size",
+  triageCriteriaHeader: "Criteria",
+  triageProtocolHeader: "Protocol",
+  triageSmall: "**SMALL**",
+  triageSmallCriteria: "\u22642 files, <50 lines",
+  triageSmallProtocol: "Read CONTEXT.md \u2192 implement \u2192 lint \u2192 done",
+  triageMedium: "**MEDIUM**",
+  triageMediumCriteria: "3-10 files, moderate feature",
+  triageMediumProtocol: "Full protocol (no sub-delegation)",
+  triageLarge: "**LARGE**",
+  triageLargeCriteria: "Multi-day, architectural",
+  triageLargeProtocol: "Full protocol + ADR + sub-delegation",
+  triageExamples: "**Examples**: SMALL = fix typo, change color, correct import. MEDIUM = new endpoint, new component, simple service. LARGE = auth system, external provider integration, multi-channel notification system.",
+  triageEscalate: "If you start SMALL and the task grows \u2192 escalate to MEDIUM.",
+  // ── Stack ──
+  stackTitle: "Stack and Conventions",
+  stackSectionTitle: "Stack",
+  stackFrontend: "**Frontend**",
+  stackBackend: "**Backend**",
+  stackDatabase: "**Database**",
+  stackCICD: "**CI/CD**",
+  stackPlaceholder: "[framework and version \u2014 e.g.",
+  stackDbPlaceholder: "[type and version \u2014 e.g.",
+  stackCIPlaceholder: "[platform \u2014 e.g.",
+  stackAutoDetectTitle: "Automatic Stack Detection",
+  stackAutoDetectDesc: "If the stack is not filled above, the agent should detect it:",
+  stackFileHeader: "Detected File",
+  stackEcosystemHeader: "Ecosystem",
+  stackCommandsHeader: "Probable Commands",
+  // ── Conventions ──
+  conventionsTitle: "Mandatory Conventions",
+  convLang: "**Language**: Code in **English**. Comments and docs in **English**.",
+  convNaming: "**Naming**: [naming convention \u2014 e.g. camelCase variables/functions, PascalCase components]",
+  convStructure: "**Structure**: [convention \u2014 e.g. feature-based folders]",
+  convTesting: "**Testing**: All new code MUST include tests.",
+  convLinting: "**Linting**: Pass `npm run lint` without errors before completing.",
+  convCommits: "**Commits**: Conventional Commits in English: `type(scope): description`.",
+  convSecurity: "**Security**: Never commit secrets. Use environment variables.",
+  convDeps: "**Dependencies**: Don't add without justification. If added \u2192 document in ADR.",
+  convA11y: "**Accessibility**: All UI components comply with WCAG 2.1 AA.",
+  // ── Commands ──
+  commandsTitle: "Commands",
+  commandsHeaderCmd: "Command",
+  commandsHeaderUsage: "Usage",
+  cmdDev: "Development with hot-reload",
+  cmdBuild: "Production build",
+  cmdTest: "Unit and integration tests",
+  cmdTestE2E: "End-to-end tests",
+  cmdLint: "Linter (must pass without errors)",
+  cmdTypecheck: "Type verification",
+  commandsDetail: "> **Full details** of git conventions, commits, PRs and testing in [`docs/dev-workflow.md`](docs/dev-workflow.md).",
+  // ── BEFORE ──
+  beforeTitle: "BEFORE each task (MEDIUM/LARGE)",
+  before1Title: "1. Read docs based on task type",
+  beforeTaskTypeHeader: "Task Type",
+  beforeDocHeader: "Documentation to read first",
+  beforeAny: "Any task",
+  beforeFeature: "New feature",
+  beforeBug: "Bug/UI/Style",
+  beforeAPI: "API/Backend",
+  beforeDeploy: "Deploy/Infra",
+  beforeArch: "Architecture",
+  before2Title: "2. Check existing ADRs",
+  before2Desc: "Search in `docs/adr/` before making decisions:",
+  before2Accept: "**Accepted ADR exists** \u2192 FOLLOW IT. Don't reinvent.",
+  before2Contradict: "**Contradicts what you're about to do** \u2192 Raise discussion first.",
+  before2None: "**Doesn't exist** \u2192 Evaluate if it deserves an ADR (see criteria and examples in [`docs/adr/TEMPLATE.md`](docs/adr/TEMPLATE.md)).",
+  before3Title: "3. Check CONTEXT.md",
+  before3Desc: "If the task uses terms not in `docs/CONTEXT.md` \u2192 prepare to update when done.",
+  before3Completeness: "If `CONTEXT.md` has `completeness < 50%` \u2192 priority: complete CONTEXT.md before implementing features.",
+  before4Title: "4. Ask if there's ambiguity",
+  before4Desc: "After reading the documentation, if there's ambiguity \u2192 **batch ALL questions in one message**. Each question with options when possible. Don't ask one by one.",
+  before4DontAsk: "Don't ask if the task is clear, it's standard implementation, or the info is in the docs.",
+  // ── AFTER ──
+  afterTitle: "AFTER each task (MEDIUM/LARGE)",
+  afterTreeTitle: "Post-task tree",
+  afterTreeNode1: "Did you make a decision?",
+  afterTreeNode1a: "Architectural \u2192 docs/adr/ (formal ADR)",
+  afterTreeNode1b: "Non-obvious implementation \u2192 JSDoc + docs/adr/ai-decisions.md",
+  afterTreeNode1c: "No \u2192 next",
+  afterTreeNode2: "New domain terms? \u2192 docs/CONTEXT.md",
+  afterTreeNode3: "Endpoints changed? \u2192 docs/reference/api.md",
+  afterTreeNode4: "UI/UX changed? \u2192 docs/DESIGN.md",
+  afterTreeNode5: "Deploy to production? \u2192 CHANGELOG.md + docs/guides/deployment.md",
+  afterTreeNode6: "Feature completed? \u2192 docs/roadmap.md",
+  afterTreeNode7: "Gotcha discovered? \u2192 docs/guides/troubleshooting.md",
+  afterTreeNode8: "Pattern refactor? \u2192 Review architecture.md and ADRs",
+  afterGuide: "> **Extended guide** with diagrams and examples in [`docs/internal/agent-guide.md`](docs/internal/agent-guide.md).",
+  afterSkill: "> **Alternative**: Invoke skill `doc-maintain` to detect changes and suggest updates automatically.",
+  afterGoldenRule: "**Golden rule**: If you change the code, change the documentation.",
+  // ── Quality Gate ──
+  qgTitle: "Quality Gate \u2014 @reviewer (MEDIUM/LARGE)",
+  qgIntro: "**BEFORE completing**, invoke `@reviewer` to verify:",
+  qgItem1: "\u2705 Code style conforms to conventions",
+  qgItem2: "\u2705 No duplication \u2014 uses existing components/utilities",
+  qgItem3: "\u2705 Follows project architecture and respects ADRs",
+  qgItem4: "\u2705 No security vulnerabilities",
+  qgItem5: "\u2705 Tests included for new code",
+  qgItem6: "\u2705 Documentation updated",
+  qgItem7: "\u2705 No obvious performance issues",
+  qgBlocking: "**\u274C BLOCKING** \u2192 fix before completing.",
+  qgSuggested: "**\u26A0\uFE0F SUGGESTED** \u2192 recommended but doesn't block.",
+  // ── Sub-delegation ──
+  subdelTitle: "Sub-delegation",
+  subdelIntro: "Minimum instructions to sub-agent:",
+  subdelExample: "> Read AGENTS.md and follow the full protocol. Task: [description]. Relevant docs: [list].",
+  subdelNote: "Don't repeat conventions \u2014 they're already in AGENTS.md. See complete example in `docs/internal/agent-guide.md`.",
+  // ── Skills ──
+  skillsTitle: "Available Skills and Agents",
+  skillsList: "**Skills**: `doc-scaffold`, `doc-write`, `doc-design`, `doc-review`, `doc-maintain` \u2014 see `.agents/skills/`",
+  agentsList: "**Agents**: `@reviewer` (quality gate), `@doc-writer`, `@doc-reviewer`, `@doc-designer`, `@doc-maintainer` \u2014 see `.agents/agents/`",
+  skillsGuide: "**Extended guide**: `docs/internal/agent-guide.md`",
+  // ── Stack detection table ──
+  stackRowPackage: "`package.json`",
+  stackRowNodeEco: "Node.js (npm/pnpm/yarn)",
+  stackRowNodeCmds: "`npm run dev`, `npm run build`",
+  stackRowPyReq: "`requirements.txt` / `pyproject.toml`",
+  stackRowPyEco: "Python (pip/poetry)",
+  stackRowPyCmds: "`python manage.py runserver`, `pytest`",
+  stackRowGo: "`go.mod`",
+  stackRowGoEco: "Go",
+  stackRowGoCmds: "`go run .`, `go test ./...`",
+  stackRowRust: "`Cargo.toml`",
+  stackRowRustEco: "Rust",
+  stackRowRustCmds: "`cargo run`, `cargo test`",
+  stackRowJava: "`pom.xml` / `build.gradle`",
+  stackRowJavaEco: "Java/Kotlin",
+  stackRowJavaCmds: "`mvn spring-boot:run`, `gradle bootRun`",
+  // ── Docs table (BEFORE) ──
+  beforeDocAny: "`docs/CONTEXT.md`",
+  beforeDocFeature: "`docs/roadmap.md`, `docs/explanation/architecture.md`, relevant ADRs",
+  beforeDocBug: "`docs/DESIGN.md`, `docs/CONTEXT.md`",
+  beforeDocApi: "`docs/reference/api.md`, `docs/reference/configuration.md`",
+  beforeDocDeploy: "`docs/guides/deployment.md`, `docs/reference/infrastructure.md`",
+  beforeDocArch: "`docs/explanation/architecture.md`, `docs/adr/` (all)",
+  // ── Commands (values) ──
+  cmdDevVal: "{{DEV_COMMAND}}",
+  cmdBuildVal: "{{BUILD_COMMAND}}",
+  cmdTestVal: "{{TEST_COMMAND}}",
+  cmdTestE2EVal: "[e2e command]",
+  cmdLintVal: "{{LINT_COMMAND}}",
+  cmdTypecheckVal: "[typecheck command]"
+};
+
+// src/generators/agents/generator.ts
+registerLabels("agents", "es", labels);
+registerLabels("agents", "en", labels2);
+function fmtStack(options) {
+  const s = options.stack;
+  if (!s) return "[TECNOLOG\xCDA PRINCIPAL]";
+  const parts = [s.language];
+  if (s.framework) parts.push(s.framework);
+  return parts.join(" + ");
+}
+function fmtFramework(options) {
+  return options.stack?.framework || "[framework]";
+}
+function generate(options) {
+  const labels31 = loadLabels("agents", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const stackStr = fmtStack(options);
+  const fw = fmtFramework(options);
+  let md = `---
+project: "${options.projectName}"
+stack: "${stackStr}"
+created: "2025-01-01"
+updated: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+`;
+  md += `# ${t("title")}
+
+`;
+  md += `${t("subtitle")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("stopTitle")}
+
+`;
+  md += `1. ${t("stop1")}
+`;
+  md += `2. ${t("stop2")}
+`;
+  md += `3. ${t("stop3")}
+`;
+  md += `4. ${t("stop4")}
+`;
+  md += `5. ${t("stop5")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("triageTitle")}
+
+`;
+  md += `${t("triageIntro")}
+
+`;
+  md += `| ${t("triageSizeHeader")} | ${t("triageCriteriaHeader")} | ${t("triageProtocolHeader")} |
+`;
+  md += `|--------|----------|-----------|
+`;
+  md += `| ${t("triageSmall")} | ${t("triageSmallCriteria")} | ${t("triageSmallProtocol")} |
+`;
+  md += `| ${t("triageMedium")} | ${t("triageMediumCriteria")} | ${t("triageMediumProtocol")} |
+`;
+  md += `| ${t("triageLarge")} | ${t("triageLargeCriteria")} | ${t("triageLargeProtocol")} |
+
+`;
+  md += `${t("triageExamples")}
+
+`;
+  md += `${t("triageEscalate")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("stackTitle")}
+
+`;
+  md += `### ${t("stackSectionTitle")}
+`;
+  if (options.conditionCtx.hasFrontend) {
+    md += `- ${t("stackFrontend")}: ${t("stackPlaceholder")} ${fw}]
+`;
+  }
+  if (options.conditionCtx.hasBackend) {
+    md += `- ${t("stackBackend")}: ${t("stackPlaceholder")} ${fw}]
+`;
+  }
+  if (options.conditionCtx.hasDatabase) {
+    md += `- ${t("stackDatabase")}: ${t("stackDbPlaceholder")} ${stackStr}]
+`;
+  }
+  md += `- ${t("stackCICD")}: ${t("stackCIPlaceholder")} ${stackStr}]
+
+`;
+  md += `### ${t("stackAutoDetectTitle")}
+
+`;
+  md += `${t("stackAutoDetectDesc")}
+
+`;
+  md += `| ${t("stackFileHeader")} | ${t("stackEcosystemHeader")} | ${t("stackCommandsHeader")} |
+`;
+  md += `|-------------------|------------|--------------------|
+`;
+  md += `| ${t("stackRowPackage")} | ${t("stackRowNodeEco")} | ${t("stackRowNodeCmds")} |
+`;
+  md += `| ${t("stackRowPyReq")} | ${t("stackRowPyEco")} | ${t("stackRowPyCmds")} |
+`;
+  md += `| ${t("stackRowGo")} | ${t("stackRowGoEco")} | ${t("stackRowGoCmds")} |
+`;
+  md += `| ${t("stackRowRust")} | ${t("stackRowRustEco")} | ${t("stackRowRustCmds")} |
+`;
+  md += `| ${t("stackRowJava")} | ${t("stackRowJavaEco")} | ${t("stackRowJavaCmds")} |
+
+`;
+  md += `### ${t("conventionsTitle")}
+`;
+  md += `1. ${t("convLang")}
+`;
+  md += `2. ${t("convNaming")}
+`;
+  md += `3. ${t("convStructure")}
+`;
+  md += `4. ${t("convTesting")}
+`;
+  md += `5. ${t("convLinting")}
+`;
+  md += `6. ${t("convCommits")}
+`;
+  md += `7. ${t("convSecurity")}
+`;
+  md += `8. ${t("convDeps")}
+`;
+  md += `9. ${t("convA11y")}
+
+`;
+  md += `### ${t("commandsTitle")}
+
+`;
+  md += `| ${t("commandsHeaderCmd")} | ${t("commandsHeaderUsage")} |
+`;
+  md += `|---------|-----|
+`;
+  md += `| \`${t("cmdDevVal")}\` | ${t("cmdDev")} |
+`;
+  md += `| \`${t("cmdBuildVal")}\` | ${t("cmdBuild")} |
+`;
+  md += `| \`${t("cmdTestVal")}\` | ${t("cmdTest")} |
+`;
+  md += `| \`${t("cmdTestE2EVal")}\` | ${t("cmdTestE2E")} |
+`;
+  md += `| \`${t("cmdLintVal")}\` | ${t("cmdLint")} |
+`;
+  md += `| \`${t("cmdTypecheckVal")}\` | ${t("cmdTypecheck")} |
+
+`;
+  md += `${t("commandsDetail")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("beforeTitle")}
+
+`;
+  md += `### ${t("before1Title")}
+
+`;
+  md += `| ${t("beforeTaskTypeHeader")} | ${t("beforeDocHeader")} |
+`;
+  md += `|---------------|------------------------------|
+`;
+  md += `| ${t("beforeAny")} | ${t("beforeDocAny")} |
+`;
+  md += `| ${t("beforeFeature")} | ${t("beforeDocFeature")} |
+`;
+  md += `| ${t("beforeBug")} | ${t("beforeDocBug")} |
+`;
+  md += `| ${t("beforeAPI")} | ${t("beforeDocApi")} |
+`;
+  md += `| ${t("beforeDeploy")} | ${t("beforeDocDeploy")} |
+`;
+  md += `| ${t("beforeArch")} | ${t("beforeDocArch")} |
+
+`;
+  md += `### ${t("before2Title")}
+
+`;
+  md += `${t("before2Desc")}
+`;
+  md += `- ${t("before2Accept")}
+`;
+  md += `- ${t("before2Contradict")}
+`;
+  md += `- ${t("before2None")}
+
+`;
+  md += `### ${t("before3Title")}
+
+`;
+  md += `${t("before3Desc")}
+
+`;
+  md += `${t("before3Completeness")}
+
+`;
+  md += `### ${t("before4Title")}
+
+`;
+  md += `${t("before4Desc")}
+
+`;
+  md += `${t("before4DontAsk")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("afterTitle")}
+
+`;
+  md += `### ${t("afterTreeTitle")}
+
+`;
+  md += "```\n";
+  md += `${t("afterTreeNode1")}
+`;
+  md += `  \u251C\u2500\u2500 ${t("afterTreeNode1a")}
+`;
+  md += `  \u251C\u2500\u2500 ${t("afterTreeNode1b")}
+`;
+  md += `  \u2514\u2500\u2500 ${t("afterTreeNode1c")}
+`;
+  md += `${t("afterTreeNode2")}
+`;
+  md += `${t("afterTreeNode3")}
+`;
+  md += `${t("afterTreeNode4")}
+`;
+  md += `${t("afterTreeNode5")}
+`;
+  md += `${t("afterTreeNode6")}
+`;
+  md += `${t("afterTreeNode7")}
+`;
+  md += `${t("afterTreeNode8")}
+`;
+  md += "```\n\n";
+  md += `${t("afterGuide")}
+`;
+  md += `${t("afterSkill")}
+
+`;
+  md += `${t("afterGoldenRule")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("qgTitle")}
+
+`;
+  md += `${t("qgIntro")}
+`;
+  md += `- ${t("qgItem1")}
+`;
+  md += `- ${t("qgItem2")}
+`;
+  md += `- ${t("qgItem3")}
+`;
+  md += `- ${t("qgItem4")}
+`;
+  md += `- ${t("qgItem5")}
+`;
+  md += `- ${t("qgItem6")}
+`;
+  md += `- ${t("qgItem7")}
+
+`;
+  md += `- ${t("qgBlocking")}
+`;
+  md += `- ${t("qgSuggested")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("subdelTitle")}
+
+`;
+  md += `${t("subdelIntro")}
+`;
+  md += `${t("subdelExample")}
+
+`;
+  md += `${t("subdelNote")}
+
+`;
+  md += "---\n\n";
+  md += `## ${t("skillsTitle")}
+
+`;
+  md += `- ${t("skillsList")}
+`;
+  md += `- ${t("agentsList")}
+`;
+  md += `- ${t("skillsGuide")}
+`;
+  return md;
+}
+
+// src/generators/context/labels/es.ts
+var labels3 = {
+  fmType: "domain-language",
+  fmTags: "contexto, dominio, vocabulario, glosario",
+  title: "CONTEXT.md \u2014 Lenguaje del Dominio",
+  intro: "Este archivo define el vocabulario compartido que se usa en este proyecto. Todo t\xE9rmino de negocio o concepto clave del dominio debe estar documentado aqu\xED.",
+  introGap: "Si un t\xE9rmino aparece en el c\xF3digo, la documentaci\xF3n o las conversaciones del equipo y NO est\xE1 en este archivo, es un gap que debe cubrirse.",
+  entitiesTitle: "Entidades principales",
+  entitiesTerm: "T\xE9rmino",
+  entitiesDef: "Definici\xF3n",
+  entitiesExample: "Ejemplo de uso",
+  entitiesTech: "Equivalente t\xE9cnico",
+  statesTitle: "Estados y flujos",
+  statesState: "Estado",
+  statesMeaning: "Significa",
+  statesTransitions: "Transiciones posibles",
+  rolesTitle: "Roles y permisos",
+  rolesRole: "Rol",
+  rolesWho: "Qui\xE9n es",
+  rolesWhat: "Qu\xE9 puede hacer",
+  bizTermsTitle: "T\xE9rminos de negocio",
+  bizTermsTerm: "T\xE9rmino",
+  bizTermsDef: "Definici\xF3n",
+  bizTermsNotes: "Notas",
+  techTermsTitle: "T\xE9rminos t\xE9cnicos internos",
+  techTermsTerm: "T\xE9rmino",
+  techTermsDef: "Definici\xF3n",
+  techTermsWhy: "Por qu\xE9 existe",
+  relationsTitle: "Relaciones entre conceptos",
+  relationsCode: "[Entidad 1] \u2500\u2500\u2500 1:N \u2500\u2500\u2500\u2192 [Entidad 2]\n                         \u2514\u2500\u2500\u2192 [Entidad 3] (a trav\xE9s de [Entidad 4])",
+  dialogTitle: "Ejemplo de di\xE1logo usando el dominio",
+  dialogIntro: "Este ejemplo muestra c\xF3mo se usa el vocabulario en una conversaci\xF3n real del equipo:",
+  dialogPM: '**Product Manager**: "El cliente necesita que los [T\xE9rmino 1] en estado [Estado A] se puedan convertir autom\xE1ticamente en [T\xE9rmino 2] cuando pasen a [Estado B]."',
+  dialogDev: '**Developer**: "Entendido. \xBFEsa conversaci\xF3n aplica para todos los [Rol 1] o solo para los que tienen permiso de [acci\xF3n]?"',
+  dialogPM2: '**Product Manager**: "Solo para [Rol 1]. Los [Rol 2] solo ven el [T\xE9rmino 1] pero no pueden convertirlo."',
+  dialogDev2: '**Developer**: "Perfecto. Voy a a\xF1adir un bot\xF3n de conversi\xF3n en la vista de [T\xE9rmino 1] para [Rol 1], visible solo cuando est\xE9 en [Estado A]. \xBFEl [T\xE9rmino 2] resultante empieza en [Estado C]?"',
+  dialogPM3: '**Product Manager**: "S\xED, empieza en [Estado C] y necesita aprobaci\xF3n de un [Rol 2] para pasar a [Estado D]."',
+  ambTitle: "Ambig\xFCedades flagadas",
+  ambIntro: "Estos t\xE9rminos tienen significados que podr\xEDan confundirse. Prestar atenci\xF3n al contexto:",
+  ambTerm: "T\xE9rmino",
+  ambConfusion: "Confusi\xF3n posible",
+  ambClarification: "Aclaraci\xF3n",
+  updateTitle: "C\xF3mo actualizar este archivo",
+  update1: "Identificar si es una **entidad**, un **estado**, un **rol**, un **t\xE9rmino de negocio** o un **t\xE9rmino t\xE9cnico**.",
+  update2: "A\xF1adirlo en la secci\xF3n correspondiente con: definici\xF3n, ejemplo de uso, y equivalente t\xE9cnico.",
+  update3: "Si tiene relaciones con otras entidades, actualizar el diagrama de relaciones.",
+  update4: 'Si es ambiguo o se confunde con otro t\xE9rmino, a\xF1adirlo en "Ambig\xFCedades flagadas".',
+  update5: "Si se introdujo un nuevo estado o flujo, actualizar la tabla de estados.",
+  updateRule: "**Regla**: Todo t\xE9rmino que aparezca en c\xF3digo, APIs, UI o conversaciones del equipo DEBE estar aqu\xED. Si no est\xE1, es un bug de documentaci\xF3n.",
+  updateIntro: "Cuando se a\xF1ada un nuevo t\xE9rmino al dominio:"
+};
+
+// src/generators/context/labels/en.ts
+var labels4 = {
+  fmType: "domain-language",
+  fmTags: "context, domain, vocabulary, glossary",
+  title: "CONTEXT.md \u2014 Domain Language",
+  intro: "This file defines the shared vocabulary used in this project. Every business term or key domain concept must be documented here.",
+  introGap: "If a term appears in code, documentation or team conversations and is NOT in this file, it's a gap that needs to be covered.",
+  entitiesTitle: "Main Entities",
+  entitiesTerm: "Term",
+  entitiesDef: "Definition",
+  entitiesExample: "Usage Example",
+  entitiesTech: "Technical Equivalent",
+  statesTitle: "States and Flows",
+  statesState: "State",
+  statesMeaning: "Meaning",
+  statesTransitions: "Possible Transitions",
+  rolesTitle: "Roles and Permissions",
+  rolesRole: "Role",
+  rolesWho: "Who it is",
+  rolesWhat: "What they can do",
+  bizTermsTitle: "Business Terms",
+  bizTermsTerm: "Term",
+  bizTermsDef: "Definition",
+  bizTermsNotes: "Notes",
+  techTermsTitle: "Internal Technical Terms",
+  techTermsTerm: "Term",
+  techTermsDef: "Definition",
+  techTermsWhy: "Why it exists",
+  relationsTitle: "Relationships Between Concepts",
+  relationsCode: "[Entity 1] \u2500\u2500\u2500 1:N \u2500\u2500\u2500\u2192 [Entity 2]\n                       \u2514\u2500\u2500\u2192 [Entity 3] (via [Entity 4])",
+  dialogTitle: "Example Dialogue Using Domain Terms",
+  dialogIntro: "This example shows how vocabulary is used in a real team conversation:",
+  dialogPM: '**Product Manager**: "The client needs [Term 1] in state [State A] to be automatically converted to [Term 2] when they reach [State B]."',
+  dialogDev: '**Developer**: "Understood. Does this conversion apply to all [Role 1] or only those with [action] permission?"',
+  dialogPM2: '**Product Manager**: "Only for [Role 1]. [Role 2] can only see the [Term 1] but cannot convert it."',
+  dialogDev2: `**Developer**: "Perfect. I'll add a conversion button on the [Term 1] view for [Role 1], visible only when in [State A]. Does the resulting [Term 2] start in [State C]?"`,
+  dialogPM3: '**Product Manager**: "Yes, it starts in [State C] and needs approval from a [Role 2] to move to [State D]."',
+  ambTitle: "Flagged Ambiguities",
+  ambIntro: "These terms have meanings that could be confused. Pay attention to context:",
+  ambTerm: "Term",
+  ambConfusion: "Possible Confusion",
+  ambClarification: "Clarification",
+  updateTitle: "How to Update This File",
+  update1: "Identify if it's an **entity**, **state**, **role**, **business term** or **technical term**.",
+  update2: "Add it in the corresponding section with: definition, usage example, and technical equivalent.",
+  update3: "If it has relationships with other entities, update the relationship diagram.",
+  update4: `If it's ambiguous or confused with another term, add it in "Flagged Ambiguities".`,
+  update5: "If a new state or flow was introduced, update the states table.",
+  updateRule: "**Rule**: Every term that appears in code, APIs, UI or team conversations MUST be here. If it's not, it's a documentation bug.",
+  updateIntro: "When adding a new domain term:"
+};
+
+// src/generators/context/generator.ts
+registerLabels("context", "es", labels3);
+registerLabels("context", "en", labels4);
+function generate2(options) {
+  const labels31 = loadLabels("context", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  let md = `---
+created: "2025-01-01"
+updated: "${today}"
+status: active
+completeness: "15%"
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+${t("introGap")}
+
+---
+
+## ${t("entitiesTitle")}
+
+| ${t("entitiesTerm")} | ${t("entitiesDef")} | ${t("entitiesExample")} | ${t("entitiesTech")} |
+|---------|-----------|----------------|-------------------|
+| **${t("placeholder")}** | [definici\xF3n] | "ejemplo de uso" | \`[codigo]\` |
+
+## ${t("statesTitle")}
+
+| ${t("statesState")} | ${t("statesMeaning")} | ${t("statesTransitions")} |
+|-------|---------|----------------------|
+| **[Estado]** | [significado] | \u2192 [otro estado] |
+
+## ${t("rolesTitle")}
+
+| ${t("rolesRole")} | ${t("rolesWho")} | ${t("rolesWhat")} |
+|-----|----------|----------------|
+| **[Rol]** | [descripci\xF3n] | [acciones] |
+
+## ${t("bizTermsTitle")}
+
+| ${t("bizTermsTerm")} | ${t("bizTermsDef")} | ${t("bizTermsNotes")} |
+|---------|-----------|-------|
+| **[T\xE9rmino]** | [definici\xF3n] | [notas] |
+
+## ${t("techTermsTitle")}
+
+| ${t("techTermsTerm")} | ${t("techTermsDef")} | ${t("techTermsWhy")} |
+|---------|-----------|----------------|
+| **[T\xE9rmino]** | [definici\xF3n] | [raz\xF3n] |
+
+---
+
+## ${t("relationsTitle")}
+
+\`\`\`
+${t("relationsCode")}
+\`\`\`
+
+---
+
+## ${t("dialogTitle")}
+
+${t("dialogIntro")}
+
+> ${t("dialogPM")}
+>
+> ${t("dialogDev")}
+>
+> ${t("dialogPM2")}
+>
+> ${t("dialogDev2")}
+>
+> ${t("dialogPM3")}
+
+---
+
+## ${t("ambTitle")}
+
+${t("ambIntro")}
+
+| ${t("ambTerm")} | ${t("ambConfusion")} | ${t("ambClarification")} |
+|------|-------------------|-----------|
+| **[t\xE9rmino]** | [confusi\xF3n] | [aclaraci\xF3n] |
+
+---
+
+## ${t("updateTitle")}
+
+${t("updateIntro")}
+
+1. ${t("update1")}
+2. ${t("update2")}
+3. ${t("update3")}
+4. ${t("update4")}
+5. ${t("update5")}
+
+${t("updateRule")}
+`;
+  return md;
+}
+
+// src/generators/changelog/labels/es.ts
+var labels5 = {
+  fmType: "changelog",
+  fmTags: "changelog, releases, cambios",
+  title: "Changelog",
+  intro: "Todos los cambios notables de este proyecto se documentar\xE1n en este archivo.",
+  format: "El formato est\xE1 basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/).",
+  unreleased: "Unreleased",
+  added: "Added",
+  addedInitial: "Documentaci\xF3n del proyecto inicializada con `@damenor/agent-docs`",
+  addedProtocol: "Agents.md como protocolo operativo para agentes de IA",
+  addedContext: "Contexto de lenguaje del dominio (CONTEXT.md)",
+  addedDiataxis: "Estructura de documentaci\xF3n Di\xE1taxis (tutorials, guides, reference, explanation)",
+  templateTitle: "Template \u2014 C\xF3mo usar este archivo",
+  whenTitle: "Cu\xE1ndo actualizar",
+  whenFeature: "**Feature nueva** \u2192 `### Added`",
+  whenBug: "**Bug fix** \u2192 `### Fixed`",
+  whenChange: "**Cambio de comportamiento** \u2192 `### Changed`",
+  whenRemove: "**Feature eliminada** \u2192 `### Removed`",
+  whenSecurity: "**Fix de seguridad** \u2192 `### Security`",
+  whenDep: "**Nueva dependencia** \u2192 `### Added` + explicar motivo en ADR si es significativa",
+  formatTitle: "Formato",
+  formatExample: "## [versi\xF3n] \u2014 YYYY-MM-DD\n\n### Added\n- Feature X que hace Y (#issue)\n\n### Fixed\n- Bug donde Z pasaba cuando W (#issue)\n\n### Changed\n- Comportamiento de V cambi\xF3 para mejorar U (#issue)",
+  rulesTitle: "Reglas",
+  rule1: "**Una entrada por cambio** \u2014 no agrupar cambios no relacionados.",
+  rule2: "**Referenciar issues** \u2014 incluir n\xFAmero de issue/PR cuando sea posible.",
+  rule3: "**Perspectiva del usuario** \u2014 describir qu\xE9 cambi\xF3 para el USUARIO, no la implementaci\xF3n.",
+  rule4: "**Orden cronol\xF3gico inverso** \u2014 versi\xF3n m\xE1s reciente arriba.",
+  rule5: "**No editar entradas pasadas** \u2014 una vez publicadas, son inmutables."
+};
+
+// src/generators/changelog/labels/en.ts
+var labels6 = {
+  fmType: "changelog",
+  fmTags: "changelog, releases, changes",
+  title: "Changelog",
+  intro: "All notable changes to this project will be documented in this file.",
+  format: "The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).",
+  unreleased: "Unreleased",
+  added: "Added",
+  addedInitial: "Project documentation initialized with `@damenor/agent-docs`",
+  addedProtocol: "Agents.md operational protocol for AI agents",
+  addedContext: "Domain language context (CONTEXT.md)",
+  addedDiataxis: "Di\xE1taxis documentation structure (tutorials, guides, reference, explanation)",
+  templateTitle: "Template \u2014 How to use this file",
+  whenTitle: "When to update",
+  whenFeature: "**New feature** \u2192 `### Added`",
+  whenBug: "**Bug fix** \u2192 `### Fixed`",
+  whenChange: "**Behavior change** \u2192 `### Changed`",
+  whenRemove: "**Removed feature** \u2192 `### Removed`",
+  whenSecurity: "**Security fix** \u2192 `### Security`",
+  whenDep: "**New dependency** \u2192 `### Added` + explain why in ADR if significant",
+  formatTitle: "Format",
+  formatExample: "## [version] \u2014 YYYY-MM-DD\n\n### Added\n- Feature X that does Y (#issue)\n\n### Fixed\n- Bug where Z happened when W (#issue)\n\n### Changed\n- Behavior of V changed to improve U (#issue)",
+  rulesTitle: "Rules",
+  rule1: "**One entry per change** \u2014 don't group unrelated changes.",
+  rule2: "**Reference issues** \u2014 include the issue/PR number when possible.",
+  rule3: "**User perspective** \u2014 describe what changed for the USER, not the implementation.",
+  rule4: "**Reverse chronological** \u2014 newest version at the top.",
+  rule5: "**Don't edit past entries** \u2014 once published, they're immutable."
+};
+
+// src/generators/changelog/generator.ts
+registerLabels("changelog", "es", labels5);
+registerLabels("changelog", "en", labels6);
+function generate3(options) {
+  const labels31 = loadLabels("changelog", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  return `---
+created: "2025-01-01"
+updated: "${options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+${t("format")}
+
+## [${t("unreleased")}]
+
+### ${t("added")}
+- ${t("addedInitial")}
+- ${t("addedProtocol")}
+- ${t("addedContext")}
+- ${t("addedDiataxis")}
+
+---
+
+## ${t("templateTitle")}
+
+### ${t("whenTitle")}
+
+- ${t("whenFeature")}
+- ${t("whenBug")}
+- ${t("whenChange")}
+- ${t("whenRemove")}
+- ${t("whenSecurity")}
+- ${t("whenDep")}
+
+### ${t("formatTitle")}
+
+\`\`\`markdown
+${t("formatExample")}
+\`\`\`
+
+### ${t("rulesTitle")}
+
+1. ${t("rule1")}
+2. ${t("rule2")}
+3. ${t("rule3")}
+4. ${t("rule4")}
+5. ${t("rule5")}
+`;
+}
+
+// src/generators/quick-start/labels/es.ts
+var labels7 = {
+  fmType: "tutorial",
+  fmTags: "tutorial, quick-start, inicio, setup",
+  title: "Quick Start \u2014 Arrancar en 15 minutos",
+  intro: "Este tutorial te lleva desde cero hasta tener el proyecto corriendo localmente. Al terminar, tendr\xE1s el servidor de desarrollo funcionando y podr\xE1s hacer tu primer cambio.",
+  time: "**Tiempo estimado**",
+  audience: "**Audiencia**",
+  prereqTitle: "Prerrequisitos",
+  prereqTool: "Herramienta",
+  prereqVersion: "Versi\xF3n m\xEDnima",
+  prereqVerify: "C\xF3mo verificar",
+  prereqInstall: "C\xF3mo instalar",
+  step1Title: "Paso 1: Clonar el repositorio",
+  step1Clone: "git clone [URL_DEL_REPOSITORIO]",
+  step1Cd: "cd [NOMBRE_DEL_PROYECTO]",
+  step1Check: "Verificar que est\xE1s en la branch correcta:",
+  step1Result: "# Deber\xEDa mostrar: * main",
+  step2Title: "Paso 2: Instalar dependencias",
+  step2Install: "[npm install]",
+  step2Error: "Si hay errores:",
+  step2Error1: "Verificar que la versi\xF3n de [Node / Python] sea la correcta.",
+  step2Error2: "Borrar `[node_modules]` y `[package-lock.json]` y volver a ejecutar.",
+  step2Error3: "Si persiste, ver [`troubleshooting.md`](../guides/troubleshooting.md).",
+  step3Title: "Paso 3: Configurar variables de entorno",
+  step3Copy: "Copiar el archivo de ejemplo:",
+  step3Env: "Abrir `.env` y completar los valores necesarios. Los valores m\xEDnimos para desarrollo local son:",
+  step3Ref: "Ver la referencia completa de variables en [`docs/reference/configuration.md`](../reference/configuration.md).",
+  step4Title: "Paso 4: Inicializar la base de datos *(si aplica)*",
+  step4Migrate: "[comando de migraci\xF3n \u2014 ej. npm run db:migrate]",
+  step4Seed: "[comando de seed \u2014 ej. npm run db:seed]",
+  step5Title: "Paso 5: Arrancar el servidor de desarrollo",
+  step5Cmd: "[npm run dev]",
+  step5Result: "Deber\xEDas ver algo como:",
+  step5Open: "Abrir `http://localhost:3000` en el navegador.",
+  step6Title: "Paso 6: Verificar que todo funciona",
+  step6Test: "Ejecutar los tests:",
+  step6TestCmd: "[npm run test]",
+  step6TestFail: "Si alg\xFAn test falla:",
+  step6TestFail1: "Verificar que la base de datos est\xE9 configurada correctamente.",
+  step6TestFail2: "Verificar que las variables de entorno est\xE9n completas.",
+  step6TestFail3: "Ver [`troubleshooting.md`](../guides/troubleshooting.md).",
+  step6Lint: "Ejecutar el linter:",
+  step6LintCmd: "[npm run lint]",
+  nextTitle: "Siguientes pasos",
+  next1: "Para configurar tu entorno completo (editor, extensiones, herramientas):",
+  next2: "Para hacer tu primera contribuci\xF3n (branch \u2192 c\xF3digo \u2192 PR):",
+  next3: "Para entender la arquitectura del proyecto:",
+  next4: "Para conocer el vocabulario del dominio:",
+  envBlock: "# Obligatorios para arrancar\nAPP_ENV=development\nAPP_PORT=3000\n[DATABASE_URL]=[URL de desarrollo local]\n\n# Opcionales (tienen defaults para desarrollo)\n[LOG_LEVEL]=debug"
+};
+
+// src/generators/quick-start/labels/en.ts
+var labels8 = {
+  fmType: "tutorial",
+  fmTags: "tutorial, quick-start, setup",
+  title: "Quick Start \u2014 Get Running in 15 Minutes",
+  intro: "This tutorial takes you from zero to having the project running locally. When done, you'll have the development server working and be able to make your first change.",
+  time: "**Estimated time**",
+  audience: "**Audience**",
+  prereqTitle: "Prerequisites",
+  prereqTool: "Tool",
+  prereqVersion: "Minimum Version",
+  prereqVerify: "How to Verify",
+  prereqInstall: "How to Install",
+  step1Title: "Step 1: Clone the repository",
+  step1Clone: "git clone [REPOSITORY_URL]",
+  step1Cd: "cd [PROJECT_NAME]",
+  step1Check: "Verify you're on the correct branch:",
+  step1Result: "# Should show: * main",
+  step2Title: "Step 2: Install dependencies",
+  step2Install: "[npm install]",
+  step2Error: "If there are errors:",
+  step2Error1: "Verify that [Node / Python] version is correct.",
+  step2Error2: "Delete `[node_modules]` and `[package-lock.json]` and re-run.",
+  step2Error3: "If it persists, see [`troubleshooting.md`](../guides/troubleshooting.md).",
+  step3Title: "Step 3: Configure environment variables",
+  step3Copy: "Copy the example file:",
+  step3Env: "Open `.env` and fill in the necessary values. The minimum values for local development are:",
+  step3Ref: "See the full variable reference in [`docs/reference/configuration.md`](../reference/configuration.md).",
+  step4Title: "Step 4: Initialize the database *(if applicable)*",
+  step4Migrate: "[migration command \u2014 e.g. npm run db:migrate]",
+  step4Seed: "[seed command \u2014 e.g. npm run db:seed]",
+  step5Title: "Step 5: Start the development server",
+  step5Cmd: "[npm run dev]",
+  step5Result: "You should see something like:",
+  step5Open: "Open `http://localhost:3000` in the browser.",
+  step6Title: "Step 6: Verify everything works",
+  step6Test: "Run the tests:",
+  step6TestCmd: "[npm run test]",
+  step6TestFail: "If any test fails:",
+  step6TestFail1: "Verify the database is configured correctly.",
+  step6TestFail2: "Verify environment variables are complete.",
+  step6TestFail3: "See [`troubleshooting.md`](../guides/troubleshooting.md).",
+  step6Lint: "Run the linter:",
+  step6LintCmd: "[npm run lint]",
+  nextTitle: "Next Steps",
+  next1: "To set up your complete environment (editor, extensions, tools):",
+  next2: "To make your first contribution (branch \u2192 code \u2192 PR):",
+  next3: "To understand the project architecture:",
+  next4: "To learn the domain vocabulary:",
+  envBlock: "# Required to start\nAPP_ENV=development\nAPP_PORT=3000\n[DATABASE_URL]=[local development URL]\n\n# Optional (have defaults for development)\n[LOG_LEVEL]=debug"
+};
+
+// src/generators/quick-start/generator.ts
+registerLabels("quick-start", "es", labels7);
+registerLabels("quick-start", "en", labels8);
+function generate4(options) {
+  const labels31 = loadLabels("quick-start", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const isEs = options.language === "es";
+  let md = `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+${t("time")}: 15 minutos.
+${t("audience")}: Developers que se incorporan al proyecto por primera vez.
+
+---
+
+## ${t("prereqTitle")}
+
+Antes de empezar, necesitas tener instalado:
+
+| ${t("prereqTool")} | ${t("prereqVersion")} | ${t("prereqVerify")} | ${t("prereqInstall")} |
+|------------|---------------|----------------|---------------|
+| **[Node.js / Python / etc.]** | [versi\xF3n] | \`[node --version]\` | [nodejs.org / enlace] |
+| **[Git]** | [versi\xF3n] | \`git --version\` | [git-scm.com] |
+| **[Package manager]** | [versi\xF3n] | \`[npm --version]\` | Viene con Node.js |
+| **[Editor recomendado]** | \u2014 | \u2014 | [VS Code / etc.] |
+
+Si necesitas ayuda con la instalaci\xF3n completa, ver [\`environment-setup.md\`](environment-setup.md).
+
+---
+
+## ${t("step1Title")}
+
+\`\`\`bash
+${t("step1Clone")}
+${t("step1Cd")}
+\`\`\`
+
+${t("step1Check")}
+
+\`\`\`bash
+git branch
+${t("step1Result")}
+\`\`\`
+
+---
+
+## ${t("step2Title")}
+
+\`\`\`bash
+${t("step2Install")}
+\`\`\`
+
+${isEs ? "Este comando descarga todas las dependencias del proyecto." : "This command downloads all project dependencies."} ${t("step2Error")}
+
+- ${t("step2Error1")}
+- ${t("step2Error2")}
+- ${t("step2Error3")}
+
+---
+
+## ${t("step3Title")}
+
+${t("step3Copy")}
+
+\`\`\`bash
+cp .env.example .env
+\`\`\`
+
+${t("step3Env")}
+
+\`\`\`env
+${t("envBlock")}
+\`\`\`
+
+${t("step3Ref")}
+
+---
+
+## ${t("step4Title")}
+
+${options.conditionCtx.hasDatabase ? `\`\`\`bash
+${t("step4Migrate")}
+\`\`\`
+
+${isEs ? "Opcionalmente, cargar datos de prueba:" : "Optionally, load test data:"}
+
+\`\`\`bash
+${t("step4Seed")}
+\`\`\`` : `*${isEs ? "Este proyecto no usa base de datos \u2014 saltar este paso." : "This project does not use a database \u2014 skip this step."}*`}
+
+---
+
+## ${t("step5Title")}
+
+\`\`\`bash
+${t("step5Cmd")}
+\`\`\`
+
+${t("step5Result")}
+
+\`\`\`
+\u2713 Servidor iniciado en http://localhost:3000
+\u2713 Hot-reload activo
+\`\`\`
+
+${t("step5Open")} ${isEs ? "Deber\xEDas ver [la p\xE1gina principal / el dashboard / la landing]." : "You should see [the main page / the dashboard / the landing]."}
+
+---
+
+## ${t("step6Title")}
+
+${t("step6Test")}
+
+\`\`\`bash
+${t("step6TestCmd")}
+\`\`\`
+
+${isEs ? "Todos deber\xEDan pasar (verde)." : "All should pass (green)."} ${t("step6TestFail")}
+
+- ${t("step6TestFail1")}
+- ${t("step6TestFail2")}
+- ${t("step6TestFail3")}
+
+${t("step6Lint")}
+
+\`\`\`bash
+${t("step6LintCmd")}
+\`\`\`
+
+${isEs ? "No deber\xEDa mostrar errores." : "It should show no errors."}
+
+---
+
+## ${t("nextTitle")}
+
+- ${t("next1")} [\`environment-setup.md\`](environment-setup.md).
+- ${t("next2")} [\`first-task.md\`](first-task.md).
+- ${t("next3")} [\`docs/explanation/architecture.md\`](../explanation/architecture.md).
+- ${t("next4")} [\`docs/CONTEXT.md\`](../CONTEXT.md).
+`;
+  return md;
+}
+
+// src/generators/api-reference/labels/es.ts
+var labels9 = {
+  fmType: "reference",
+  fmTags: "api, reference, endpoints, referencia",
+  title: "Referencia de API",
+  intro: "Documentaci\xF3n de referencia de los endpoints del proyecto.",
+  convention: "> [!tip] Convenci\xF3n\n> Si la API crece a m\xE1s de 10 endpoints, convierte este archivo en una carpeta `api/` con un archivo por dominio.",
+  authTitle: "Autenticaci\xF3n",
+  authFlow: "**Flujo**:\n1. Cliente env\xEDa credenciales a `/auth/login`\n2. Server devuelve `{ token, refreshToken }`\n3. Cliente incluye `Authorization: Bearer <token>` en requests siguientes\n4. Si token expira, usar refresh token en `/auth/refresh`",
+  endpointsTitle: "Endpoints",
+  resource: "[Recurso]",
+  getTitle: "`GET /api/[recurso]`",
+  getDesc: "Lista recursos con paginaci\xF3n.",
+  postTitle: "`POST /api/[recurso]`",
+  postDesc: "Crea un nuevo recurso.",
+  errorsTitle: "C\xF3digos de Error",
+  rateLimitTitle: "Rate Limiting",
+  rateStandard: "Standard",
+  ratePremium: "Premium",
+  rateHeaders: "Headers de respuesta:",
+  versioningTitle: "Versionado",
+  versioningDesc: "La API usa versionado en URL: `/api/v1/`, `/api/v2/`.\n\nVersiones anteriores se mantienen durante 6 meses despu\xE9s del release de una nueva versi\xF3n mayor."
+};
+
+// src/generators/api-reference/labels/en.ts
+var labels10 = {
+  fmType: "reference",
+  fmTags: "api, reference, endpoints",
+  title: "API Reference",
+  intro: "Reference documentation for the project's endpoints.",
+  convention: "> [!tip] Convention\n> If the API grows beyond 10 endpoints, convert this file to an `api/` folder with one file per domain.",
+  authTitle: "Authentication",
+  authFlow: "**Flow**:\n1. Client sends credentials to `/auth/login`\n2. Server returns `{ token, refreshToken }`\n3. Client includes `Authorization: Bearer <token>` in subsequent requests\n4. If token expires, use refresh token at `/auth/refresh`",
+  endpointsTitle: "Endpoints",
+  resource: "[Resource]",
+  getTitle: "`GET /api/[resource]`",
+  getDesc: "Lists resources with pagination.",
+  postTitle: "`POST /api/[resource]`",
+  postDesc: "Creates a new resource.",
+  errorsTitle: "Error Codes",
+  rateLimitTitle: "Rate Limiting",
+  rateStandard: "Standard",
+  ratePremium: "Premium",
+  rateHeaders: "Response headers:",
+  versioningTitle: "Versioning",
+  versioningDesc: "The API uses URL versioning: `/api/v1/`, `/api/v2/`.\n\nPrevious versions are maintained for 6 months after a new major version release."
+};
+
+// src/generators/api-reference/generator.ts
+registerLabels("api-reference", "es", labels9);
+registerLabels("api-reference", "en", labels10);
+function generate5(options) {
+  const labels31 = loadLabels("api-reference", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  return `---
+created: "2026-05-07"
+updated: "${options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+${t("convention")}
+
+## ${t("authTitle")}
+
+| M\xE9todo | Descripci\xF3n | Header |
+|--------|-------------|--------|
+| Bearer Token | JWT enviado en header | \`Authorization: Bearer <token>\` |
+
+${t("authFlow")}
+
+## ${t("endpointsTitle")}
+
+### ${t("resource")}
+
+#### ${t("getTitle")}
+
+${t("getDesc")}
+
+**Headers**:
+| Header | Requerido | Descripci\xF3n |
+|--------|-----------|-------------|
+| \`Authorization\` | S\xED | Bearer token |
+
+**Query Parameters**:
+| Param | Tipo | Default | Descripci\xF3n |
+|-------|------|---------|-------------|
+| \`page\` | number | 1 | P\xE1gina actual |
+| \`limit\` | number | 20 | Items por p\xE1gina (max 100) |
+| \`sort\` | string | \`-createdAt\` | Campo de orden (\`-\` para desc) |
+
+**Response 200**:
+\`\`\`json
+{
+  "data": [
+    {
+      "id": "string",
+      "name": "string",
+      "createdAt": "ISO 8601"
+    }
+  ],
+  "meta": {
+    "page": 1,
+    "limit": 20,
+    "total": 100
+  }
+}
+\`\`\`
+
+#### ${t("postTitle")}
+
+${t("postDesc")}
+
+**Body**:
+\`\`\`json
+{
+  "name": "string (required, max 200)",
+  "description": "string (optional)"
+}
+\`\`\`
+
+**Response 201**:
+\`\`\`json
+{
+  "id": "string",
+  "name": "string",
+  "description": "string",
+  "createdAt": "ISO 8601",
+  "updatedAt": "ISO 8601"
+}
+\`\`\`
+
+## ${t("errorsTitle")}
+
+| Status | C\xF3digo | Descripci\xF3n |
+|--------|--------|-------------|
+| 400 | \`VALIDATION_ERROR\` | Datos de entrada inv\xE1lidos |
+| 401 | \`UNAUTHORIZED\` | Token ausente o inv\xE1lido |
+| 403 | \`FORBIDDEN\` | Sin permisos para el recurso |
+| 404 | \`NOT_FOUND\` | Recurso no encontrado |
+| 409 | \`CONFLICT\` | Recurso ya existe |
+| 422 | \`UNPROCESSABLE\` | Entidad no procesable |
+| 429 | \`RATE_LIMITED\` | Demasiados requests |
+| 500 | \`INTERNAL_ERROR\` | Error interno del servidor |
+
+**Formato de error**:
+\`\`\`json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Descripci\xF3n legible del error",
+    "details": [
+      { "field": "name", "message": "Name is required" }
+    ]
+  }
+}
+\`\`\`
+
+## ${t("rateLimitTitle")}
+
+| Tier | Requests/minuto | Burst |
+|------|-----------------|-------|
+| ${t("rateStandard")} | 60 | 10 |
+| ${t("ratePremium")} | 300 | 50 |
+
+${t("rateHeaders")}
+- \`X-RateLimit-Limit\`: L\xEDmite por ventana
+- \`X-RateLimit-Remaining\`: Requests restantes
+- \`X-RateLimit-Reset\`: Timestamp cuando se resetea
+
+## ${t("versioningTitle")}
+
+${t("versioningDesc")}
+`;
+}
+
+// src/generators/environment-setup/labels/es.ts
+var labels11 = {
+  fmType: "tutorial",
+  fmTags: "tutorial, environment, setup, herramientas",
+  title: "Configuraci\xF3n del Entorno de Desarrollo",
+  intro: "Gu\xEDa paso a paso para configurar tu entorno de desarrollo. Al terminar, tendr\xE1s todas las herramientas necesarias para trabajar en el proyecto.",
+  time: "**Tiempo estimado**",
+  audience: "**Audiencia**",
+  osTab: "SO",
+  toolTab: "Herramienta",
+  versionTab: "Versi\xF3n",
+  howTab: "Instalaci\xF3n",
+  step1Title: "1. Lenguaje de programaci\xF3n",
+  step1Desc: "El proyecto usa **[LENGUAJE]** [versi\xF3n]. Verificar versi\xF3n:",
+  step1Install: "Si no lo ten\xE9s, instalar desde [enlace oficial].",
+  step2Title: "2. Git",
+  step2Desc: "Git es obligatorio para el control de versiones.",
+  step2Check: "Verificar instalaci\xF3n:",
+  step2Config: "Configurar usuario (solo la primera vez):",
+  step3Title: "3. Package Manager",
+  step3Desc: "El proyecto usa **[PACKAGE_MANAGER]**.",
+  step3Check: "Verificar instalaci\xF3n:",
+  step4Title: "4. Editor de c\xF3digo",
+  step4Desc: "Recomendamos **VS Code** con las siguientes extensiones:",
+  step4Ext1: "**[extensi\xF3n 1]** \u2014 [descripci\xF3n]",
+  step4Ext2: "**[extensi\xF3n 2]** \u2014 [descripci\xF3n]",
+  step4Ext3: "**[extensi\xF3n 3]** \u2014 [descripci\xF3n]",
+  step4Ext4: "**[extensi\xF3n 4]** \u2014 [descripci\xF3n]",
+  step5Title: "5. Docker (opcional)",
+  step5Desc: "Si el proyecto usa Docker para desarrollo local:",
+  step5Check: "Verificar instalaci\xF3n:",
+  step6Title: "6. Base de datos (opcional)",
+  step6Desc: "Si el proyecto usa base de datos local:",
+  step6Install: "**[Herramienta de DB]** \u2014 instalar desde [enlace]",
+  step6Client: "Cliente recomendado: **[cliente de DB]** ([enlace])",
+  verifyTitle: "Verificaci\xF3n final",
+  verifyDesc: "Ejecutar estos comandos para confirmar que todo funciona:",
+  verifyCmd1: "[comando de verificaci\xF3n 1]",
+  verifyCmd2: "[comando de verificaci\xF3n 2]",
+  verifyCmd3: "[comando de verificaci\xF3n 3]",
+  nextTitle: "Siguientes pasos",
+  next1: "Para arrancar el proyecto por primera vez: [`quick-start.md`](quick-start.md)",
+  next2: "Para hacer tu primera contribuci\xF3n (branch \u2192 c\xF3digo \u2192 PR): [`first-task.md`](first-task.md)"
+};
+
+// src/generators/environment-setup/labels/en.ts
+var labels12 = {
+  fmType: "tutorial",
+  fmTags: "tutorial, environment, setup, tools",
+  title: "Development Environment Setup",
+  intro: "Step-by-step guide to configure your development environment. When done, you'll have all the tools needed to work on the project.",
+  time: "**Estimated time**",
+  audience: "**Audience**",
+  osTab: "OS",
+  toolTab: "Tool",
+  versionTab: "Version",
+  howTab: "Installation",
+  step1Title: "1. Programming Language",
+  step1Desc: "The project uses **[LANGUAGE]** [version]. Verify version:",
+  step1Install: "If not installed, install from [official link].",
+  step2Title: "2. Git",
+  step2Desc: "Git is required for version control.",
+  step2Check: "Verify installation:",
+  step2Config: "Configure user (first time only):",
+  step3Title: "3. Package Manager",
+  step3Desc: "The project uses **[PACKAGE_MANAGER]**.",
+  step3Check: "Verify installation:",
+  step4Title: "4. Code Editor",
+  step4Desc: "We recommend **VS Code** with the following extensions:",
+  step4Ext1: "**[extension 1]** \u2014 [description]",
+  step4Ext2: "**[extension 2]** \u2014 [description]",
+  step4Ext3: "**[extension 3]** \u2014 [description]",
+  step4Ext4: "**[extension 4]** \u2014 [description]",
+  step5Title: "5. Docker (optional)",
+  step5Desc: "If the project uses Docker for local development:",
+  step5Check: "Verify installation:",
+  step6Title: "6. Database (optional)",
+  step6Desc: "If the project uses a local database:",
+  step6Install: "**[DB Tool]** \u2014 install from [link]",
+  step6Client: "Recommended client: **[DB client]** ([link])",
+  verifyTitle: "Final Verification",
+  verifyDesc: "Run these commands to confirm everything works:",
+  verifyCmd1: "[verification command 1]",
+  verifyCmd2: "[verification command 2]",
+  verifyCmd3: "[verification command 3]",
+  nextTitle: "Next Steps",
+  next1: "To start the project for the first time: [`quick-start.md`](quick-start.md)",
+  next2: "To make your first contribution (branch \u2192 code \u2192 PR): [`first-task.md`](first-task.md)"
+};
+
+// src/generators/environment-setup/generator.ts
+registerLabels("environment-setup", "es", labels11);
+registerLabels("environment-setup", "en", labels12);
+function generate6(options) {
+  const labels31 = loadLabels("environment-setup", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+${t("time")}: 30-60 minutos.
+${t("audience")}: Developers que se incorporan al proyecto.
+
+---
+
+| ${t("osTab")} | ${t("toolTab")} | ${t("versionTab")} | ${t("howTab")} |
+|-----|-------|--------|-----------|
+| Windows / Mac / Linux | **[Lenguaje]** | [versi\xF3n] | [enlace oficial] |
+| Windows / Mac / Linux | **Git** | 2.40+ | [git-scm.com](https://git-scm.com) |
+| Windows / Mac / Linux | **[Package Manager]** | [versi\xF3n] | Viene con el lenguaje |
+| Windows / Mac / Linux | **VS Code** | Latest | [code.visualstudio.com](https://code.visualstudio.com) |
+
+---
+
+## ${t("step1Title")}
+
+${t("step1Desc")}
+
+\`\`\`bash
+[comando para verificar versi\xF3n \u2014 ej. node --version]
+\`\`\`
+
+${t("step1Install")}
+
+---
+
+## ${t("step2Title")}
+
+${t("step2Desc")}
+
+${t("step2Check")}
+
+\`\`\`bash
+git --version
+# Deber\xEDa mostrar: git version 2.40+
+\`\`\`
+
+${t("step2Config")}
+
+\`\`\`bash
+git config --global user.name "Tu Nombre"
+git config --global user.email "tu@email.com"
+\`\`\`
+
+---
+
+## ${t("step3Title")}
+
+${t("step3Desc")}
+
+${t("step3Check")}
+
+\`\`\`bash
+[npm --version]
+# Deber\xEDa mostrar: [versi\xF3n esperada]
+\`\`\`
+
+---
+
+## ${t("step4Title")}
+
+${t("step4Desc")}
+
+- ${t("step4Ext1")}
+- ${t("step4Ext2")}
+- ${t("step4Ext3")}
+- ${t("step4Ext4")}
+
+---
+
+${options.conditionCtx.hasDocker ? `## ${t("step5Title")}
+
+${t("step5Desc")}
+
+${t("step5Check")}
+
+\`\`\`bash
+docker --version
+docker compose version
+\`\`\`
+` : ""}
+---
+
+${options.conditionCtx.hasDatabase ? `## ${t("step6Title")}
+
+${t("step6Desc")}
+
+- ${t("step6Install")}
+- ${t("step6Client")}
+` : ""}
+---
+
+## ${t("verifyTitle")}
+
+${t("verifyDesc")}
+
+\`\`\`bash
+${t("verifyCmd1")}
+${t("verifyCmd2")}
+${t("verifyCmd3")}
+\`\`\`
+
+---
+
+## ${t("nextTitle")}
+
+- ${t("next1")}
+- ${t("next2")}
+`;
+}
+
+// src/generators/first-task/labels/es.ts
+var labels13 = {
+  fmType: "tutorial",
+  fmTags: "tutorial, first-task, contribucion",
+  title: "Primera Tarea \u2014 Tu primera contribuci\xF3n",
+  intro: "Este tutorial te gu\xEDa en tu primera contribuci\xF3n: desde elegir una tarea hasta mergear el PR. Al terminar, habr\xE1s completado el flujo completo de trabajo.",
+  time: "**Tiempo estimado**",
+  audience: "**Audiencia**",
+  prereq: "Haber completado [`quick-start.md`](quick-start.md) y [`environment-setup.md`](environment-setup.md).",
+  step1: "1. Elegir una tarea",
+  step1Good: "Buenas primeras tareas: **issues etiquetados**",
+  step2: "2. Crear una branch",
+  step2Desc: "Siempre crear una branch desde `main`:",
+  step3: "3. Implementar",
+  step3Tests: "Asegurate de que los tests pasen:",
+  step3Lint: "Y que el linter est\xE9 limpio:",
+  step4: "4. Commitear los cambios",
+  step4Format: "Usar Conventional Commits en espa\xF1ol:",
+  step5: "5. Crear un Pull Request",
+  step5Desc: "Push de la branch y crear PR en GitHub.",
+  step5Template: "**Template de PR**:",
+  step6: "6. Revisi\xF3n de c\xF3digo",
+  step6Desc: "Un maintainer revisar\xE1 tu PR.",
+  checklist: "**Checklist antes de enviar el PR**:",
+  next: "Felicidades",
+  nextDesc: "Completaste tu primera contribuci\xF3n. Ahora pod\xE9s tomar tareas m\xE1s grandes."
+};
+
+// src/generators/first-task/labels/en.ts
+var labels14 = {
+  fmType: "tutorial",
+  fmTags: "tutorial, first-task, contribution",
+  title: "First Task \u2014 Your First Contribution",
+  intro: "This tutorial guides you through your first contribution: from choosing a task to merging the PR. When done, you'll have completed the full workflow.",
+  time: "**Estimated time**",
+  audience: "**Audience**",
+  prereq: "Completed [`quick-start.md`](quick-start.md) and [`environment-setup.md`](environment-setup.md).",
+  step1: "1. Choose a task",
+  step1Good: "Good first issues: **tagged issues**",
+  step2: "2. Create a branch",
+  step2Desc: "Always create a branch from `main`:",
+  step3: "3. Implement",
+  step3Tests: "Make sure tests pass:",
+  step3Lint: "And the linter is clean:",
+  step4: "4. Commit changes",
+  step4Format: "Use Conventional Commits in English:",
+  step5: "5. Create a Pull Request",
+  step5Desc: "Push the branch and create PR on GitHub.",
+  step5Template: "**PR Template**:",
+  step6: "6. Code Review",
+  step6Desc: "A maintainer will review your PR.",
+  checklist: "**Checklist before submitting PR**:",
+  next: "Congratulations",
+  nextDesc: "You completed your first contribution. Now you can take on larger tasks."
+};
+
+// src/generators/first-task/generator.ts
+registerLabels("first-task", "es", labels13);
+registerLabels("first-task", "en", labels14);
+function generate7(options) {
+  const labels31 = loadLabels("first-task", options.language);
+  const t = (key) => labels31[key] || `[${key}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+${t("time")}: 1-2 horas.
+${t("audience")}: Developers nuevos en el proyecto.
+
+> **Prerrequisitos**: ${t("prereq")}
+
+---
+
+## ${t("step1")}
+
+${t("step1Good")}:
+- \`good first issue\` \u2014 tareas introductorias
+- \`help wanted\` \u2014 tareas que necesitan ayuda
+- \`bug\` \u2014 bugs confirmados
+
+Asignate la tarea en GitHub y movela a "In Progress".
+
+---
+
+## ${t("step2")}
+
+${t("step2Desc")}
+
+\`\`\`bash
+git checkout main
+git pull origin main
+git checkout -b feature/mi-primera-tarea
+\`\`\`
+
+---
+
+## ${t("step3")}
+
+${t("step3Tests")}
+
+\`\`\`bash
+[npm run test]
+\`\`\`
+
+${t("step3Lint")}
+
+\`\`\`bash
+[npm run lint]
+\`\`\`
+
+---
+
+## ${t("step4")}
+
+${t("step4Format")}
+
+\`\`\`bash
+git add -A
+git commit -m "feat(scope): descripci\xF3n corta de lo que hiciste"
+\`\`\`
+
+---
+
+## ${t("step5")}
+
+${t("step5Desc")}
+
+\`\`\`bash
+git push origin feature/mi-primera-tarea
+\`\`\`
+
+${t("step5Template")}
+
+\`\`\`markdown
+## Descripci\xF3n
+[Qu\xE9 cambia y por qu\xE9]
+
+## Tipo de cambio
+- [ ] Bug fix
+- [ ] Feature nueva
+- [ ] Refactor
+- [ ] Documentaci\xF3n
+
+## C\xF3mo probarlo
+1. [Paso 1]
+2. [Paso 2]
+
+## Screenshots (si aplica)
+\`\`\`
+
+---
+
+## ${t("step6")}
+
+${t("step6Desc")}
+- Respond\xE9 a los comentarios
+- Hac\xE9 los cambios solicitados
+- El PR se mergea cuando recibe approve
+
+${t("checklist")}
+- [ ] Tests pasan
+- [ ] Linter limpio
+- [ ] PR description completa
+- [ ] No hay secrets commiteados
+- [ ] La branch est\xE1 actualizada con \`main\`
+
+---
+
+## ${t("next")} \u{1F389}
+
+${t("nextDesc")}
+- Ver el [roadmap](../product/roadmap.md) para features planeadas
+- Leer la [arquitectura](../explanation/architecture.md) para entender el sistema
+`;
+}
+
+// src/generators/deployment/labels/es.ts
+var labels15 = {
+  fmType: "guide",
+  fmTags: "guide, deploy, production",
+  title: "Gu\xEDa de Deployment",
+  intro: "Procedimiento para desplegar la aplicaci\xF3n en producci\xF3n.",
+  envTitle: "Entornos",
+  envDev: "Desarrollo",
+  envDevDesc: "Local, hot-reload activo.",
+  envStaging: "Staging",
+  envStagingDesc: "Pre-producci\xF3n, datos de prueba.",
+  envProd: "Producci\xF3n",
+  envProdDesc: "Entorno live, datos reales.",
+  prereq: "Prerrequisitos",
+  prereqItems: "Acceso a [plataforma de deploy]. Variables de entorno configuradas.",
+  step1: "1. Preparar el build",
+  step1Desc: "Ejecutar el build de producci\xF3n:",
+  step2: "2. Verificar tests",
+  step2Desc: "Todos los tests deben pasar antes de deployar:",
+  step3: "3. Deploy",
+  step3Desc: "Ejecutar el comando de deploy:",
+  step4: "4. Verificar health",
+  step4Desc: "Confirmar que la aplicaci\xF3n responde:",
+  rollback: "Rollback",
+  rollbackDesc: "Si algo falla, revertir al \xFAltimo deploy estable:",
+  monitoring: "Monitoreo post-deploy",
+  monitoringDesc: "Verificar m\xE9tricas en [dashboard de monitoreo]."
+};
+
+// src/generators/deployment/labels/en.ts
+var labels16 = {
+  fmType: "guide",
+  fmTags: "guide, deploy, production",
+  title: "Deployment Guide",
+  intro: "Procedure to deploy the application to production.",
+  envTitle: "Environments",
+  envDev: "Development",
+  envDevDesc: "Local, hot-reload active.",
+  envStaging: "Staging",
+  envStagingDesc: "Pre-production, test data.",
+  envProd: "Production",
+  envProdDesc: "Live environment, real data.",
+  prereq: "Prerequisites",
+  prereqItems: "Access to [deploy platform]. Environment variables configured.",
+  step1: "1. Prepare the build",
+  step1Desc: "Run the production build:",
+  step2: "2. Verify tests",
+  step2Desc: "All tests must pass before deploying:",
+  step3: "3. Deploy",
+  step3Desc: "Run the deploy command:",
+  step4: "4. Verify health",
+  step4Desc: "Confirm the application responds:",
+  rollback: "Rollback",
+  rollbackDesc: "If something fails, revert to the last stable deploy:",
+  monitoring: "Post-deploy Monitoring",
+  monitoringDesc: "Check metrics at [monitoring dashboard].",
+  dockerDeploy: "Docker",
+  dockerBuild: "docker build -t app .",
+  dockerRun: "docker compose up -d",
+  ciDesc: "CI/CD pipeline \u2014 el deploy se ejecuta autom\xE1ticamente al mergear a main.",
+  healthCheck: "curl https://[url]/health \u2192 200 OK"
+};
+
+// src/generators/deployment/generator.ts
+registerLabels("deployment", "es", labels15);
+registerLabels("deployment", "en", labels16);
+function generate8(options) {
+  const t = (k) => loadLabels("deployment", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const hasDocker = options.conditionCtx.hasDocker;
+  const hasCI = options.conditionCtx.hasCI;
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## ${t("envTitle")}
+
+| Entorno | URL | Rama | Descripci\xF3n |
+|---------|-----|------|-------------|
+| ${t("envDev")} | http://localhost:3000 | \u2014 | ${t("envDevDesc")} |
+| ${t("envStaging")} | [URL de staging] | \`develop\` | ${t("envStagingDesc")} |
+| ${t("envProd")} | [URL de producci\xF3n] | \`main\` | ${t("envProdDesc")} |
+
+## ${t("prereq")}
+
+- ${t("prereqItems")}
+
+## ${t("step1")}
+
+${t("step1Desc")}
+
+\`\`\`bash
+[comando de build]
+\`\`\`
+
+## ${t("step2")}
+
+${t("step2Desc")}
+
+\`\`\`bash
+[comando de test]
+\`\`\`
+${hasDocker ? `
+## ${t("dockerDeploy")}
+
+\`\`\`bash
+${t("dockerBuild")}
+${t("dockerRun")}
+\`\`\`
+` : ""}
+## ${t("step3")}
+
+${t("step3Desc")}
+${hasCI ? `
+> \u2139\uFE0F ${t("ciDesc")}
+` : `
+\`\`\`bash
+[comando de deploy manual]
+\`\`\`
+`}
+## ${t("step4")}
+
+${t("step4Desc")}
+
+\`\`\`bash
+${t("healthCheck")}
+\`\`\`
+
+## ${t("rollback")}
+
+${t("rollbackDesc")}
+
+\`\`\`bash
+[comando de rollback]
+\`\`\`
+
+## ${t("monitoring")}
+
+${t("monitoringDesc")}
+`;
+}
+
+// src/generators/troubleshooting/labels/es.ts
+var labels17 = {
+  fmType: "guide",
+  fmTags: "guide, troubleshooting, debugging",
+  title: "Gu\xEDa de Troubleshooting",
+  intro: "Soluciones a problemas comunes durante el desarrollo.",
+  prob1: "Problema 1",
+  prob1Desc: "[Descripci\xF3n del problema com\xFAn #1]",
+  prob1Fix: "[Soluci\xF3n #1]",
+  prob2: "Problema 2",
+  prob2Desc: "[Descripci\xF3n del problema com\xFAn #2]",
+  prob2Fix: "[Soluci\xF3n #2]",
+  prob3: "Problema 3",
+  prob3Desc: "[Descripci\xF3n del problema com\xFAn #3]",
+  prob3Fix: "[Soluci\xF3n #3]",
+  logs: "C\xF3mo obtener logs",
+  logsDesc: "Para debuggear, aumentar el nivel de logs:",
+  support: "\xBFNo encontraste la soluci\xF3n?",
+  supportDesc: "Crear un issue en GitHub con logs y pasos para reproducir."
+};
+var en = {
+  title: "Troubleshooting Guide",
+  intro: "Solutions to common development problems.",
+  prob1: "Problem 1",
+  prob1Desc: "[Description of common problem #1]",
+  prob1Fix: "[Solution #1]",
+  prob2: "Problem 2",
+  prob2Desc: "[Description of common problem #2]",
+  prob2Fix: "[Solution #2]",
+  prob3: "Problem 3",
+  prob3Desc: "[Description of common problem #3]",
+  prob3Fix: "[Solution #3]",
+  logs: "How to get logs",
+  logsDesc: "To debug, increase log level:",
+  support: "Didn't find a solution?",
+  supportDesc: "Create a GitHub issue with logs and reproduction steps.",
+  fmType: "guide",
+  fmTags: "guide, troubleshooting, debugging"
+};
+
+// src/generators/troubleshooting/generator.ts
+registerLabels("troubleshooting", "es", labels17);
+registerLabels("troubleshooting", "en", { ...labels17, ...en });
+function generate9(options) {
+  const t = (k) => loadLabels("troubleshooting", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+---
+
+## ${t("prob1")}
+
+**S\xEDntoma**: ${t("prob1Desc")}
+
+**Soluci\xF3n**: ${t("prob1Fix")}
+
+---
+
+## ${t("prob2")}
+
+**S\xEDntoma**: ${t("prob2Desc")}
+
+**Soluci\xF3n**: ${t("prob2Fix")}
+
+---
+
+## ${t("prob3")}
+
+**S\xEDntoma**: ${t("prob3Desc")}
+
+**Soluci\xF3n**: ${t("prob3Fix")}
+
+---
+
+## ${t("logs")}
+
+${t("logsDesc")}
+
+\`\`\`bash
+[comando para ver logs]
+\`\`\`
+
+---
+
+## ${t("support")}
+
+${t("supportDesc")}
+`;
+}
+
+// src/generators/runbooks/labels/es.ts
+var labels18 = {
+  fmType: "how-to",
+  fmTags: "runbook, operations, incident",
+  title: "Runbook: [NOMBRE DEL PROCEDIMIENTO]",
+  intro: "Procedimiento operativo para resolver [incidente].",
+  owner: "Owner",
+  severity: "Severidad",
+  time: "Tiempo estimado",
+  prereq: "Prerrequisitos",
+  steps: "Pasos",
+  verification: "Verificaci\xF3n",
+  rollback: "Rollback",
+  notes: "Notas"
+};
+var en2 = {
+  title: "Runbook: [PROCEDURE NAME]",
+  intro: "Operational procedure to resolve [incident].",
+  owner: "Owner",
+  severity: "Severity",
+  time: "Estimated time",
+  prereq: "Prerequisites",
+  steps: "Steps",
+  verification: "Verification",
+  rollback: "Rollback",
+  notes: "Notes",
+  fmType: "how-to",
+  fmTags: "runbook, operations, incident"
+};
+
+// src/generators/runbooks/generator.ts
+registerLabels("runbooks", "es", labels18);
+registerLabels("runbooks", "en", { ...labels18, ...en2 });
+function generate10(options) {
+  const t = (k) => loadLabels("runbooks", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+| Campo | Valor |
+|-------|-------|
+| ${t("owner")} | [Equipo responsable] |
+| ${t("severity")} | [Cr\xEDtica / Alta / Media / Baja] |
+| ${t("time")} | [X minutos] |
+
+## ${t("prereq")}
+- [Requisito 1]
+- [Requisito 2]
+
+## ${t("steps")}
+1. [Paso 1]
+2. [Paso 2]
+3. [Paso 3]
+
+## ${t("verification")}
+- [C\xF3mo verificar que el procedimiento funcion\xF3]
+
+## ${t("rollback")}
+- [Pasos para revertir si algo falla]
+
+## ${t("notes")}
+- [Notas adicionales]
+`;
+}
+
+// src/generators/configuration/labels/es.ts
+var labels19 = {
+  fmType: "reference",
+  fmTags: "configuration, reference, env",
+  title: "Referencia de Configuraci\xF3n",
+  intro: "Referencia completa de todas las variables de configuraci\xF3n del proyecto.",
+  required: "Variables obligatorias",
+  optional: "Variables opcionales",
+  envName: "Variable",
+  envDesc: "Descripci\xF3n",
+  envDefault: "Default",
+  envRequired: "Requerida",
+  secrets: "Gesti\xF3n de secretos",
+  secretsDesc: "Nunca commitear valores reales al repositorio.",
+  dotenv: "Archivos .env"
+};
+var en3 = {
+  fmType: "reference",
+  fmTags: "configuration, reference, env",
+  title: "Configuration Reference",
+  intro: "Complete reference of all project configuration variables.",
+  required: "Required Variables",
+  optional: "Optional Variables",
+  envName: "Variable",
+  envDesc: "Description",
+  envDefault: "Default",
+  envRequired: "Required",
+  secrets: "Secret Management",
+  secretsDesc: "Never commit real values to the repository.",
+  dotenv: ".env Files"
+};
+
+// src/generators/configuration/generator.ts
+registerLabels("configuration", "es", labels19);
+registerLabels("configuration", "en", { ...labels19, ...en3 });
+function generate11(options) {
+  const t = (k) => loadLabels("configuration", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## ${t("required")}
+
+| ${t("envName")} | ${t("envDesc")} | ${t("envDefault")} | ${t("envRequired")} |
+|-------|-----------|--------|--------|
+| \`APP_ENV\` | Entorno actual | \`development\` | S\xED |
+| \`APP_PORT\` | Puerto | \`3000\` | No |
+| \`[VARIABLE_1]\` | [Descripci\xF3n] | \u2014 | S\xED |
+| \`[VARIABLE_2]\` | [Descripci\xF3n] | [default] | S\xED |
+
+## ${t("optional")}
+
+| ${t("envName")} | ${t("envDesc")} | ${t("envDefault")} | ${t("envRequired")} |
+|-------|-----------|--------|--------|
+| \`LOG_LEVEL\` | Nivel de log | \`debug\` | No |
+| \`[VARIABLE_3]\` | [Descripci\xF3n] | [default] | No |
+
+## ${t("secrets")}
+
+${t("secretsDesc")}
+
+- Usar \`.env.example\` como template para documentar qu\xE9 variables existen.
+- En CI/CD, inyectar secretos v\xEDa [GitHub Secrets / Vault / etc.].
+
+## ${t("dotenv")}
+
+| Archivo | Prop\xF3sito | \xBFCommiteado? |
+|---------|----------|-------------|
+| \`.env.example\` | Template documentando todas las variables | \u2705 S\xED |
+| \`.env\` | Valores locales de desarrollo | \u274C No |
+| \`.env.production\` | Valores de producci\xF3n | \u274C No |
+`;
+}
+
+// src/generators/infrastructure/labels/es.ts
+var labels20 = {
+  fmType: "reference",
+  fmTags: "infrastructure, reference, deploy",
+  title: "Infraestructura",
+  intro: "Documentaci\xF3n de la infraestructura del proyecto.",
+  hosting: "Hosting",
+  hostingDesc: "**[Proveedor de hosting]** \u2014 [plan/regi\xF3n]",
+  ci: "CI/CD",
+  ciDesc: "**[Plataforma de CI]** \u2014 [plan]",
+  db: "Base de datos",
+  dbDesc: "**[Motor de base de datos]** \u2014 [versi\xF3n/plan]",
+  cache: "Cache",
+  cacheDesc: "**[Redis / Memcached / etc.]**",
+  storage: "Almacenamiento",
+  storageDesc: "**[S3 / Cloud Storage / etc.]**",
+  monitoring: "Monitoreo",
+  monitoringDesc: "**[Herramienta de monitoreo]**",
+  domains: "Dominios",
+  scaling: "Escalabilidad"
+};
+var en4 = {
+  fmType: "reference",
+  fmTags: "infrastructure, reference, deploy",
+  title: "Infrastructure",
+  intro: "Project infrastructure documentation.",
+  hosting: "Hosting",
+  hostingDesc: "**[Hosting provider]** \u2014 [plan/region]",
+  ci: "CI/CD",
+  ciDesc: "**[CI platform]** \u2014 [plan]",
+  db: "Database",
+  dbDesc: "**[Database engine]** \u2014 [version/plan]",
+  cache: "Cache",
+  cacheDesc: "**[Redis / Memcached / etc.]**",
+  storage: "Storage",
+  storageDesc: "**[S3 / Cloud Storage / etc.]**",
+  monitoring: "Monitoring",
+  monitoringDesc: "**[Monitoring tool]**",
+  domains: "Domains",
+  scaling: "Scalability"
+};
+
+// src/generators/infrastructure/generator.ts
+registerLabels("infrastructure", "es", labels20);
+registerLabels("infrastructure", "en", { ...labels20, ...en4 });
+function generate12(options) {
+  const t = (k) => loadLabels("infrastructure", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## ${t("hosting")}
+
+${t("hostingDesc")}
+
+## ${t("ci")}
+
+${t("ciDesc")}
+${options.conditionCtx.hasCI ? `
+- Pipeline configurado en \`.github/workflows/\`
+- Incluye: lint \u2192 test \u2192 build \u2192 deploy` : ""}
+
+## ${t("db")}
+
+${t("dbDesc")}
+${options.conditionCtx.hasDatabase ? `
+- Migraciones gestionadas con **[herramienta de migraciones]**
+- Backups: [frecuencia y ubicaci\xF3n]` : ""}
+
+## ${t("cache")}
+
+${t("cacheDesc")}
+
+## ${t("storage")}
+
+${t("storageDesc")}
+
+## ${t("monitoring")}
+
+${t("monitoringDesc")}
+
+## ${t("domains")}
+
+| Entorno | Dominio |
+|---------|---------|
+| Producci\xF3n | [app.dominio.com] |
+| Staging | [staging.dominio.com] |
+
+## ${t("scaling")}
+
+- [Estrategia de escalado]
+- [L\xEDmites actuales]
+`;
+}
+
+// src/generators/code-style/labels/es.ts
+var labels21 = {
+  fmType: "reference",
+  fmTags: "code-style, reference, conventions",
+  title: "Gu\xEDa de Estilo de C\xF3digo",
+  intro: "Convenciones de c\xF3digo del proyecto.",
+  naming: "Nombramiento",
+  namingDesc: "camelCase para variables/funciones, PascalCase para tipos/clases.",
+  formatting: "Formateo",
+  formattingDesc: "Usamos [Prettier / formatter] con la configuraci\xF3n del proyecto.",
+  imports: "Imports",
+  importsDesc: "Orden: built-in \u2192 externos \u2192 internos. Usar imports con nombre.",
+  types: "Tipos",
+  typesDesc: "Usar TypeScript strict. Evitar `any`. Preferir interfaces sobre types.",
+  comments: "Comentarios",
+  commentsDesc: "En espa\xF1ol. Explicar el POR QU\xC9, no el QU\xC9.",
+  errors: "Manejo de errores",
+  errorsDesc: "Usar Result types o excepciones tipadas.",
+  testing: "Testing",
+  testingDesc: "1 archivo de test por m\xF3dulo. Nombre: `[modulo].test.ts`."
+};
+var en5 = {
+  fmType: "reference",
+  fmTags: "code-style, reference, conventions",
+  title: "Code Style Guide",
+  intro: "Project code conventions.",
+  naming: "Naming",
+  namingDesc: "camelCase for variables/functions, PascalCase for types/classes.",
+  formatting: "Formatting",
+  formattingDesc: "We use [Prettier / formatter] with project config.",
+  imports: "Imports",
+  importsDesc: "Order: built-in \u2192 external \u2192 internal. Use named imports.",
+  types: "Types",
+  typesDesc: "Use TypeScript strict. Avoid `any`. Prefer interfaces over types.",
+  comments: "Comments",
+  commentsDesc: "In English. Explain the WHY, not the WHAT.",
+  errors: "Error Handling",
+  errorsDesc: "Use Result types or typed exceptions.",
+  testing: "Testing",
+  testingDesc: "1 test file per module. Name: `[module].test.ts`."
+};
+
+// src/generators/code-style/generator.ts
+registerLabels("code-style", "es", labels21);
+registerLabels("code-style", "en", { ...labels21, ...en5 });
+function generate13(options) {
+  const t = (k) => loadLabels("code-style", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## ${t("naming")}
+
+${t("namingDesc")}
+
+## ${t("formatting")}
+
+${t("formattingDesc")}
+
+## ${t("imports")}
+
+${t("importsDesc")}
+
+## ${t("types")}
+
+${t("typesDesc")}
+
+## ${t("comments")}
+
+${t("commentsDesc")}
+
+## ${t("errors")}
+
+${t("errorsDesc")}
+
+## ${t("testing")}
+
+${t("testingDesc")}
+`;
 }
-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/generators/architecture/labels/es.ts
+var labels22 = {
+  fmType: "explanation",
+  fmTags: "architecture, explanation, design",
+  title: "Arquitectura del Sistema",
+  intro: "Explica la arquitectura del proyecto \u2014 no c\xF3mo usarlo, sino por qu\xE9 est\xE1 dise\xF1ado as\xED.",
+  overview: "Visi\xF3n General",
+  components: "Componentes Principales",
+  decisions: "Decisiones Clave",
+  limits: "L\xEDmites del Sistema",
+  deps: "Dependencias Externas"
+};
+var en6 = {
+  fmType: "explanation",
+  fmTags: "architecture, explanation, design",
+  title: "System Architecture",
+  intro: "Explains the project architecture \u2014 not how to use it, but why it's designed this way.",
+  overview: "Overview",
+  components: "Main Components",
+  decisions: "Key Decisions",
+  limits: "System Limits",
+  deps: "External Dependencies"
+};
+
+// src/generators/architecture/generator.ts
+registerLabels("architecture", "es", labels22);
+registerLabels("architecture", "en", { ...labels22, ...en6 });
+function generate14(options) {
+  const t = (k) => loadLabels("architecture", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## ${t("overview")}
+
+[Descripci\xF3n general del sistema en 2-3 p\xE1rrafos \u2014 qu\xE9 hace, para qui\xE9n, stack principal.]
+
+\`\`\`mermaid
+flowchart TD
+    Client["Cliente"] --> API["API"]
+    API --> DB["Base de datos"]
+    API --> Cache["Cache"]
+\`\`\`
+
+## ${t("components")}
+
+| Componente | Tecnolog\xEDa | Responsabilidad |
+|-----------|-----------|----------------|
+| **[Componente 1]** | [Tecnolog\xEDa] | [Qu\xE9 hace] |
+| **[Componente 2]** | [Tecnolog\xEDa] | [Qu\xE9 hace] |
+| **[Componente 3]** | [Tecnolog\xEDa] | [Qu\xE9 hace] |
+
+## ${t("decisions")}
+
+| Decisi\xF3n | Raz\xF3n |
+|----------|-------|
+| **[Tecnolog\xEDa X]** | [Por qu\xE9 se eligi\xF3] |
+| **[Patr\xF3n Y]** | [Por qu\xE9 se usa] |
+
+## ${t("limits")}
+
+- No es responsable de [X]
+- No escala horizontalmente sin [Y]
+- L\xEDmite de [Z requests/minuto]
+
+## ${t("deps")}
+
+| Dependencia | Versi\xF3n | Prop\xF3sito | Cr\xEDtica |
+|------------|--------|----------|--------|
+| **[Dep 1]** | [ver] | [qu\xE9 hace] | S\xED |
+| **[Dep 2]** | [ver] | [qu\xE9 hace] | No |
+`;
 }
 
-// src/generator.ts
-import path3 from "path";
-import { fileURLToPath } from "url";
+// src/generators/design/labels/es.ts
+var labels23 = {
+  fmType: "product",
+  fmTags: "design, tokens, theme",
+  title: "Sistema de Dise\xF1o",
+  intro: "Documentaci\xF3n de los tokens y patrones visuales del proyecto.",
+  colors: "Colores",
+  typography: "Tipograf\xEDa",
+  spacing: "Espaciado",
+  elevation: "Elevaci\xF3n",
+  components: "Componentes"
+};
+var en7 = {
+  fmType: "product",
+  fmTags: "design, tokens, theme",
+  title: "Design System",
+  intro: "Documentation of the project's visual tokens and patterns.",
+  colors: "Colors",
+  typography: "Typography",
+  spacing: "Spacing",
+  elevation: "Elevation",
+  components: "Components"
+};
 
-// src/utils/fs.ts
-import fs2 from "fs";
-import path2 from "path";
-function ensureDir(dirPath) {
-  if (!fs2.existsSync(dirPath)) {
-    fs2.mkdirSync(dirPath, { recursive: true });
-  }
+// src/generators/design/generator.ts
+registerLabels("design", "es", labels23);
+registerLabels("design", "en", { ...labels23, ...en7 });
+function generate15(options) {
+  const t = (k) => loadLabels("design", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## \u{1F3A8} ${t("colors")}
+
+| Token | Color | Uso |
+|-------|-------|-----|
+| \`--color-primary\` | \`#XXXXXX\` | Color principal |
+| \`--color-secondary\` | \`#XXXXXX\` | Color secundario |
+| \`--color-background\` | \`#XXXXXX\` | Fondo general |
+| \`--color-text\` | \`#XXXXXX\` | Texto principal |
+| \`--color-muted\` | \`#XXXXXX\` | Texto secundario |
+
+## \u270F\uFE0F ${t("typography")}
+
+| Token | Font | Size | Weight |
+|-------|------|------|--------|
+| \`--font-family\` | [Font] | \u2014 | \u2014 |
+| \`--text-xs\` | \u2014 | 0.75rem | \u2014 |
+| \`--text-base\` | \u2014 | 1rem | \u2014 |
+| \`--text-lg\` | \u2014 | 1.25rem | \u2014 |
+| \`--text-xl\` | \u2014 | 1.5rem | 700 |
+
+## \u{1F4CF} ${t("spacing")}
+
+| Token | Value |
+|-------|-------|
+| \`--space-1\` | 0.25rem |
+| \`--space-2\` | 0.5rem |
+| \`--space-4\` | 1rem |
+| \`--space-8\` | 2rem |
+
+## \u{1F3D4}\uFE0F ${t("elevation")}
+
+| Token | Shadow |
+|-------|--------|
+| \`--shadow-sm\` | \`0 1px 2px rgba(0,0,0,0.05)\` |
+| \`--shadow-md\` | \`0 4px 6px rgba(0,0,0,0.1)\` |
+| \`--shadow-lg\` | \`0 10px 15px rgba(0,0,0,0.1)\` |
+
+## \u{1F9E9} ${t("components")}
+
+[Documentar componentes clave del sistema de dise\xF1o aqu\xED.]
+`;
 }
-function writeFile(filePath, content) {
-  ensureDir(path2.dirname(filePath));
-  fs2.writeFileSync(filePath, content, "utf-8");
+
+// src/generators/overview/labels/es.ts
+var labels24 = {
+  fmType: "product",
+  fmTags: "overview, product",
+  title: "Visi\xF3n General",
+  intro: "Resumen ejecutivo del proyecto.",
+  problem: "Problema",
+  solution: "Soluci\xF3n",
+  users: "Usuarios",
+  features: "Features principales"
+};
+var en8 = {
+  fmType: "product",
+  fmTags: "overview, product",
+  title: "Overview",
+  intro: "Executive summary of the project.",
+  problem: "Problem",
+  solution: "Solution",
+  users: "Users",
+  features: "Key Features"
+};
+
+// src/generators/overview/generator.ts
+registerLabels("overview", "es", labels24);
+registerLabels("overview", "en", { ...labels24, ...en8 });
+function generate16(options) {
+  const t = (k) => loadLabels("overview", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## ${t("problem")}
+
+[Qu\xE9 problema resuelve este proyecto. 2-3 p\xE1rrafos.]
+
+## ${t("solution")}
+
+[C\xF3mo lo resuelve. Incluir diagrama de alto nivel si aplica.]
+
+## ${t("users")}
+
+| Tipo de usuario | Necesidad principal |
+|----------------|-------------------|
+| **[Usuario 1]** | [Qu\xE9 necesita] |
+| **[Usuario 2]** | [Qu\xE9 necesita] |
+
+## ${t("features")}
+
+- **[Feature 1]**: [Descripci\xF3n corta]
+- **[Feature 2]**: [Descripci\xF3n corta]
+- **[Feature 3]**: [Descripci\xF3n corta]
+`;
 }
-function isDirEmpty(dirPath) {
-  if (!fs2.existsSync(dirPath)) return true;
-  const files = fs2.readdirSync(dirPath);
-  return files.length === 0 || files.length === 1 && files[0] === ".git";
+
+// src/generators/roadmap/labels/es.ts
+var labels25 = {
+  fmType: "product",
+  fmTags: "roadmap, planning",
+  title: "Roadmap",
+  intro: "Planificaci\xF3n de features y milestones del proyecto.",
+  now: "Ahora",
+  nowDesc: "En desarrollo activo.",
+  next: "Pr\xF3ximo",
+  nextDesc: "Siguiente en prioridad.",
+  later: "Futuro",
+  laterDesc: "Planeado, sin fecha.",
+  done: "Completado",
+  doneDesc: "Entregado."
+};
+var en9 = {
+  fmType: "product",
+  fmTags: "roadmap, planning",
+  title: "Roadmap",
+  intro: "Feature and milestone planning for the project.",
+  now: "Now",
+  nowDesc: "In active development.",
+  next: "Next",
+  nextDesc: "Next in priority.",
+  later: "Later",
+  laterDesc: "Planned, no date.",
+  done: "Done",
+  doneDesc: "Delivered."
+};
+
+// src/generators/roadmap/generator.ts
+registerLabels("roadmap", "es", labels25);
+registerLabels("roadmap", "en", { ...labels25, ...en9 });
+function generate17(options) {
+  const t = (k) => loadLabels("roadmap", options.language)[k] || `[${k}]`;
+  return `---
+created: "${options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## \u{1F504} ${t("now")}
+
+${t("nowDesc")}
+
+- [Feature actual 1]
+- [Feature actual 2]
+
+## \u23E9 ${t("next")}
+
+${t("nextDesc")}
+
+- [Feature planeada 1]
+- [Feature planeada 2]
+
+## \u{1F52E} ${t("later")}
+
+${t("laterDesc")}
+
+- [Idea futura 1]
+- [Idea futura 2]
+
+## \u2705 ${t("done")}
+
+${t("doneDesc")}
+
+- [Feature completada 1]
+`;
 }
-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);
-    }
-  }
+
+// src/generators/operations/labels/es.ts
+var labels26 = {
+  fmType: "operations",
+  fmTags: "operations, monitoring, incidents",
+  title: "Operaciones",
+  intro: "Documentaci\xF3n operativa del proyecto.",
+  monitoring: "Monitoreo",
+  alerts: "Alertas",
+  incidents: "Incidentes",
+  backups: "Backups"
+};
+var en10 = {
+  fmType: "operations",
+  fmTags: "operations, monitoring, incidents",
+  title: "Operations",
+  intro: "Project operations documentation.",
+  monitoring: "Monitoring",
+  alerts: "Alerts",
+  incidents: "Incidents",
+  backups: "Backups"
+};
+
+// src/generators/operations/generator.ts
+registerLabels("operations", "es", labels26);
+registerLabels("operations", "en", { ...labels26, ...en10 });
+function generate18(options) {
+  const t = (k) => loadLabels("operations", options.language)[k] || `[${k}]`;
+  return `---
+created: "${options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+## \u{1F4CA} ${t("monitoring")}
+
+- [Dashboard de monitoreo]: [URL]
+- M\xE9tricas clave: [latencia, error rate, throughput]
+- Logs: [herramienta de logs]
+
+## \u{1F6A8} ${t("alerts")}
+
+| Alerta | Severidad | Canal | Responsable |
+|--------|----------|-------|------------|
+| [Alerta 1] | Cr\xEDtica | PagerDuty | [Equipo] |
+| [Alerta 2] | Alta | Slack | [Equipo] |
+
+## \u{1F525} ${t("incidents")}
+
+Procedimiento de respuesta a incidentes:
+1. [Detectar y reconocer]
+2. [Escalar si es necesario]
+3. [Mitigar]
+4. [Resolver]
+5. [Post-mortem]
+
+Ver runbooks en [\`docs/guides/runbooks/\`](../guides/runbooks/).
+
+## \u{1F4BE} ${t("backups")}
+
+| Dato | Frecuencia | Retenci\xF3n | Ubicaci\xF3n |
+|------|----------|----------|----------|
+| Base de datos | [Diaria] | [30 d\xEDas] | [S3] |
+| Archivos | [Diaria] | [30 d\xEDas] | [S3] |
+`;
+}
+
+// src/generators/project-readme/labels/es.ts
+var labels27 = {
+  title: "# {{PROJECT_NAME}}",
+  intro: "[Descripci\xF3n corta del proyecto en una o dos frases.]",
+  quick: "\u{1F680} Quick Start",
+  quickDesc: "[Instrucciones m\xEDnimas para arrancar en local.]",
+  docs: "\u{1F4DA} Documentaci\xF3n",
+  docsDesc: "Documentaci\xF3n completa en la carpeta [`docs/`](docs/).",
+  stack: "\u{1F6E0}\uFE0F Stack",
+  license: "\u{1F4C4} Licencia"
+};
+var en11 = {
+  title: "# {{PROJECT_NAME}}",
+  intro: "[Short project description in one or two sentences.]",
+  quick: "\u{1F680} Quick Start",
+  quickDesc: "[Minimum instructions to get started locally.]",
+  docs: "\u{1F4DA} Documentation",
+  docsDesc: "Full documentation in the [`docs/`](docs/) folder.",
+  stack: "\u{1F6E0}\uFE0F Stack",
+  license: "\u{1F4C4} License"
+};
+
+// src/generators/project-readme/generator.ts
+registerLabels("project-readme", "es", labels27);
+registerLabels("project-readme", "en", { ...labels27, ...en11 });
+function generate19(options) {
+  const t = (k) => loadLabels("project-readme", options.language)[k] || `[${k}]`;
+  const stack = options.stack ? `${options.stack.language}${options.stack.framework ? " + " + options.stack.framework : ""}` : "[TECNOLOG\xCDA]";
+  return `# {{PROJECT_NAME}}
+
+${t("intro")}
+
+## ${t("quick")}
+
+\`\`\`bash
+git clone [URL]
+cd {{PROJECT_NAME}}
+[comando de instalaci\xF3n]
+[comando de dev]
+\`\`\`
+
+${t("quickDesc")}
+
+## ${t("docs")}
+
+${t("docsDesc")}
+
+## ${t("stack")}
+
+- **Lenguaje**: ${stack}
+- **Package Manager**: ${options.stack?.packageManager || "[package manager]"}
+
+## ${t("license")}
+
+[LICENSE]
+`;
+}
+
+// src/generators/docs-readme/labels/es.ts
+var labels28 = {
+  title: "\u{1F4DA} Documentaci\xF3n de {{PROJECT_NAME}}",
+  intro: "Bienvenido a la documentaci\xF3n de {{PROJECT_NAME}}.",
+  structure: "Estructura",
+  tutorials: "\u{1F4D6} Tutoriales",
+  guides: "\u{1F4DD} Gu\xEDas",
+  reference: "\u{1F4CB} Referencia",
+  explanation: "\u{1F4A1} Explicaci\xF3n",
+  product: "\u{1F680} Producto",
+  ops: "\u2699\uFE0F Operaciones"
+};
+var en12 = {
+  title: "\u{1F4DA} {{PROJECT_NAME}} Documentation",
+  intro: "Welcome to the {{PROJECT_NAME}} documentation.",
+  structure: "Structure",
+  tutorials: "\u{1F4D6} Tutorials",
+  guides: "\u{1F4DD} Guides",
+  reference: "\u{1F4CB} Reference",
+  explanation: "\u{1F4A1} Explanation",
+  product: "\u{1F680} Product",
+  ops: "\u2699\uFE0F Operations"
+};
+
+// src/generators/docs-readme/generator.ts
+registerLabels("docs-readme", "es", labels28);
+registerLabels("docs-readme", "en", { ...labels28, ...en12 });
+function generate20(options) {
+  const t = (k) => loadLabels("docs-readme", options.language)[k] || `[${k}]`;
+  return `# ${t("title")}
+
+${t("intro")}
+
+## ${t("structure")}
+
+| Directorio | Tipo | Contenido |
+|-----------|------|----------|
+| \`tutorials/\` | ${t("tutorials")} | Aprender haciendo |
+| \`guides/\` | ${t("guides")} | C\xF3mo resolver tareas |
+| \`reference/\` | ${t("reference")} | Info t\xE9cnica detallada |
+| \`explanation/\` | ${t("explanation")} | Razonamiento y decisiones |
+| \`product/\` | ${t("product")} | Roadmap y visi\xF3n |
+| \`operations/\` | ${t("ops")} | Runbooks y monitoreo |
+`;
+}
+
+// src/generators/adr-template/labels/es.ts
+var labels29 = {
+  fmType: "adr-template",
+  fmTags: "adr, template, decisions",
+  title: "ADR-0000: [T\xEDtulo descriptivo de la decisi\xF3n]",
+  statuses: "Propuesto \u2192 Aceptado \u2192 Deprecado \u2192 Reemplazado",
+  context: "Contexto",
+  decision: "Decisi\xF3n",
+  consequences: "Consecuencias",
+  alternatives: "Alternativas",
+  pos: "Positivas",
+  neg: "Negativas",
+  migration: "Migraci\xF3n",
+  rollback: "Rollback"
+};
+var en13 = {
+  fmType: "adr-template",
+  fmTags: "adr, template, decisions",
+  title: "ADR-0000: [Descriptive title of the decision]",
+  statuses: "Proposed \u2192 Accepted \u2192 Deprecated \u2192 Superseded",
+  context: "Context",
+  decision: "Decision",
+  consequences: "Consequences",
+  alternatives: "Alternatives",
+  pos: "Positive",
+  neg: "Negative",
+  migration: "Migration",
+  rollback: "Rollback"
+};
+
+// src/generators/adr-template/generator.ts
+registerLabels("adr-template", "es", labels29);
+registerLabels("adr-template", "en", { ...labels29, ...en13 });
+function generate21(options) {
+  const t = (k) => loadLabels("adr-template", options.language)[k] || `[${k}]`;
+  const today = options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
+created: "${today}"
+status: proposed
+deciders: ["[nombre]"]
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+**Estado**: ${t("statuses")}
+
+## ${t("context")}
+
+[Describe el problema, las fuerzas en juego, y las restricciones. \xBFQu\xE9 nos llev\xF3 a tomar esta decisi\xF3n?]
+
+## ${t("decision")}
+
+[Describe la decisi\xF3n en una o dos frases. S\xE9 espec\xEDfico.]
+
+## ${t("consequences")}
+
+### ${t("pos")}
+- [Consecuencia positiva 1]
+- [Consecuencia positiva 2]
+
+### ${t("neg")}
+- [Consecuencia negativa 1]
+- [Trade-off aceptado]
+
+### ${t("migration")}
+[Si la decisi\xF3n requiere migraci\xF3n, describir los pasos.]
+
+### ${t("rollback")}
+[Si la decisi\xF3n se revierte, \xBFc\xF3mo se vuelve atr\xE1s?]
+
+## ${t("alternatives")}
+
+| Alternativa | Rechazada porque... |
+|------------|-------------------|
+| **[Alt 1]** | [Raz\xF3n] |
+| **[Alt 2]** | [Raz\xF3n] |
+`;
 }
-function isTextFile(filename) {
-  const textExtensions = [".md", ".yml", ".yaml", ".json", ".txt", ".editorconfig"];
-  return textExtensions.some((ext) => filename.endsWith(ext)) || filename.startsWith(".");
+
+// src/generators/agent-flow/labels/es.ts
+var labels30 = {
+  fmType: "explanation",
+  fmTags: "agent-flow, agents, protocol",
+  title: "Flujo de Agentes",
+  intro: "Diagrama y explicaci\xF3n del flujo de trabajo de agentes de IA en este proyecto.",
+  subdel: "Subdelegaci\xF3n",
+  subdelDesc: "El orquestador delega a agentes especializados.",
+  qg: "Quality Gate",
+  qgDesc: "@reviewer verifica antes de completar.",
+  main: "Mantenimiento",
+  mainDesc: "El skill doc-maintain sincroniza cambios."
+};
+var en14 = {
+  fmType: "explanation",
+  fmTags: "agent-flow, agents, protocol",
+  title: "Agent Flow",
+  intro: "Diagram and explanation of the AI agent workflow in this project.",
+  subdel: "Sub-delegation",
+  subdelDesc: "The orchestrator delegates to specialized agents.",
+  qg: "Quality Gate",
+  qgDesc: "@reviewer verifies before completing.",
+  main: "Maintenance",
+  mainDesc: "The doc-maintain skill syncs changes."
+};
+
+// src/generators/agent-flow/generator.ts
+registerLabels("agent-flow", "es", labels30);
+registerLabels("agent-flow", "en", { ...labels30, ...en14 });
+function generate22(options) {
+  const t = (k) => loadLabels("agent-flow", options.language)[k] || `[${k}]`;
+  return `---
+created: "${options.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+status: active
+type: ${t("fmType")}
+tags: [${t("fmTags")}]
+---
+
+# ${t("title")}
+
+${t("intro")}
+
+\`\`\`mermaid
+sequenceDiagram
+    participant U as Developer
+    participant O as Orchestrator
+    participant A as Agent
+    participant R as @reviewer
+
+    U->>O: Task
+    O->>A: ${t("subdel")}
+    A->>A: Implement
+    A->>R: Request review
+    R-->>A: \u2705 / \u274C
+    A->>O: Done
+    O->>U: Complete
+\`\`\`
+
+## ${t("subdel")}
+
+${t("subdelDesc")}
+
+## ${t("qg")}
+
+${t("qgDesc")}
+
+## ${t("main")}
+
+${t("mainDesc")}
+`;
 }
 
 // src/generator.ts
-var __dirname = path3.dirname(fileURLToPath(import.meta.url));
-async function generate(options) {
-  const { projectName, targetDir, stack, modules, language } = options;
-  const createdFiles = [];
+var __dirname = path6.dirname(fileURLToPath(import.meta.url));
+var GENERATED_FILES = /* @__PURE__ */ new Set([
+  // Base
+  "AGENTS.md",
+  "AGENTS.en.md",
+  "CHANGELOG.md",
+  "CHANGELOG.en.md",
+  "docs/CONTEXT.md",
+  "docs/CONTEXT.en.md",
+  "README.md",
+  "docs/README.md",
+  "docs/adr/TEMPLATE.md",
+  // Tutorials
+  "docs/tutorials/quick-start.md",
+  "docs/tutorials/quick-start.en.md",
+  "docs/tutorials/environment-setup.md",
+  "docs/tutorials/first-task.md",
+  // Guides
+  "docs/guides/deployment.md",
+  "docs/guides/troubleshooting.md",
+  "docs/guides/runbooks/TEMPLATE.md",
+  // Reference
+  "docs/reference/api.md",
+  "docs/reference/api.en.md",
+  "docs/reference/configuration.md",
+  "docs/reference/infrastructure.md",
+  "docs/reference/code-style.md",
+  // Explanation
+  "docs/explanation/architecture.md",
+  "docs/explanation/agent-flow.md",
+  // Product
+  "docs/product/overview.md",
+  "docs/roadmap.md",
+  // Operations
+  "docs/operations/README.md",
+  // Design
+  "docs/DESIGN.md"
+]);
+async function generate23(options) {
+  const { projectName, targetDir, modules } = options;
+  const replacements = buildReplacements(projectName, options.stack);
+  const conditionCtx = buildConditionContext(options.stack, targetDir);
+  const templatesDir = resolveTemplatesDir();
+  const plannedFiles = [];
+  const baseDir = path6.join(templatesDir, "base");
+  if (fs6.existsSync(baseDir)) {
+    collectFiles(baseDir, targetDir, replacements, "base", plannedFiles);
+  }
+  for (const moduleName of modules) {
+    const moduleDir = path6.join(templatesDir, "modules", moduleName);
+    if (fs6.existsSync(moduleDir)) {
+      collectFiles(moduleDir, targetDir, replacements, moduleName, plannedFiles);
+    }
+  }
+  const sharedDir = path6.join(templatesDir, "shared");
+  if (fs6.existsSync(sharedDir)) {
+    collectFiles(sharedDir, targetDir, replacements, "shared", plannedFiles);
+  }
+  const genOpts = {
+    projectName,
+    stack: options.stack,
+    language: options.language,
+    conditionCtx
+  };
+  plannedFiles.push({
+    relativePath: "AGENTS.md",
+    sourcePath: "",
+    content: generate(genOpts),
+    replacements: {},
+    module: "base"
+  });
+  plannedFiles.push({
+    relativePath: "docs/CONTEXT.md",
+    sourcePath: "",
+    content: generate2(genOpts),
+    replacements: {},
+    module: "base"
+  });
+  plannedFiles.push({
+    relativePath: "CHANGELOG.md",
+    sourcePath: "",
+    content: generate3(genOpts),
+    replacements: {},
+    module: "base"
+  });
+  if (modules.includes("reference")) {
+    plannedFiles.push({ relativePath: "docs/reference/api.md", sourcePath: "", content: generate5(genOpts), replacements: {}, module: "reference" });
+    plannedFiles.push({
+      relativePath: "docs/reference/configuration.md",
+      sourcePath: "",
+      content: generate11(genOpts),
+      replacements: {},
+      module: "reference"
+    });
+    plannedFiles.push({
+      relativePath: "docs/reference/infrastructure.md",
+      sourcePath: "",
+      content: generate12(genOpts),
+      replacements: {},
+      module: "reference"
+    });
+    plannedFiles.push({
+      relativePath: "docs/reference/code-style.md",
+      sourcePath: "",
+      content: generate13(genOpts),
+      replacements: {},
+      module: "reference"
+    });
+  }
+  if (modules.includes("tutorials")) {
+    plannedFiles.push({
+      relativePath: "docs/tutorials/quick-start.md",
+      sourcePath: "",
+      content: generate4(genOpts),
+      replacements: {},
+      module: "tutorials"
+    });
+    plannedFiles.push({
+      relativePath: "docs/tutorials/environment-setup.md",
+      sourcePath: "",
+      content: generate6(genOpts),
+      replacements: {},
+      module: "tutorials"
+    });
+    plannedFiles.push({
+      relativePath: "docs/tutorials/first-task.md",
+      sourcePath: "",
+      content: generate7(genOpts),
+      replacements: {},
+      module: "tutorials"
+    });
+  }
+  if (modules.includes("guides")) {
+    plannedFiles.push({ relativePath: "docs/guides/deployment.md", sourcePath: "", content: generate8(genOpts), replacements: {}, module: "guides" });
+    plannedFiles.push({
+      relativePath: "docs/guides/troubleshooting.md",
+      sourcePath: "",
+      content: generate9(genOpts),
+      replacements: {},
+      module: "guides"
+    });
+    plannedFiles.push({
+      relativePath: "docs/guides/runbooks/TEMPLATE.md",
+      sourcePath: "",
+      content: generate10(genOpts),
+      replacements: {},
+      module: "guides"
+    });
+  }
+  if (modules.includes("explanation")) {
+    plannedFiles.push({
+      relativePath: "docs/explanation/architecture.md",
+      sourcePath: "",
+      content: generate14(genOpts),
+      replacements: {},
+      module: "explanation"
+    });
+    plannedFiles.push({
+      relativePath: "docs/explanation/agent-flow.md",
+      sourcePath: "",
+      content: generate22(genOpts),
+      replacements: {},
+      module: "explanation"
+    });
+  }
+  if (modules.includes("product")) {
+    plannedFiles.push({ relativePath: "docs/product/overview.md", sourcePath: "", content: generate16(genOpts), replacements: {}, module: "product" });
+    plannedFiles.push({ relativePath: "docs/roadmap.md", sourcePath: "", content: generate17(genOpts), replacements: {}, module: "product" });
+  }
+  if (modules.includes("operations")) {
+    plannedFiles.push({ relativePath: "docs/operations/README.md", sourcePath: "", content: generate18(genOpts), replacements: {}, module: "operations" });
+  }
+  if (modules.includes("design")) {
+    plannedFiles.push({ relativePath: "docs/DESIGN.md", sourcePath: "", content: generate15(genOpts), replacements: {}, module: "design" });
+  }
+  plannedFiles.push({ relativePath: "README.md", sourcePath: "", content: generate19(genOpts), replacements: {}, module: "base" });
+  plannedFiles.push({ relativePath: "docs/README.md", sourcePath: "", content: generate20(genOpts), replacements: {}, module: "base" });
+  plannedFiles.push({ relativePath: "docs/adr/TEMPLATE.md", sourcePath: "", content: generate21(genOpts), replacements: {}, module: "base" });
+  const createdFiles = await processConflicts(plannedFiles, {
+    targetDir,
+    force: options.force,
+    dryRun: options.dryRun,
+    conditionCtx
+  });
+  if (options.initGit && !options.dryRun) {
+    await initGit(targetDir);
+  }
+  return createdFiles;
+}
+function buildReplacements(projectName, stack) {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const replacements = {
+  return {
     "{{PROJECT_NAME}}": projectName,
     "{{TECH_STACK}}": stack ? formatStackForTemplate(stack) : "[TECNOLOG\xCDA PRINCIPAL]",
     "{{DEV_COMMAND}}": stack?.devCommand || "[comando de dev]",
@@ -325,49 +3945,34 @@ async function generate(options) {
     "{{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);
-      }
+function collectFiles(templateDir, targetDir, replacements, module, output, prefix = "") {
+  const entries = fs6.readdirSync(templateDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path6.join(templateDir, entry.name);
+    if (entry.isDirectory()) {
+      collectFiles(srcPath, targetDir, replacements, module, output, path6.join(prefix, entry.name));
+    } else {
+      const relativePath = path6.join(prefix, entry.name).replace(/\\/g, "/");
+      if (GENERATED_FILES.has(relativePath)) continue;
+      if (GENERATED_FILES.has(relativePath.replace(/\.en\.md$/, ".md"))) continue;
+      output.push({
+        relativePath,
+        sourcePath: path6.resolve(srcPath),
+        replacements,
+        module
+      });
     }
   }
-  walk(templateDir, "");
-  return files;
+}
+function resolveTemplatesDir() {
+  const prodPath = path6.resolve(__dirname, "..", "templates");
+  const devPath = path6.resolve(__dirname, "..", "..", "templates");
+  if (fs6.existsSync(prodPath)) return prodPath;
+  if (fs6.existsSync(devPath)) return devPath;
+  throw new Error("No se encontr\xF3 el directorio de templates. \xBFSe instal\xF3 correctamente el paquete?");
 }
 async function initGit(dir) {
   const { execSync } = await import("child_process");
@@ -554,43 +4159,45 @@ function generateAgentsGuide() {
 }
 
 // src/cli.ts
-var __dirname2 = path4.dirname(url.fileURLToPath(import.meta.url));
-var pkg = JSON.parse(fs3.readFileSync(path4.join(__dirname2, "..", "package.json"), "utf-8"));
+var __dirname2 = path7.dirname(url.fileURLToPath(import.meta.url));
+var pkg = JSON.parse(fs7.readFileSync(path7.join(__dirname2, "..", "package.json"), "utf-8"));
 function showHelp() {
   console.log(`
-${pc2.bold(brand.title("@damenor/agent-docs"))} ${pc2.dim(`v${pkg.version}`)}
+${pc4.bold(brand.title("@damenor/agent-docs"))} ${pc4.dim(`v${pkg.version}`)}
 
-${pc2.bold("USAGE")}
-  ${pc2.cyan("npx @damenor/agent-docs")}           ${pc2.dim("# Interactive wizard (default)")}
-  ${pc2.cyan("npx @damenor/agent-docs --help")}    ${pc2.dim("# Show this help")}
-  ${pc2.cyan("npx @damenor/agent-docs --version")} ${pc2.dim("# Show version")}
+${pc4.bold("USAGE")}
+  ${pc4.cyan("npx @damenor/agent-docs")}           ${pc4.dim("# Interactive wizard (default)")}
+  ${pc4.cyan("npx @damenor/agent-docs --help")}    ${pc4.dim("# Show this help")}
+  ${pc4.cyan("npx @damenor/agent-docs --version")} ${pc4.dim("# Show version")}
 
-${pc2.bold("WHAT IT DOES")}
+${pc4.bold("WHAT IT DOES")}
   Generates a professional documentation structure for your project:
   Di\xE1taxis (Tutorials/Guides/Reference/Explanation) + AGENTS.md + ADRs + AI agent skills.
 
-${pc2.bold("WIZARD STEPS")}
-  1. ${pc2.bold("Project name")}       \u2014 How your project is called
-  2. ${pc2.bold("Target directory")}   \u2014 Where to generate docs (default: ./)
-  3. ${pc2.bold("Stack detection")}    \u2014 Auto-detect or configure manually
-  4. ${pc2.bold("Language")}           \u2014 Espa\xF1ol or English
-  5. ${pc2.bold("Modules")}            \u2014 Pick from 9 available modules
-  6. ${pc2.bold("Git init")}           \u2014 Initialize git repo with first commit
-  7. ${pc2.bold("Generate")}           \u2014 Confirm and create all files
+${pc4.bold("WIZARD STEPS")}
+  1. ${pc4.bold("Project name")}       \u2014 How your project is called
+  2. ${pc4.bold("Target directory")}   \u2014 Where to generate docs (default: ./)
+  3. ${pc4.bold("Stack detection")}    \u2014 Auto-detect or configure manually
+  4. ${pc4.bold("Language")}           \u2014 Espa\xF1ol or English
+  5. ${pc4.bold("Modules")}            \u2014 Pick from 9 available modules
+  6. ${pc4.bold("Git init")}           \u2014 Initialize git repo with first commit
+  7. ${pc4.bold("Generate")}           \u2014 Confirm and create all files
 
-${pc2.bold("MODULES")}
-${DOC_MODULES.map((m) => `  ${pc2.cyan(m.value.padEnd(12))} ${m.label} \u2014 ${m.hint ?? ""}`).join("\n")}
+${pc4.bold("MODULES")}
+${DOC_MODULES.map((m) => `  ${pc4.cyan(m.value.padEnd(12))} ${m.label} \u2014 ${m.hint ?? ""}`).join("\n")}
 
-${pc2.bold("STACK DETECTION")}
+${pc4.bold("STACK DETECTION")}
   Reads package.json, pyproject.toml, go.mod, Cargo.toml, pom.xml, build.gradle.
   Supports Node.js, Python, Go, Rust, Java/Kotlin + 10+ frameworks.
 
-${pc2.bold("OPTIONS")}
-  ${pc2.cyan("-h, --help")}         Show this help
-  ${pc2.cyan("-v, --version")}      Show version
-  ${pc2.cyan("--agents-guide")}     Output guide for AI agents (what to fill, what to delete, priorities)
+${pc4.bold("OPTIONS")}
+  ${pc4.cyan("-h, --help")}         Show this help
+  ${pc4.cyan("-v, --version")}      Show version
+  ${pc4.cyan("--agents-guide")}     Output guide for AI agents (what to fill, what to delete, priorities)
+  ${pc4.cyan("--force")}            Overwrite existing files without prompting
+  ${pc4.cyan("--dry-run")}          Preview what would be generated without writing
 
-${pc2.dim("Made with \u2764\uFE0F by damenordev")}
+${pc4.dim("Made with \u2764\uFE0F by damenordev")}
 `);
 }
 function showVersion() {
@@ -598,6 +4205,8 @@ function showVersion() {
 }
 async function cli() {
   const args = process.argv.slice(2);
+  const isForce = args.includes("--force");
+  const isDryRun = args.includes("--dry-run");
   if (args.includes("--help") || args.includes("-h")) {
     showHelp();
     return;
@@ -611,11 +4220,15 @@ async function cli() {
     process.exit(0);
   }
   console.clear();
-  p.intro(
-    `${icons.docs} ${brand.title("@damenor/agent-docs")} ${pc2.dim(`v${pkg.version}`)}
-   ${pc2.dim("Documentaci\xF3n profesional para proyectos con agentes AI")}`
+  if (isDryRun) {
+    console.log(`${pc4.blue("\u2139")} ${pc4.dim("Dry run mode \u2014 no files will be written")}
+`);
+  }
+  p2.intro(
+    `${icons.docs} ${brand.title("@damenor/agent-docs")} ${pc4.dim(`v${pkg.version}`)}
+   ${pc4.dim("Documentaci\xF3n profesional para proyectos con agentes AI")}`
   );
-  const projectName = await p.text({
+  const projectName = await p2.text({
     message: `${icons.sparkle} Nombre del proyecto`,
     placeholder: "mi-proyecto",
     validate: (value) => {
@@ -625,11 +4238,11 @@ async function cli() {
       }
     }
   });
-  if (p.isCancel(projectName)) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(projectName)) {
+    p2.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
-  const targetDir = await p.text({
+  const targetDir = await p2.text({
     message: `${icons.folder} Directorio de destino`,
     placeholder: "./",
     initialValue: "./",
@@ -637,22 +4250,22 @@ async function cli() {
       if (!value.trim()) return "El directorio es obligatorio.";
     }
   });
-  if (p.isCancel(targetDir)) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(targetDir)) {
+    p2.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
-  const resolvedDir = path4.resolve(targetDir.trim());
+  const resolvedDir = path7.resolve(targetDir.trim());
   if (!isDirEmpty(resolvedDir)) {
-    const overwrite = await p.confirm({
+    const overwrite = await p2.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.");
+    if (p2.isCancel(overwrite) || !overwrite) {
+      p2.cancel("Operaci\xF3n cancelada.");
       process.exit(0);
     }
   }
-  const stackOption = await p.select({
+  const stackOption = await p2.select({
     message: `${icons.search} Stack tecnol\xF3gico`,
     options: [
       { value: "auto", label: "Auto-detectar", hint: "recomendado \u2014 analiza el proyecto" },
@@ -660,13 +4273,13 @@ async function cli() {
       { value: "skip", label: "Omitir", hint: "rellenar despu\xE9s" }
     ]
   });
-  if (p.isCancel(stackOption)) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(stackOption)) {
+    p2.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
   let stack = null;
   if (stackOption === "auto") {
-    const s2 = p.spinner();
+    const s2 = p2.spinner();
     s2.start("Analizando proyecto...");
     await new Promise((r) => setTimeout(r, 800));
     stack = detectStack(resolvedDir);
@@ -676,9 +4289,9 @@ async function cli() {
       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(
+    const manualStack = await p2.group(
       {
-        language: () => p.select({
+        language: () => p2.select({
           message: "Lenguaje principal",
           options: [
             { value: "TypeScript", label: "TypeScript" },
@@ -690,14 +4303,14 @@ async function cli() {
             { value: "Other", label: "Otro" }
           ]
         }),
-        framework: () => p.text({
+        framework: () => p2.text({
           message: "Framework (opcional)",
           placeholder: "Next.js 14, Django 5, etc."
         })
       },
       {
         onCancel: () => {
-          p.cancel("Operaci\xF3n cancelada.");
+          p2.cancel("Operaci\xF3n cancelada.");
           process.exit(0);
         }
       }
@@ -707,7 +4320,7 @@ async function cli() {
       framework: manualStack.framework?.trim() || void 0
     };
   }
-  const language = await p.select({
+  const language = await p2.select({
     message: `${icons.docs} Idioma de la documentaci\xF3n`,
     options: LANGUAGES.map((lang) => ({
       value: lang.value,
@@ -715,24 +4328,24 @@ async function cli() {
       hint: lang.hint
     }))
   });
-  if (p.isCancel(language)) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(language)) {
+    p2.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
-  const allModules = await p.confirm({
+  const allModules = await p2.confirm({
     message: `${icons.package} \xBFIncluir todos los m\xF3dulos?`,
     initialValue: true
   });
-  if (p.isCancel(allModules)) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(allModules)) {
+    p2.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
   let selectedModules;
   if (allModules) {
     selectedModules = DOC_MODULES.map((mod) => mod.value);
   } else {
-    const picked = await p.multiselect({
-      message: `${icons.package} M\xF3dulos a incluir ${pc2.dim("(espacio para seleccionar, enter para confirmar)")}`,
+    const picked = await p2.multiselect({
+      message: `${icons.package} M\xF3dulos a incluir ${pc4.dim("(espacio para seleccionar, enter para confirmar)")}`,
       options: DOC_MODULES.map((mod) => ({
         value: mod.value,
         label: mod.label,
@@ -740,71 +4353,75 @@ async function cli() {
       })),
       required: false
     });
-    if (p.isCancel(picked)) {
-      p.cancel("Operaci\xF3n cancelada.");
+    if (p2.isCancel(picked)) {
+      p2.cancel("Operaci\xF3n cancelada.");
       process.exit(0);
     }
     selectedModules = picked;
   }
-  const initGit2 = await p.confirm({
+  const initGit2 = await p2.confirm({
     message: `${icons.gear} \xBFInicializar repositorio git?`,
     initialValue: true
   });
-  if (p.isCancel(initGit2)) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(initGit2)) {
+    p2.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
-  const modulesLabel = selectedModules.length > 0 ? selectedModules.join(", ") : pc2.dim("ninguno (solo archivos base)");
-  p.note(
+  const modulesLabel = selectedModules.length > 0 ? selectedModules.join(", ") : pc4.dim("ninguno (solo archivos base)");
+  p2.note(
     [
       `${brand.label("Proyecto")}:     ${projectName}`,
       `${brand.label("Directorio")}:   ${brand.path(resolvedDir)}`,
-      `${brand.label("Stack")}:        ${stack ? formatStack(stack) : pc2.dim("no detectado")}`,
+      `${brand.label("Stack")}:        ${stack ? formatStack(stack) : pc4.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({
+  const confirmed = await p2.confirm({
     message: "\xBFGenerar documentaci\xF3n?",
     initialValue: true
   });
-  if (p.isCancel(confirmed) || !confirmed) {
-    p.cancel("Operaci\xF3n cancelada.");
+  if (p2.isCancel(confirmed) || !confirmed) {
+    p2.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(", ")}`);
+  const s = p2.spinner();
+  if (!isDryRun) {
+    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({
+  const createdFiles = await generate23({
     projectName: projectName.trim(),
     targetDir: resolvedDir,
     stack,
     modules: selectedModules,
     language,
-    initGit: initGit2
+    initGit: initGit2,
+    force: isForce,
+    dryRun: isDryRun
   });
   if (initGit2) {
     s.message("Inicializando repositorio git...");
     await new Promise((r) => setTimeout(r, 300));
   }
-  s.stop(`${icons.check} ${brand.success(`${createdFiles.length} archivos generados`)}`);
+  if (!isDryRun) {
+    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`
+    `${pc4.bold("1.")} Rellenar ${brand.path("docs/CONTEXT.md")} con los t\xE9rminos del dominio`,
+    `${pc4.bold("2.")} Revisar ${brand.path("AGENTS.md")} y ajustar stack/comandos`,
+    `${pc4.bold("3.")} Ejecutar ${pc4.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")}`
-  );
+  p2.note(nextSteps.join("\n"), `${icons.rocket} Pr\xF3ximos pasos`);
+  p2.outro(`${icons.sparkle} ${brand.title("\xA1Documentaci\xF3n lista!")} ${pc4.dim("\u2014 github.com/damenordev/doc-projects")}`);
 }
 
 // src/index.ts