@damenor/agent-docs 0.1.0 → 0.1.1

package/README.md

@@ -1,115 +1,185 @@
 <h1 align="center">
-  <img src="https://img.shields.io/badge/agents-docs-blueviolet?style=for-the-badge" alt="agent-docs">
-  <br>
-  @damenor/agent-docs
+  🤖📚 @damenor/agent-docs
 </h1>
 
 <p align="center">
-  <strong>Documentación profesional para proyectos con agentes AI</strong>
+  <strong>Stop writing docs from scratch. Start shipping AI-ready documentation in 30 seconds.</strong>
   <br>
-  <sub>CLI interactivo que genera estructura Diátaxis + ADR + AGENTS.md en segundos</sub>
+  <sub>One command → complete Diátaxis structure with AGENTS.md, ADRs, and agent skills</sub>
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/npm/v/@damenor/agent-docs?style=flat-square" alt="npm version">
-  <img src="https://img.shields.io/npm/dt/@damenor/agent-docs?style=flat-square" alt="downloads">
-  <img src="https://img.shields.io/github/license/damenordev/doc-projects?style=flat-square" alt="license">
-  <img src="https://img.shields.io/node/v/@damenor/agent-docs?style=flat-square" alt="node version">
+  <img src="https://img.shields.io/npm/v/@damenor/agent-docs?style=flat-square&color=blueviolet" alt="npm version">
+  <img src="https://img.shields.io/npm/dt/@damenor/agent-docs?style=flat-square&color=blueviolet" alt="downloads">
+  <img src="https://img.shields.io/node/v/@damenor/agent-docs?style=flat-square&color=blueviolet" alt="node version">
 </p>
 
 ---
 
-## Quick start
+## ⚡ One command. Full docs. Zero BS.
 
 ```bash
 npx @damenor/agent-docs
 ```
 
-That's it. The wizard guides you through 7 steps and generates a complete documentation structure.
+That's literally it. 30 seconds later you have a professional documentation structure that would take hours to build manually.
 
-## What it does
+No config files. No boilerplate repos. No "just copy this template". One interactive wizard, done.
 
-```
-npx @damenor/agent-docs
-       │
-       ├── 1. Project name
-       ├── 2. Target directory
-       ├── 3. Stack detection (auto/manual/skip)
-       │      package.json · pyproject.toml · go.mod · Cargo.toml · pom.xml
-       ├── 4. Language (ES/EN)
-       ├── 5. Module selection
-       ├── 6. Git init
-       └── 7. Generate → docs/ ready to customize
-```
+---
 
-## 9 selectable modules
+## 😤 The problem
 
-| Module | Generates |
-|--------|-----------|
-| Tutorials | quick-start, environment-setup, first-task |
-| Guides | deployment, troubleshooting, runbooks |
-| Reference | API, configuration, infrastructure, code-style |
-| Explanation | architecture.md |
-| Product | overview, roadmap |
-| Operations | monitoring, incidents, SLAs |
-| Design System | DESIGN.md with tokens |
-| AI Agent Skills | `.agents/` with 5 skills + 5 agents |
-| CI/CD | GitHub Actions docs-check workflow |
+You know the drill:
 
-**Plus**, every run includes the base layer: `AGENTS.md`, `CONTEXT.md`, `README.md`, ADR template, and shared config files.
+- 🫠 **"I'll add docs later"** → later never comes
+- 🤖 **AI agents hallucinate** because there's no context, no structure, no rules
+- 📁 **Every project documents differently** — if it documents at all
+- 😰 **Onboarding new devs** means 2 hours of "where is...?" and "how do I...?"
+- 📝 **Writing docs from zero** feels like homework nobody asked for
 
-## Stack detection
+**You deserve better. Your team deserves better. Your AI agents deserve better.**
 
-Automatically detects your tech stack from project files:
+---
 
-| File detected | Stack |
-|---------------|-------|
-| `package.json` | Node.js (npm/pnpm/yarn/bun) |
-| `pyproject.toml` / `requirements.txt` | Python (pip/poetry) |
-| `go.mod` | Go |
-| `Cargo.toml` | Rust |
-| `pom.xml` / `build.gradle` | Java/Kotlin |
+## 🪄 The solution
 
