@ancleto/spec 0.6.32 → 0.6.33

package/README.md

@@ -178,7 +178,7 @@ El registro es tuyo y local: no viaja con el repo ni se comparte. `ANCLETO_PROJE
 En la primera ejecución, un **wizard interactivo** te guía por los pasos de configuración (agente/IDE y nivel de gasto). También podés pasarlos por flags:
 
 ```bash
-ancleto init --agent opencode --tier normal
+ancleto init --agent opencode --tier normal --lang es
 ```
 
 | Tier | Qué hace |
@@ -189,6 +189,17 @@ ancleto init --agent opencode --tier normal
 
 La configuración se preserva en `.ancletorc` (raíz del proyecto) y `.ancleto-tier` (junto a la configuración instalada).
 
+### Idioma de los artifacts
+
+El contenido de `proposal.md`, `design.md`, `tasks.md` y `specs/` se escribe en el idioma de tu conversación (`auto`, el default) o en el código que fijes con `--lang`:
+
+```bash
+ancleto init --lang auto   # detecta el idioma de tus primeros mensajes y lo guarda
+ancleto init --lang es     # fija español para ese proyecto
+```
+
+Con `auto`, el orquestador detecta el idioma en tus primeros hasta 3 mensajes y lo persiste en `.ancletorc` → `language`. Podés volver a `auto` o fijar otro código cuando quieras (`auto | es | en | pt`). Lo que **nunca** se traduce: los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`) y los nombres de archivos y directorios.
+
 ---
 
 ## Uso rápido
