@damenor/agent-docs 0.4.0 → 0.5.0

package/README.md

@@ -80,7 +80,7 @@ my-project/
 │   ├── product/           📊 Overview & roadmap (what are we building again?)
 │   ├── operations/        🔧 Monitoring & incidents (when prod goes brrr)
 │   └── adr/               📐 Architecture Decision Records (decisions that last)
-├── .agents/               🤖 5 skills + 5 agents (your AI team is ready)
+├── .opencode/               🤖 7 skills + 6 agents (your AI team is ready)
 ├── .github/workflows/     ⚙️ CI/CD for docs (never ship broken docs again)
 ├── .editorconfig
 └── .markdownlint.json
@@ -101,7 +101,7 @@ Every project is different. Mix and match:
 | 📊 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         |
+| 🤖 AI Agent Skills | 7 skills + 6 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.

package/dist/index.js

@@ -102,9 +102,9 @@ var DOC_MODULES = [
   {
     value: "agents",
     label: "Skills para agentes AI",
-    hint: ".agents/ con 5 skills + 5 agents",
+    hint: ".opencode/ con 7 skills + 6 agents",
     templateDir: "agents",
-    files: [".agents/"]
+    files: [".opencode/"]
   },
   {
     value: "ci",
@@ -770,7 +770,7 @@ var labels = {
   stackCommandsHeader: "Comandos probables",
   // ── Convenciones ──
   conventionsTitle: "Convenios obligatorios",
-  convLang: "**Idioma**: C\xF3digo en **ingl\xE9s**. Comentarios y docs en **espa\xF1ol**.",
+  convLang: "**Idioma del proyecto**: La documentaci\xF3n est\xE1 configurada en **{{PROJECT_LANGUAGE_LABEL}}** ({{PROJECT_LANGUAGE_CODE}}). Genera y actualiza toda la documentaci\xF3n en {{PROJECT_LANGUAGE_LABEL}}, independientemente del idioma en que te hable el usuario. El c\xF3digo fuente sigue en ingl\xE9s.",
   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.",
@@ -848,8 +848,8 @@ var labels = {
   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/`",
+  skillsList: "**Skills**: `doc-scaffold`, `doc-write`, `doc-design`, `doc-review`, `doc-maintain`, `publish`, `test-writing` \u2014 ver `.opencode/skills/`",
+  agentsList: "**Agentes**: `@planner`, `@reviewer`, `@doc-writer`, `@doc-reviewer`, `@doc-designer`, `@doc-maintainer` \u2014 ver `.opencode/agents/`",
   skillsGuide: "**Gu\xEDa extendida**: `docs/internal/agent-guide.md`",
   // ── Tabla de detección de stack ──
   stackRowPackage: "`package.json`",
@@ -932,7 +932,7 @@ var labels2 = {
   stackCommandsHeader: "Probable Commands",
   // ── Conventions ──
   conventionsTitle: "Mandatory Conventions",
-  convLang: "**Language**: Code in **English**. Comments and docs in **English**.",
+  convLang: "**Project Language**: Documentation is configured in **{{PROJECT_LANGUAGE_LABEL}}** ({{PROJECT_LANGUAGE_CODE}}). Generate and update all documentation in {{PROJECT_LANGUAGE_LABEL}}, regardless of the language the user speaks to you. Source code remains 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.",
@@ -1010,8 +1010,8 @@ var labels2 = {
   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/`",
+  skillsList: "**Skills**: `doc-scaffold`, `doc-write`, `doc-design`, `doc-review`, `doc-maintain`, `publish`, `test-writing` \u2014 see `.opencode/skills/`",
+  agentsList: "**Agents**: `@planner`, `@reviewer`, `@doc-writer`, `@doc-reviewer`, `@doc-designer`, `@doc-maintainer` \u2014 see `.opencode/agents/`",
   skillsGuide: "**Extended guide**: `docs/internal/agent-guide.md`",
   // ── Stack detection table ──
   stackRowPackage: "`package.json`",
@@ -1162,9 +1162,12 @@ tags: [${t("fmTags")}]
   md += `| ${t("stackRowJava")} | ${t("stackRowJavaEco")} | ${t("stackRowJavaCmds")} |
 
 `;
+  const LANG_LABELS = { es: "espa\xF1ol", en: "English" };
+  const langLabel = LANG_LABELS[options.language] ?? options.language;
+  const langCode = options.language;
   md += `### ${t("conventionsTitle")}
 `;
-  md += `1. ${t("convLang")}
+  md += `1. ${t("convLang").replaceAll("{{PROJECT_LANGUAGE_LABEL}}", langLabel).replaceAll("{{PROJECT_LANGUAGE_CODE}}", langCode)}
 `;
   md += `2. ${t("convNaming")}
 `;
@@ -1374,6 +1377,9 @@ var labels3 = {
   bizTermsTerm: "T\xE9rmino",
   bizTermsDef: "Definici\xF3n",
   bizTermsNotes: "Notas",
+  projectLangTerm: "Idioma del proyecto",
+  projectLangDef: "{{PROJECT_LANGUAGE_LABEL}} ({{PROJECT_LANGUAGE_CODE}}) \u2014 Idioma oficial de la documentaci\xF3n generada por el CLI",
+  projectLangNotes: "Ver AGENTS.md \xA7 Stack y convenciones",
   techTermsTitle: "T\xE9rminos t\xE9cnicos internos",
   techTermsTerm: "T\xE9rmino",
   techTermsDef: "Definici\xF3n",
@@ -1426,6 +1432,9 @@ var labels4 = {
   bizTermsTerm: "Term",
   bizTermsDef: "Definition",
   bizTermsNotes: "Notes",
+  projectLangTerm: "Project language",
+  projectLangDef: "{{PROJECT_LANGUAGE_LABEL}} ({{PROJECT_LANGUAGE_CODE}}) \u2014 Official documentation language set by the CLI",
+  projectLangNotes: "See AGENTS.md \xA7 Stack and Conventions",
   techTermsTitle: "Internal Technical Terms",
   techTermsTerm: "Term",
   techTermsDef: "Definition",
@@ -1461,6 +1470,10 @@ 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];
+  const LANG_LABELS = { es: "Espa\xF1ol", en: "English" };
+  const langLabel = LANG_LABELS[options.language] ?? options.language;
+  const langCode = options.language;
+  const projectLangDef = t("projectLangDef").replaceAll("{{PROJECT_LANGUAGE_LABEL}}", langLabel).replaceAll("{{PROJECT_LANGUAGE_CODE}}", langCode);
   let md = `---
 created: "2025-01-01"
 updated: "${today}"
@@ -1500,6 +1513,7 @@ ${t("introGap")}
 
 | ${t("bizTermsTerm")} | ${t("bizTermsDef")} | ${t("bizTermsNotes")} |
 |---------|-----------|-------|
+| **${t("projectLangTerm")}** | ${projectLangDef} | ${t("projectLangNotes")} |
 | **[T\xE9rmino]** | [definici\xF3n] | [notas] |
 
 ## ${t("techTermsTitle")}

package/package.json

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

package/templates/modules/agents/.agents/agents/doc-maintainer.md

@@ -51,4 +51,4 @@ You are the documentation maintainer. Your job is to keep `docs/` synchronized w
 - If the change is minor (typo, reorder), do not update docs
 - If the change is significant, update ALL affected docs
 - Always update the `updated:` frontmatter on each modified file
-- Content in Spanish, technical terms in English
+- Content in the project's documentation language (see AGENTS.md), technical terms in English

package/templates/modules/agents/.agents/agents/doc-writer.md

@@ -44,7 +44,7 @@ You are an expert technical writer. Your ONLY job is to write and update the pro
 
 ## Rules
 
-- Content in **Spanish**, technical terms in **English**
+- Content in the **project's documentation language** (see AGENTS.md), technical terms in **English**
 - NEVER write empty placeholders (TODO, TBD) — if you don't have information, ask
 - Each file must be useful on its own
 - Cross-reference with wikilinks where relevant

package/templates/modules/agents/.agents/skills/doc-write/SKILL.md

@@ -3,7 +3,8 @@ name: doc-write
 description: >
   Writes documentation following Diátaxis + ADR + CONTEXT conventions.
   Classifies content by type before writing, generates ADRs when applicable,
-  and keeps CONTEXT.md updated. All content in English with technical
+  and keeps CONTEXT.md updated. All content in the project's documentation language
+  (as defined in AGENTS.md § Stack and Conventions), with technical
   terms kept in English.
   TRIGGER: When the user says "write doc", "document X", "create ADR",
   "update CONTEXT", "new documentation", or any documentation file
@@ -91,7 +92,7 @@ Write for:
 - **Humans**: Clarity, examples, logical flow
 - **AI agents**: Consistent structure, terms defined in CONTEXT.md, clear cross-references
 
-### RULE #7: Content in English
+### RULE #7: Content in the project's documentation language
 
 ```
 ✅ "To configure the authentication middleware..."