-Detected commands (`dev`, `build`, `test`, `lint`) are injected into templates automatically.
+`agent-docs` gives you the documentation structure that **top engineering teams use** — in the time it takes to order a coffee.
+
+### What you get in 30 seconds:
+
+```
+npx @damenor/agent-docs
+       │
+       ├── 1. 📝 Project name
+       ├── 2. 📂 Target directory
+       ├── 3. 🔍 Auto-detect your stack
+       │      Reads package.json · pyproject.toml · go.mod · Cargo.toml · pom.xml
+       │      Injects YOUR dev/build/test/lint commands automatically
+       ├── 4. 🌐 Language (ES/EN)
+       ├── 5. 📦 Pick your modules (or take them all)
+       ├── 6. 🔧 Git init
+       └── 7. ⚡ Done. 30+ files generated. Docs ready.
+```
 
-## Output example
+### What comes out:
 
 ```
 my-project/
-├── AGENTS.md              ← AI agent protocol
+├── AGENTS.md              🤖 AI agent protocol (they finally behave)
 ├── docs/
-│   ├── CONTEXT.md         ← Domain language & glossary
-│   ├── README.md          ← Documentation index
-│   ├── tutorials/         ← Step-by-step learning
-│   ├── guides/            ← How-to guides
-│   ├── reference/         ← Technical reference
-│   ├── explanation/       ← Architecture & ADRs
-│   ├── product/           ← Overview & roadmap
-│   ├── operations/        ← Runbooks & monitoring
-│   ├── DESIGN.md          ← Design system tokens
-│   └── adr/               ← Architecture Decision Records
-├── .agents/               ← Skills & agent configs
-├── .github/workflows/     ← CI/CD for docs
+│   ├── CONTEXT.md         📝 Domain glossary (everyone speaks the same language)
+│   ├── README.md          📑 Docs index (navigable from day one)
+│   ├── tutorials/         🎓 Step-by-step learning (onboarding in 15 min, not 2 hours)
+│   ├── guides/            📖 How-to guides (deployment, troubleshooting, runbooks)
+│   ├── reference/         📋 Technical reference (API, config, infra, code-style)
+│   ├── explanation/       🏗️ Architecture decisions (ADRs, not lost Slack messages)
+│   ├── product/           📊 Overview & roadmap (what are we building again?)
+│   ├── operations/        🔧 Monitoring & incidents (when prod goes brrr)
+│   ├── DESIGN.md          🎨 Design system tokens (colors, typography, spacing)
+│   └── adr/               📐 Architecture Decision Records (decisions that last)
+├── .agents/               🤖 5 skills + 5 agents (your AI team is ready)
+├── .github/workflows/     ⚙️ CI/CD for docs (never ship broken docs again)
 ├── .editorconfig
 └── .markdownlint.json
 ```
 
-## Why this exists
+---
+
+## 🧩 9 modules — pick what you need
+
+Every project is different. Mix and match:
+
+| 🎯 Module | 📄 What you get | 💡 Why you care |
+|-----------|----------------|----------------|
+| 🎓 Tutorials | quick-start, setup, first-task | New dev productive in 15 min |
+| 📖 Guides | deployment, troubleshooting, runbooks | No more "it works on my machine" |
+| 📋 Reference | API, config, infra, code-style | Stop answering the same questions |
+| 🏗️ Explanation | architecture.md | Everyone understands the big picture |
+| 📊 Product | overview, roadmap | Stakeholders know what's happening |
+| 🔧 Operations | monitoring, incidents, SLAs | Prod issues resolved faster |
+| 🎨 Design System | DESIGN.md with tokens | Consistent UI, no guesswork |
+| 🤖 AI Agent Skills | 5 skills + 5 agents | AI agents that actually help |
+| ⚙️ CI/CD | GitHub Actions workflow | Docs checked on every PR |
+
+**Plus** the base layer is always included: `AGENTS.md`, `CONTEXT.md`, `README.md`, ADR template, and shared configs.
+
+---
+
+## 🔍 Auto-detects your stack
+
+No manual configuration. The CLI reads your project and figures it out:
 