@@ -226,10 +237,10 @@ ancleto discovery         # Genera .discovery-map.json y empaqueta el repo
 ## Referencia de comandos CLI
 
 ```bash
-ancleto init [--agent <nombre>] [--tier <nivel>] [--with-azure]
+ancleto init [--agent <nombre>] [--tier <nivel>] [--lang <codigo>] [--with-azure]
                           # Configura el proyecto (interactivo en TTY)
 
-ancleto install [--project <dir>] [--tier <nivel>] [--agent <nombre>] [--no-mcp]
+ancleto install [--project <dir>] [--tier <nivel>] [--agent <nombre>] [--lang <codigo>] [--no-mcp]
                           # Instala agentes, skills y templates
 
 ancleto update            # Re-instala la última versión sobre lo existente

package/agents/documenter.md

@@ -117,7 +117,7 @@ Do not treat archive as a blind file move.
 
 When a completed change modifies behavior through aspec deltas, `aspec/specs/` must reflect that completed behavior before the change is archived.
 
-**Language**: spec artifacts are written in English. The requirement/scenario keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. Paths, file names, and identifiers stay unchanged.
+**Language**: write spec content in the user's conversation language (or the project's configured `language` in `.ancletorc`). The requirement/scenario keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. Paths, file names, and identifiers stay unchanged.
 
 Handle these delta sections carefully:
 

package/agents/orchestrator.md

@@ -124,7 +124,17 @@ Azure DevOps is optional and **disabled by default**. Before any Work Item intak
 
 ### Resolved Context Envelope
 
-Keep this envelope for the entire session. Do not reconstruct it from memory or reduce it to a prose summary. When a Work Item was resolved, it contains its id, title, type, project, full normalized description, and full acceptance criteria. Add the original user request, enumerated requirements, explicit restrictions, and later user decisions or exclusions.
+Keep this envelope for the entire session. Do not reconstruct it from memory or reduce it to a prose summary. When a Work Item was resolved, it contains its id, title, type, project, full normalized description, and full acceptance criteria. Add the original user request, enumerated requirements, explicit restrictions, and later user decisions or exclusions. Carry the resolved artifacts language (`language`) in the envelope as well.
+
+### Artifacts Language
+
+Resolve the working language for artifact content once per session:
+
+- Read `language` from `.ancletorc` at the repo root.
+- If it is `auto`, detect the language from the user's first up to 3 messages in this session. If the user never deviates, that language governs.
+- Persist it: the first write-capable delegation in the session (`@spec-writer` when spec generation runs, otherwise `@coder`) MUST update `.ancletorc` → `language` with the resolved code, but only when it is currently `auto`. This is silent bookkeeping — never ask the user for it. An explicit configured code is never overwritten.
+- Pass the resolved `language` in the Resolved Context Envelope to every subagent that writes artifacts.
+- Artifact content uses the resolved language; keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names stay literal English.
 
 Pass the relevant envelope verbatim when delegating: `@coder` receives the implementation scope; `@tester` receives it plus the coder's modified files and risks; `@reviewer` receives it plus task-owned files and the Validation Ledger. Do not omit numbered requirements, paths, commands, acceptance criteria, or explicit exclusions. Only `@context-resolver` may fetch a Work Item. If a subagent says it lacks context, supply the envelope or stop; never tell it to query Azure DevOps.
 

package/agents/spec-writer.md

@@ -19,9 +19,9 @@ Read `AGENTS.md` at the repo root for project-specific conventions, tech stack,
 
 ## Language Requirement
 
-- All artifact content MUST be written in English
-- Keywords are literal and MUST NOT be translated: `Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED Requirements`, `MODIFIED Requirements`, `REMOVED Requirements`, `RENAMED Requirements`
-- File names and directory names MUST remain in English, following aspec conventions
+- Write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`)
+- Keywords are literal and MUST NOT be translated: `Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED Requirements`, `MODIFIED Requirements`, `REMOVED Requirements`, `RENAMED Requirements`
+- File names and directory names are literal and MUST NOT be translated: English kebab-case, following aspec conventions
 
 ## Primary Responsibility
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancleto/spec",
-  "version": "0.6.32",
+  "version": "0.6.33",
   "description": "Orquestador SDD liviano con subagentes optimizados para costo/tokens",
   "type": "module",
   "bin": {

package/skills/ancleto-archive/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Archive
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Archive a completed change: check completion, sync delta specs, move the directory. No external binaries.
 

package/skills/ancleto-bulk-archive/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Bulk Archive
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Archive many completed changes at once, resolving spec conflicts against the implementation. No external binaries.
 

package/skills/ancleto-continue/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Continue
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Continue a change by creating exactly ONE next artifact. No external binaries: state is derived by which artifact files exist.
 

package/skills/ancleto-explore/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Explore
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Enter explore mode. Think deeply. Visualize freely. Follow the conversation.
 

package/skills/ancleto-ff/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec FF
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Fast-forward artifact creation: generate everything needed to start implementation, writing files directly. No external binaries.
 

package/skills/ancleto-new/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec New
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Start a new change with a filesystem-native, artifact-driven flow. No external binaries: every step is a direct file operation.
 

package/skills/ancleto-onboard/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Onboard
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Walk a first-time user through one complete spec-driven cycle on a real task. No external binaries.
 

package/skills/ancleto-propose/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Propose
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Create a change and all its artifacts in one step, writing files directly. No external binaries.
 

package/skills/ancleto-sync-specs/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Sync
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Sync delta specs from a change to main specs.
 

package/skills/ancleto-upgrade/SKILL.md

@@ -19,7 +19,7 @@ metadata:
 
 # ancleto-upgrade
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Generate an aspec change migrating any library/runtime to a new major version; never edit code.
 

package/src/cli/index.js

@@ -32,14 +32,15 @@ Uso:
   ancleto install --no-mcp           Igual que install pero sin tocar config MCP
   ancleto install --with-engram      Ademas configura el MCP externo engram (memoria opcional)
   ancleto install --tier <nivel>     normal | minimo | gratis (wizard interactivo en TTY)
+  ancleto install --lang <codigo>    auto | es | en | pt (idioma de los artifacts; auto = idioma de la conversacion)
   ancleto install --agent <nombre>    opencode | vscode | antigravity | cursor | roo (wizard si no esta guardado)
   ancleto update [--project <dir>]    Alias de install (re-instala sobre lo existente)
                                    Parado en un proyecto con .ancletorc opera sobre ese proyecto;
                                    usa --global para forzar el alcance global
   ancleto upgrade [--agent <nombre>]  Re-aplica templates (LOCKED) y skills sobre el proyecto actual
-  ancleto init [--with-azure] [--agent <nombre>] [--tier <nivel>]
-                                    Crea .ancletorc en el repositorio actual
-                                    (interactivo en TTY: banner + menu; Azure desactivado por defecto)
+  ancleto init [--with-azure] [--agent <nombre>] [--tier <nivel>] [--lang <codigo>]
+                                     Crea .ancletorc en el repositorio actual
+                                     (interactivo en TTY: banner + menu; Azure desactivado por defecto)
   ancleto discovery --check           Estado del seed (READY/STALE/PARTIAL/MISSING)
   ancleto discovery [--compress] [--include G] [--ignore G] [--token-budget N]
                                    Empaca el repo con Repomix y guarda estado
@@ -622,6 +623,22 @@ function scanTierFlag(args) {
   return t
 }
 
+const SUPPORTED_LANGS = ['auto', 'es', 'en', 'pt']
+
+function scanLangFlag(args) {
+  const l = flagValue(args, '--lang')
+  if (!l) return null
+  if (!SUPPORTED_LANGS.includes(l)) {
+    console.error(`ancleto: idioma invalido: ${l} (${SUPPORTED_LANGS.join('|')})`)
+    process.exit(1)
+  }
+  return l
+}
+
+function langLabel(code) {
+  return { auto: 'automatico (idioma de la conversacion)', es: 'espanol', en: 'ingles', pt: 'portugues' }[code] || code
+}
+
 async function resolveAgent(args, existing, allowAsk = Boolean(process.stdin.isTTY)) {
   const flag = scanAgentFlag(args)
   if (flag) return flag
@@ -820,9 +837,10 @@ async function install(args) {
     : null
 
   let agent = agentFlag || (existingRc?.agent && SUPPORTED_AGENTS.includes(existingRc.agent) ? existingRc.agent : null)
+  let language = scanLangFlag(args) || (existingRc?.language && SUPPORTED_LANGS.includes(existingRc.language) ? existingRc.language : null)
 
   let bannerShown = false
-  const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier)
+  const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier || !language)
   if (isInteractive) {
     await showBanner()
     bannerShown = true
@@ -833,8 +851,13 @@ async function install(args) {
       const current = TIERS[storedTier] ? storedTier : ''
       tier = await selectOption('Tier de costo', Object.keys(TIERS), Math.max(0, Object.keys(TIERS).indexOf(current)))
     }
+    if (!language) {
+      const picked = await selectOption('Idioma de los artifacts', SUPPORTED_LANGS.map(langLabel), 0)
+      language = SUPPORTED_LANGS[SUPPORTED_LANGS.map(langLabel).indexOf(picked)] || 'auto'
+    }
     stopBanner()
   }
+  if (!language) language = 'auto'
 
   if (projectDir && !agent) agent = DEFAULT_AGENT
   if (!tier) tier = TIERS[storedTier] ? storedTier : 'normal'
@@ -862,6 +885,7 @@ async function install(args) {
     const agentSkillsDir = await installAgentSkills(projectDir, agent)
     await writeManifest(projectDir, {
       agent,
+      language,
       ...(gratisModelChoice ? { gratisModel: gratisModelChoice } : {}),
       installedPaths: {
         templates: ['AGENTS.md', 'PRODUCT.md'],
@@ -942,13 +966,15 @@ async function initProject(args) {
   const withAzure = args.includes('--with-azure')
   const agentFlag = scanAgentFlag(args)
   const tierFlag = scanTierFlag(args)
+  const langFlag = scanLangFlag(args)
   const existing = await readAncletorc(projectDir)
   const azure = existing?.azure ?? { enabled: false }
   const discovery = existing?.discovery ?? { outputDir: 'docs/technical-discovery', exclude: [] }
   const tierFile = join(projectDir, '.opencode', '.ancleto-tier')
 
-  let agent, tier
-  const isInteractive = Boolean(process.stdout.isTTY) && (!agentFlag || !tierFlag)
+  let agent, tier, language
+  language = langFlag || (existing?.language && SUPPORTED_LANGS.includes(existing.language) ? existing.language : null)
+  const isInteractive = Boolean(process.stdout.isTTY) && (!agentFlag || !tierFlag || !language)
   if (isInteractive) {
     await showBanner()
     const agentIdx = Math.max(0, SUPPORTED_AGENTS.indexOf(existing?.agent))
@@ -956,6 +982,10 @@ async function initProject(args) {
     const tierIdx = Math.max(0, Object.keys(TIERS).indexOf(TIERS[storedTier] ? storedTier : ''))
     agent = agentFlag || await selectOption('Agente/IDE', SUPPORTED_AGENTS, agentIdx)
     tier = tierFlag || await selectOption('Tier de costo', Object.keys(TIERS), tierIdx)
+    if (!language) {
+      const picked = await selectOption('Idioma de los artifacts', SUPPORTED_LANGS.map(langLabel), 0)
+      language = SUPPORTED_LANGS[SUPPORTED_LANGS.map(langLabel).indexOf(picked)] || 'auto'
+    }
     if (withAzure) {
       azure.enabled = true
     } else {
@@ -965,6 +995,7 @@ async function initProject(args) {
   } else {
     agent = await resolveAgent(args, existing?.agent, false)
     tier = tierFlag
+    if (!language) language = 'auto'
     if (withAzure) azure.enabled = true
   }
 
@@ -973,13 +1004,13 @@ async function initProject(args) {
     await writeFile(tierFile, tier + '\n')
   }
 
-  const manifest = await writeManifest(projectDir, { azure, discovery, agent })
+  const manifest = await writeManifest(projectDir, { azure, discovery, agent, language })
   await copyTemplates(projectDir)
   await scaffoldAspec(projectDir)
   await refreshWorkingContext(projectDir)
   await registerProject(projectDir, { agent, tier: tier || null })
   if (azure.enabled) console.log(AZURE_MCP_NOTICE)
-  console.log(`ancleto: .ancletorc actualizado en ${projectDir} (v${manifest.version})${azure.enabled ? ' (Azure habilitado)' : ' (Azure desactivado)'} (Agente: ${agent})${tier ? ` (Tier: ${tier})` : ''}`)
+  console.log(`ancleto: .ancletorc actualizado en ${projectDir} (v${manifest.version})${azure.enabled ? ' (Azure habilitado)' : ' (Azure desactivado)'} (Agente: ${agent})${tier ? ` (Tier: ${tier})` : ''} (Idioma: ${language})`)
 }
 
 const DEFAULT_IGNORES = ['node_modules', '.git', 'dist']

package/templates/AGENTS.md

@@ -71,9 +71,13 @@ comparte.
 - **Cambios con scope incierto / arquitectura**: Crear artifacts en `aspec/changes/<name>/`.
 - **Cambios menores / fixes**: Implementación directa.
 - **Cierre**: Archivar con `/cleto-archive` al finalizar.
+
+<!-- LOCKED: artifacts-language -->
 - **Idioma de los artifacts**: el contenido de `proposal.md`, `design.md`, `tasks.md` y `specs/` se escribe
-  en **inglés**. Los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED
-  Requirements`) son literales y **no se traducen**. Nombres de archivos y directorios: inglés kebab-case.
+  en el idioma de la conversación con el usuario (o en el `language` configurado en `.ancletorc`).
+  Los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED
+  Requirements`) y los nombres de archivos y directorios son literales en inglés y **no se traducen**.
+<!-- /LOCKED: artifacts-language -->
 
 ## Tools de Soporte