@damenor/agent-docs 0.4.0 → 0.4.1

package/dist/index.js

@@ -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.",
@@ -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.",
@@ -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.4.1",
   "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..."