-Most projects have **no documentation structure**. When you add AI agents to the mix, they need a shared vocabulary (`CONTEXT.md`), operating rules (`AGENTS.md`), and a consistent organization system (Diátaxis).
+| 📁 Found | 🛠️ Detected | ✨ Auto-injected |
+|----------|-------------|-----------------|
+| `package.json` | Node.js + framework + pkg manager | `npm run dev`, `npm test`, etc. |
+| `pyproject.toml` | Python + Django/FastAPI/Flask | `python manage.py runserver`, etc. |
+| `go.mod` | Go | `go run .`, `go test ./...` |
+| `Cargo.toml` | Rust | `cargo run`, `cargo test` |
+| `pom.xml` / `build.gradle` | Java/Kotlin + Spring | `mvn spring-boot:run`, etc. |
+
+Supports **Next.js, Nuxt, Astro, SvelteKit, React, Vue, Express, NestJS, Fastify, Hono, Django, FastAPI, Flask**, and more.
+
+---
 
-This CLI scaffolds all of that in one command, so your team and your AI agents speak the same language from day one.
+## 🤖 Why your AI agents will love you
 
-## Built for
+AI agents without context are expensive guesswork machines. `agent-docs` gives them:
 
-- **Developers** who want professional docs without starting from zero
-- **AI agents** that need structured context to work effectively
-- **Teams** that follow Diátaxis (Tutorials / How-to / Reference / Explanation)
+- **AGENTS.md** — operating rules, so they follow YOUR conventions
+- **CONTEXT.md** — domain vocabulary, so they use YOUR terminology
+- **ADRs** — decision records, so they respect YOUR architecture
+- **Skills** — specialized instructions for doc tasks, so they do it RIGHT
 
-## Requirements
+**Result**: AI agents that produce better code, fewer hallucinations, and actually follow your project's patterns.
+
+### `--agents-guide` — Built-in instructions for AI agents
+
+```bash
+npx @damenor/agent-docs --agents-guide
+```
+
+Outputs a structured guide that tells AI agents **exactly** what to do after generation:
+- ✅ What files to fill and in what order
+- ✅ What to delete if it doesn't apply
+- ✅ Which placeholders to verify
+- ✅ Rules for clean, real documentation
+
+No guessing. No "I'll add docs later". Your AI agent runs this and knows the drill.
+
+---
+
+## 📊 Before vs After
+
+| 😩 Before | 🤩 After |
+|-----------|----------|
+| "Where are the docs?" → "What docs?" | Professional docs index, navigable from day one |
+| New dev onboarding: 2 hours | New dev onboarding: 15 minutes |
+| AI agent: "I don't know the context" | AI agent: "I read AGENTS.md, I know the rules" |
+| "How do we deploy?" → Slack thread with 47 messages | `docs/guides/deployment.md` — one click |
+| Every project documents differently | Consistent Diátaxis structure across all projects |
+| Architecture decisions lost in Slack/Notion | ADRs that persist and are searchable |
+
+---
+
+## 🌐 Web docs — coming soon
+
+A beautiful documentation site powered by Astro + Starlight. Publish your docs as a searchable website with zero config.
+
+---
+
+## 📋 Requirements
 
 - Node.js >= 18
 
-## License
+---
+
+## 🎯 TL;DR
+
+```bash
+npx @damenor/agent-docs
+```
+
+30 seconds. Full docs structure. AI-ready. Team-ready. Production-ready.
 
-MIT — [github.com/damenordev/doc-projects](https://github.com/damenordev/doc-projects)
+**Ship docs, not excuses.** 🚀

package/dist/index.js

@@ -4,6 +4,8 @@
 import * as p from "@clack/prompts";
 import pc2 from "picocolors";
 import path4 from "path";
+import fs3 from "fs";
+import url from "url";
 
 // src/utils/colors.ts
 import pc from "picocolors";
@@ -129,6 +131,15 @@ var LANGUAGES = [
   { value: "es", label: "Espa\xF1ol", hint: "recomendado" },
   { value: "en", label: "English" }
 ];
+var PLACEHOLDERS = {
+  projectName: "{{PROJECT_NAME}}",
+  techStack: "{{TECH_STACK}}",
+  devCommand: "{{DEV_COMMAND}}",
+  buildCommand: "{{BUILD_COMMAND}}",
+  testCommand: "{{TEST_COMMAND}}",
+  lintCommand: "{{LINT_COMMAND}}",
+  date: "{{DATE}}"
+};
 
 // src/detector.ts
 import fs from "fs";
@@ -215,8 +226,8 @@ function detectStack(targetDir) {
   return null;
 }
 function detectNodeStack(packageJsonContent, dir) {
-  const pkg = JSON.parse(packageJsonContent);
-  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  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("~", "")}`;
@@ -232,7 +243,7 @@ function detectNodeStack(packageJsonContent, dir) {
   if (fs.existsSync(path.join(dir, "pnpm-lock.yaml"))) packageManager = "pnpm";
   else if (fs.existsSync(path.join(dir, "yarn.lock"))) packageManager = "yarn";
   else if (fs.existsSync(path.join(dir, "bun.lockb"))) packageManager = "bun";
-  const scripts = pkg.scripts || {};
+  const scripts = pkg2.scripts || {};
   const run = packageManager === "npm" ? "npm run" : packageManager;
   const hasTypeScript = deps["typescript"] || fs.existsSync(path.join(dir, "tsconfig.json"));
   return {
@@ -376,11 +387,232 @@ function formatStackForTemplate(stack) {
   return parts.join(" + ");
 }
 
+// src/agents-guide.ts
+function generateAgentsGuide() {
+  const lines = [];
+  lines.push("# AGENT GUIDE \u2014 @damenor/agent-docs");
+  lines.push("");
+  lines.push("This guide tells you how to personalize the generated documentation.");
+  lines.push("Read each file for details. This guide tells you WHAT to do, not what they say.");
+  lines.push("");
+  lines.push("## WORK ORDER (follow this sequence)");
+  lines.push("");
+  lines.push("1. CONTEXT.md \u2014 domain language (blocks everything else)");
+  lines.push("2. AGENTS.md \u2014 stack, commands, conventions (your operating rules)");
+  lines.push("3. docs/roadmap.md \u2014 real features and status");
+  lines.push("4. docs/tutorials/ \u2014 concrete steps for THIS project");
+  lines.push("5. docs/guides/ \u2014 deployment and troubleshooting for THIS project");
+  lines.push("6. docs/reference/ \u2014 technical reference for THIS project");
+  lines.push("7. docs/explanation/architecture.md \u2014 architecture decisions");
+  lines.push("8. Everything else");
+  lines.push("");
+  lines.push("## BASE FILES (always generated)");
+  lines.push("");
+  lines.push("### AGENTS.md");
+  lines.push("- ACTION: Verify detected commands match reality (dev, build, test, lint)");
+  lines.push("- ACTION: Adjust stack section if auto-detection was wrong");
+  lines.push("- ACTION: Remove module sections that don't apply to this project");
+  lines.push("- ACTION: Add project-specific conventions if any");
+  lines.push("- KEEP: Always. This is your operating protocol.");
+  lines.push("");
+  lines.push("### docs/CONTEXT.md");
+  lines.push("- ACTION: Replace ALL generic examples with real domain terms");
+  lines.push("- ACTION: Fill the entity table with THIS project's concepts");
+  lines.push("- ACTION: Add project-specific terms to the glossary");
+  lines.push("- ACTION: Update completeness % \u2014 if < 50%, prioritize this over code");
+  lines.push("- RULE: Every term used in code, APIs, or conversations MUST be here");
+  lines.push("- KEEP: Always. This is the shared vocabulary.");
+  lines.push("");
+  lines.push("### docs/adr/TEMPLATE.md");
+  lines.push("- ACTION: Keep as reference template. Do NOT fill.");
+  lines.push("- ACTION: When you make an architectural decision, copy this template and fill it.");
+  lines.push("- KEEP: Always.");
+  lines.push("");
+  lines.push("### docs/README.md");
+  lines.push("- ACTION: Update the documentation index to match what actually exists");
+  lines.push("- ACTION: Remove links to sections that don't exist");
+  lines.push("- KEEP: Always. This is the docs entry point.");
+  lines.push("");
+  lines.push("### README.md (project root)");
+  lines.push("- ACTION: Replace template content with real project info");
+  lines.push("- ACTION: Add real quick-start steps using detected commands");
+  lines.push("- KEEP: Always.");
+  lines.push("");
+  lines.push("### CHANGELOG.md");
+  lines.push("- ACTION: Remove template entries, keep format structure");
+  lines.push("- ACTION: Add real first entry if this is a new project");
+  lines.push("- KEEP: Always.");
+  lines.push("");
+  lines.push("## MODULES (only the ones the user selected)");
+  lines.push("");
+  for (const mod of DOC_MODULES) {
+    lines.push(`### Module: ${mod.value}`);
+    lines.push(`- FILES: ${mod.files.join(", ")}`);
+    switch (mod.value) {
+      case "tutorials":
+        lines.push("- ACTION: Replace generic steps with REAL steps for this project");
+        lines.push("- ACTION: Use actual commands from stack detection");
+        lines.push("- ACTION: Include real URLs, ports, env vars");
+        lines.push("- DELETE IF: Project doesn't need onboarding tutorials");
+        break;
+      case "guides":
+        lines.push("- ACTION: Fill deployment.md with real deployment process");
+        lines.push("- ACTION: Fill troubleshooting.md with real known issues");
+        lines.push("- ACTION: Delete runbooks/TEMPLATE.md after creating first runbook");
+        lines.push("- DELETE IF: Project doesn't have deployment/ops");
+        break;
+      case "reference":
+        lines.push("- ACTION: Fill api.md with real CLI/API surface");
+        lines.push("- ACTION: Fill configuration.md with real config options");
+        lines.push("- ACTION: Fill infrastructure.md with real infra");
+        lines.push("- ACTION: Fill code-style.md with real linting/formatting rules");
+        lines.push("- DELETE IF: Project is too small for reference docs");
+        break;
+      case "explanation":
+        lines.push("- ACTION: Fill architecture.md with real system design");
+        lines.push("- ACTION: Add Mermaid diagrams if helpful");
+        lines.push("- DELETE IF: Project is trivial and needs no architecture doc");
+        break;
+      case "product":
+        lines.push("- ACTION: Fill overview.md with real product vision and users");
+        lines.push("- ACTION: Fill roadmap.md with real features, priorities, status");
+        lines.push("- DELETE IF: Internal project with no product dimension");
+        break;
+      case "operations":
+        lines.push("- ACTION: Fill with real monitoring, incidents, SLAs");
+        lines.push("- DELETE IF: No production operations");
+        break;
+      case "design":
+        lines.push("- ACTION: Extract real tokens from CSS/Tailwind/theme");
+        lines.push("- DELETE IF: No design system");
+        break;
+      case "agents":
+        lines.push("- ACTION: Customize skill instructions for this project's needs");
+        lines.push("- ACTION: Adjust agent roles if the project has different needs");
+        lines.push("- DELETE IF: Team doesn't use AI agents");
+        break;
+      case "ci":
+        lines.push("- ACTION: Verify the workflow matches real CI needs");
+        lines.push("- DELETE IF: Using different CI platform");
+        break;
+    }
+    lines.push("");
+  }
+  lines.push("## SHARED FILES (always generated)");
+  lines.push("");
+  lines.push("### .editorconfig");
+  lines.push("- ACTION: Verify it matches the project's formatting style");
+  lines.push("- KEEP: Always.");
+  lines.push("");
+  lines.push("### .markdownlint.json");
+  lines.push("- ACTION: Verify rules match team preferences");
+  lines.push("- KEEP: Always.");
+  lines.push("");
+  lines.push("## PLACEHOLDERS \u2014 search and verify");
+  lines.push("");
+  lines.push("The CLI replaced these automatically. VERIFY they are correct:");
+  lines.push("");
+  const placeholderEntries = [
+    [PLACEHOLDERS.projectName, "Project name \u2014 verify it's correct"],
+    [PLACEHOLDERS.techStack, "Language + framework \u2014 verify or update"],
+    [PLACEHOLDERS.devCommand, "Dev command \u2014 verify it works"],
+    [PLACEHOLDERS.buildCommand, "Build command \u2014 verify it works"],
+    [PLACEHOLDERS.testCommand, "Test command \u2014 verify it works"],
+    [PLACEHOLDERS.lintCommand, "Lint command \u2014 verify it works"],
+    [PLACEHOLDERS.date, "Generation date \u2014 should be correct"]
+  ];
+  for (const [ph, desc] of placeholderEntries) {
+    lines.push(`- ${ph} \u2192 ${desc}`);
+  }
+  lines.push("");
+  lines.push("If any placeholder was NOT replaced (shows as [BRACKETED TEXT]):");
+  lines.push("- Fill it with the real value");
+  lines.push("- If the value doesn't apply to this project, remove the placeholder and the surrounding context");
+  lines.push("");
+  lines.push("## RULES");
+  lines.push("");
+  lines.push('1. NEVER leave empty sections with "TODO", "pendiente", or "agregar aqu\xED"');
+  lines.push("   - If you don't have content for a section, REMOVE the section entirely");
+  lines.push("   - A shorter doc with real content > a long doc with placeholders");
+  lines.push("");
+  lines.push("2. If a generated file doesn't apply to this project, DELETE it");
+  lines.push(`   - Don't keep files "just in case"`);
+  lines.push("   - Update docs/README.md index after deleting");
+  lines.push("");
+  lines.push("3. If a whole module doesn't apply, DELETE the entire folder");
+  lines.push("   - Also remove it from AGENTS.md module list");
+  lines.push("");
+  lines.push("4. CONTEXT.md completeness must be > 50% before implementing features");
+  lines.push("   - If < 50%, stop and fill it first");
+  lines.push("");
+  lines.push("5. All content in docs/ should use the domain terms from CONTEXT.md");
+  lines.push("   - Consistency > creativity");
+  lines.push("");
+  lines.push("6. After filling all docs, run the project's lint and build to verify nothing is broken");
+  lines.push("");
+  return lines.join("\n");
+}
+
 // 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"));
+function showHelp() {
+  console.log(`
+${pc2.bold(brand.title("@damenor/agent-docs"))} ${pc2.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")}
+
+${pc2.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
+
+${pc2.bold("MODULES")}
+${DOC_MODULES.map((m) => `  ${pc2.cyan(m.value.padEnd(12))} ${m.label} \u2014 ${m.hint ?? ""}`).join("\n")}
+
+${pc2.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)
+
+${pc2.dim("Made with \u2764\uFE0F by damenordev")}
+`);
+}
+function showVersion() {
+  console.log(`@damenor/agent-docs v${pkg.version}`);
+}
 async function cli() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    showHelp();
+    return;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    showVersion();
+    process.exit(0);
+  }
+  if (args.includes("--agents-guide")) {
+    console.log(generateAgentsGuide());
+    process.exit(0);
+  }
   console.clear();
   p.intro(
-    `${icons.docs} ${brand.title("@damenor/agent-docs")} ${pc2.dim("v0.1.0")}
+    `${icons.docs} ${brand.title("@damenor/agent-docs")} ${pc2.dim(`v${pkg.version}`)}
    ${pc2.dim("Documentaci\xF3n profesional para proyectos con agentes AI")}`
   );
   const projectName = await p.text({
@@ -487,19 +719,33 @@ async function cli() {
     p.cancel("Operaci\xF3n cancelada.");
     process.exit(0);
   }
-  const selectedModules = await p.multiselect({
-    message: `${icons.package} M\xF3dulos a incluir ${pc2.dim("(espacio para seleccionar)")}`,
-    options: DOC_MODULES.map((mod) => ({
-      value: mod.value,
-      label: mod.label,
-      hint: mod.hint
-    })),
-    required: false
+  const allModules = await p.confirm({
+    message: `${icons.package} \xBFIncluir todos los m\xF3dulos?`,
+    initialValue: true
   });
-  if (p.isCancel(selectedModules)) {
+  if (p.isCancel(allModules)) {
     p.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)")}`,
+      options: DOC_MODULES.map((mod) => ({
+        value: mod.value,
+        label: mod.label,
+        hint: mod.hint
+      })),
+      required: false
+    });
+    if (p.isCancel(picked)) {
+      p.cancel("Operaci\xF3n cancelada.");
+      process.exit(0);
+    }
+    selectedModules = picked;
+  }
   const initGit2 = await p.confirm({
     message: `${icons.gear} \xBFInicializar repositorio git?`,
     initialValue: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damenor/agent-docs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI para generar documentación profesional para proyectos con agentes AI",
   "type": "module",
   "bin": {