create-quiver 0.15.3 → 0.15.4

package/.github/workflows/ci.yml

@@ -7,6 +7,9 @@ on:
       - develop
   pull_request:
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   validate:
     runs-on: ubuntu-latest

package/AGENTS.md.es.template

@@ -0,0 +1,37 @@
+# Agentes de {{PROJECT_NAME}}
+
+## Proposito
+
+Este archivo orienta a agentes de IA y personas que trabajan en el proyecto.
+
+## Presupuesto de lectura
+
+- Empeza por `README.md`.
+- Usa `docs/INDEX.md` como mapa.
+- Lee solo los documentos necesarios para la tarea actual.
+
+## Orden de lectura
+
+1. `docs/INDEX.md`
+2. `docs/PROJECT_MAP.md`, si existe
+3. `docs/AI_CONTEXT.md`
+4. `docs/AI_ONBOARDING_PROMPT.md`
+5. El spec y slice activos, si la tarea los requiere
+
+## Politica de salida
+
+- Responde con cambios y evidencia verificable.
+- No inventes reglas de negocio, rutas, flags ni convenciones.
+- No leas todo `docs/` sin una razon documentada.
+
+## Reglas de ejecucion de slices
+
+- Un slice equivale a un commit.
+- Un spec equivale a un PR.
+- No modifiques archivos fuera del scope declarado por el slice.
+
+## Links
+
+- `docs/WORKFLOW.md`
+- `docs/STATUS.md`
+- `docs/DECISIONS.md`

package/docs/AI_CONTEXT.md.es.template

@@ -0,0 +1,35 @@
+# Contexto IA de {{PROJECT_NAME}}
+
+Este archivo comprime el contrato de trabajo para agentes IA. Usa los documentos canonicos cuando necesites mas detalle.
+
+## Que es este proyecto
+
+[Resumen corto del proyecto.]
+
+## Leer primero
+
+1. `docs/PROJECT_MAP.md`
+2. `docs/INDEX.md`
+3. `docs/AI_ONBOARDING_PROMPT.md`
+4. `docs/DECISIONS.md`
+5. `docs/CONTEXTO.md`
+6. `docs/WORKFLOW.md`
+7. `specs/{{PROJECT_SLUG}}/SPEC.md`
+8. `specs/{{PROJECT_SLUG}}/slices/[slice-id]/slice.json`
+
+## Reglas criticas
+
+- Un slice equivale a un commit.
+- Un spec equivale a un PR.
+- No inventes archivos, rutas, flags ni reglas de negocio.
+- No sobrescribas contenido humano sin revisar si debe preservarse.
+- Usa `TODO`, `Assumption` o `Pending confirmation` para incertidumbre.
+- Los prompts y salidas JSON son contratos estables y no deben traducirse.
+
+## Comandos utiles
+
+```bash
+npx create-quiver flow
+npx create-quiver dashboard
+npx create-quiver spec validate specs/{{PROJECT_SLUG}} --strict
+```

package/docs/AI_ONBOARDING_PROMPT.md.es.template

@@ -0,0 +1,22 @@
+# Prompt de onboarding IA de {{PROJECT_NAME}}
+
+**Fecha:** {{FECHA}}
+**Estado:** {{ESTADO}}
+
+Actua como asistente tecnico senior para este proyecto. Tu objetivo es entender el contexto minimo necesario y trabajar con WDD + SDD sin improvisar.
+
+## Reglas de ejecucion
+
+1. Lee `docs/INDEX.md` como mapa antes de abrir otros documentos.
+2. Lee solo los documentos relevantes para la tarea actual.
+3. Si hay spec/slice activo, usa `slice.json`, `EXECUTION_BRIEF.md` y `CLOSURE_BRIEF.md` como contrato.
+4. No modifiques codigo de producto sin autorizacion o slice aprobado.
+5. No traduzcas comandos, flags, rutas, ids, providers, modelos ni JSON.
+6. Si falta informacion critica, pregunta antes de avanzar.
+7. Si hay conflicto documental, reportalo y detenete.
+
+## Proximo paso recomendado
+
+```bash
+npx create-quiver flow
+```

package/docs/CLI_UX_GUIDE.md

@@ -42,6 +42,52 @@ Reglas:
 | `--json` | Emite salida machine-readable. | Incompatible con `--interactive` y `--review`. |
 | `--no-color` | Desactiva color ANSI. | Debe respetarse en toda salida humana. |
 
+## Idioma de salida
+
+Quiver soporta salida humana en `en` y `es`. Los comandos deben resolver el idioma con esta precedencia:
+
+1. `--lang en|es`
+2. `QUIVER_LANG`
+3. `.quiver/config.json`
+4. `~/.quiver/config.json`
+5. locale del entorno
+6. fallback `en`
+
+Reglas:
+
+- `--lang` debe funcionar antes o despues del comando.
+- `config language set es` guarda el idioma del proyecto sin exigir flags en cada ejecucion.
+- `config language set en --global` guarda el idioma global del usuario.
+- Los comandos, flags, rutas, ids, providers, modelos y snippets sugeridos no se traducen.
+- `--json` mantiene claves, codigos y estructura estable; no se localizan campos machine-readable.
+- Warnings por idioma no soportado se muestran solo en salida humana y no contaminan stdout JSON.
+- CI, no-TTY y `--no-color` deben seguir sin prompts, spinners ni ANSI inesperado.
+
+## Templates y docs generados
+
+La salida CLI y los docs generados comparten resolucion de idioma, pero son superficies distintas:
+
+- salida CLI: textos humanos impresos durante un comando;
+- docs generados: archivos Markdown creados por comandos como `init`;
+- machine artifacts: JSON, JSONL, `package.json`, `slice.json`, ids, comandos, flags, rutas, providers y modelos.
+
+Solo las dos primeras superficies se localizan. Los machine artifacts permanecen estables.
+
+Los templates humanos generados por Quiver usan el mismo idioma resuelto para la salida CLI. El template base sin sufijo es el fallback `en`; las variantes localizadas agregan el idioma antes de `.template`.
+
+Ejemplos:
+
+- `docs/INDEX.md.template` es el fallback estable en ingles.
+- `docs/INDEX.md.es.template` es la variante espanola.
+- `AGENTS.md.es.template` es la variante espanola de `AGENTS.md.template`.
+
+Reglas:
+
+- Solo se enrutan templates humanos, principalmente Markdown.
+- Artefactos machine-readable como `package.template.json` y `slice.json` no se localizan.
+- Si falta una variante localizada, Quiver debe hacer fallback explicito a `en` y la cobertura debe poder detectarlo en tests.
+- No duplicar templates grandes si una fragmentacion compartida resuelve el caso con menor mantenimiento.
+
 ## Matriz de soporte
 
 | Comando | `--with-planner` | `--interactive` | `--review` | Notas |

package/docs/COMMANDS.md.es.template

@@ -0,0 +1,28 @@
+# Comandos
+
+**Proyecto:** {{PROJECT_NAME}}
+**Ultima actualizacion:** {{FECHA}}
+
+Este documento resume los comandos principales del workflow Quiver. Los comandos, flags y snippets se mantienen sin traducir.
+
+## Tabla de comandos
+
+| Comando | Proposito | Ejemplo |
+|---|---|---|
+| `npx create-quiver init --name "<project>"` | Crea el contrato Quiver inicial del proyecto | `npx create-quiver init --name "{{PROJECT_NAME}}"` |
+| `npx create-quiver init --interactive` | Guia modo de proyecto, metodologia, perfil e idioma | `npx create-quiver init --interactive` |
+| `npx create-quiver analyze` | Genera mapa visible del proyecto y scan interno | `npx create-quiver analyze` |
+| `npx create-quiver flow` | Muestra el proximo paso seguro | `npx create-quiver flow` |
+| `npx create-quiver dashboard` | Resume specs, slices, runs, agentes y aprobaciones | `npx create-quiver dashboard` |
+| `npx create-quiver ai agent set planner --provider <provider> --model <model>` | Configura el perfil del planner sin guardar credenciales | `npx create-quiver ai agent set planner --provider codex --model gpt-5.5 --dry-run` |
+| `npx create-quiver ai plan --phase acceptance --input <requirements.md>` | Genera criterios de aceptacion para aprobar | `npx create-quiver ai plan --phase acceptance --input requirements.md --dry-run` |
+| `npx create-quiver ai review-plan` | Revisa el plan tecnico antes de aprobarlo | `npx create-quiver ai review-plan --dry-run` |
+| `npx create-quiver spec create` | Crea el paquete de spec desde un plan tecnico aprobado | `npx create-quiver spec create --dry-run` |
+| `npx create-quiver spec validate <spec>` | Valida estructura y handoffs del spec | `npx create-quiver spec validate specs/<spec> --strict` |
+
+## Reglas
+
+- Usa `--dry-run` antes de escrituras.
+- Usa `--json` solo para automatizacion.
+- Configura idioma con `npx create-quiver config language set es` o `--lang es`.
+- Los artefactos machine-readable no se traducen.

package/docs/CONTEXTO.md.es.template

@@ -0,0 +1,33 @@
+# Contexto de {{PROJECT_NAME}}
+
+## Que es {{PROJECT_NAME}}?
+
+[Uno o dos parrafos que expliquen el proyecto.]
+
+## Propuesta de valor
+
+> "[Frase principal del proyecto]"
+
+## Usuario objetivo
+
+[Describe el usuario principal.]
+
+## Foco actual
+
+- [Objetivo actual 1]
+- [Objetivo actual 2]
+- [TODO: confirmar contexto antes de ampliar alcance]
+
+## Donde vive el stack
+
+El stack, package manager y comandos se generan en `docs/PROJECT_MAP.md` despues de ejecutar `analyze`.
+
+## Seguridad y privacidad
+
+- [Datos sensibles que nunca se guardan]
+- [Datos que si se guardan]
+- [Medida de seguridad importante]
+
+## Proximo paso
+
+Si sos agente IA, lee `AI_CONTEXT.md`. Si sos humano, usa `INDEX.md` para navegar la documentacion.

package/docs/DECISIONS.md.es.template

@@ -0,0 +1,17 @@
+# Registro de decisiones de {{PROJECT_NAME}}
+
+**Fecha:** {{FECHA}}
+**Estado:** {{ESTADO}}
+
+Este archivo registra decisiones durables para que agentes y personas no vuelvan a discutir elecciones ya tomadas.
+
+## Registro
+
+| Fecha | Decision | Razon | Alternativas | Impacto |
+|---|---|---|---|---|
+
+## Reglas
+
+- Registra una decision por fila.
+- Manten cada entrada corta y especifica.
+- Agrega una nueva fila cuando una eleccion pueda reabrirse en trabajos futuros.

package/docs/GITFLOW_PR_GUIDE.md.es.template

@@ -0,0 +1,25 @@
+# Guia Git y PR
+
+## Reglas principales
+
+- Un slice equivale a un commit.
+- Un spec equivale a un PR.
+- No mezclar specs en la misma branch.
+- No abrir PR sin evidencia de validacion.
+
+## Preflight de PR
+
+```bash
+npx create-quiver ai pr --dry-run --ssh-host-alias <alias> --identity-file <key> --input <pr.md>
+```
+
+## Secciones requeridas del PR
+
+- `## Title`
+- `## Summary`
+- `## Scope`
+- `## Files`
+- `## How to Test (DETAILED - REQUIRED)`
+- `## Evidence`
+- `## Rollback`
+- `## Risks / Notes`

package/docs/INDEX.md

@@ -1,6 +1,6 @@
 # Quiver Documentation Index
 
-**Last updated:** 2026-05-28
+**Last updated:** 2026-05-29
 
 Use this file as the first documentation map before planning, implementing, reviewing, or opening PRs in this repository. Prefer the smallest set of linked documents that fits the task.
 
@@ -39,6 +39,15 @@ Canonical specs live outside `docs/` in [`../specs/`](../specs/).
 
 Recent specs:
 
+- [`../specs/quiver-v45-ci-actions-node24-readiness/SPEC.md`](../specs/quiver-v45-ci-actions-node24-readiness/SPEC.md)
+- [`../specs/quiver-v44-provider-live-output-tui-lite/SPEC.md`](../specs/quiver-v44-provider-live-output-tui-lite/SPEC.md)
+- [`../specs/quiver-v43-cli-i18n-audit-release-readiness/SPEC.md`](../specs/quiver-v43-cli-i18n-audit-release-readiness/SPEC.md)
+- [`../specs/quiver-v42-cli-i18n-generated-docs/SPEC.md`](../specs/quiver-v42-cli-i18n-generated-docs/SPEC.md)
+- [`../specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md`](../specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md)
+- [`../specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md`](../specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md)
+- [`../specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md`](../specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md)
+- [`../specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md`](../specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md)
+- [`../specs/quiver-v37-cli-i18n-foundation/SPEC.md`](../specs/quiver-v37-cli-i18n-foundation/SPEC.md)
 - [`../specs/quiver-v36-ai-run-watch-portable/SPEC.md`](../specs/quiver-v36-ai-run-watch-portable/SPEC.md)
 - [`../specs/quiver-v35-compact-dashboard-version-ux/SPEC.md`](../specs/quiver-v35-compact-dashboard-version-ux/SPEC.md)
 - [`../specs/quiver-v34-cli-dashboard-status/SPEC.md`](../specs/quiver-v34-cli-dashboard-status/SPEC.md)

package/docs/INDEX.md.es.template

@@ -0,0 +1,36 @@
+# Indice de documentacion de {{PROJECT_NAME}}
+
+**Ultima actualizacion:** {{FECHA}}
+
+## Empezar aca
+
+- **Contexto** - `./CONTEXTO.md`
+- **Contexto para IA** - `./AI_CONTEXT.md`
+- **Decisiones** - `./DECISIONS.md`
+- **Prompt de onboarding IA** - `./AI_ONBOARDING_PROMPT.md`
+- **Workflow** - `./WORKFLOW.md`
+- **Comandos** - `./COMMANDS.md`
+- **Matriz de soporte** - `./SUPPORT_MATRIX.md`
+- **Troubleshooting** - `./TROUBLESHOOTING.md`
+
+## Configuracion de IA
+
+- **Principios** - `./ai/PRINCIPLES.md`
+- **Reglas** - `./ai/RULES.yaml`
+- **Lecciones** - `./ai/LESSONS.md`
+
+## Mapa del proyecto
+
+`docs/PROJECT_MAP.md` se crea con:
+
+```bash
+npx create-quiver analyze
+```
+
+Usalo despues del analisis para stack, package manager, comandos y pistas de archivos.
+
+## Docs opcionales y perfiles
+
+- `npx create-quiver init --full` agrega notas multi-agente, ejemplos y assets iniciales de spec.
+- Los specs y slices reales se crean despues de aprobar criterios y plan tecnico con `npx create-quiver spec create`.
+- Los wrappers Bash heredados solo se agregan con `--full` o `--legacy-scripts`.

package/docs/STATUS.md.es.template

@@ -0,0 +1,28 @@
+# Estado de {{PROJECT_NAME}}
+
+Este archivo registra progreso, bloqueos y slice actual. Stack y comandos viven en `docs/PROJECT_MAP.md`.
+
+## Estado general
+
+- Progreso: {{X}}% completo
+- Fase actual: {{FASE}}
+- Proximo hito: [Descripcion]
+
+## Resumen de slices
+
+Todavia no hay slices de implementacion. Crea specs y slices solo despues de aprobar criterios de aceptacion y plan tecnico.
+
+| Slice | Titulo | Estado | Progreso | Spec |
+|---|---|---|---|---|
+| slice-00 | Fundacion documental | Pendiente | 0% | `specs/<spec>/slices/slice-00-.../slice.json` |
+
+## Bloqueos
+
+| Bloqueo | Impacto | Mitigacion |
+|---|---|---|
+| - | - | - |
+
+## Notas
+
+- Actualiza este archivo al cerrar cada slice.
+- Registra incertidumbre con `TODO`, `Assumption` o `Pending confirmation`.

package/docs/SUPPORT_MATRIX.md.es.template

@@ -0,0 +1,22 @@
+# Matriz de soporte
+
+**Proyecto:** {{PROJECT_NAME}}
+**Ultima actualizacion:** {{FECHA}}
+
+## Entornos soportados
+
+| Area | Soportado | Notas |
+|---|---|---|
+| Sistemas operativos | macOS, Linux y Windows | Runtime principal: Node CLI y scripts `quiver:*`. |
+| Shells | Terminal, shells compatibles con bash, PowerShell y CMD | Bash es compatibilidad heredada, no dependencia obligatoria. |
+| Git | Git 2.40+ | Debe soportar worktrees y refs estandar. |
+| Node.js | Node 22.x LTS | Requerido en todos los OS soportados. |
+| Branch base | `develop` o `main` | Preferir branch local; `origin` es opcional. |
+| Estado del worktree | Limpio | La ejecucion de slices espera no mezclar cambios. |
+
+## Reglas cross-platform
+
+- Usar APIs Node para paths y filesystem.
+- Mantener `--json` como contrato primario de automatizacion.
+- Respetar `NO_COLOR`, CI y terminales sin TTY.
+- No concatenar prompts largos en comandos shell.

package/docs/TESTING_GUIDE_FOR_AI.md.es.template

@@ -0,0 +1,19 @@
+# Guia de testing para IA
+
+**Proyecto:** {{PROJECT_NAME}}
+**Ultima actualizacion:** {{FECHA}}
+
+## Reglas
+
+- Ejecuta primero tests focalizados del slice.
+- Ejecuta validacion amplia solo cuando el cambio toque superficie compartida.
+- No inventes comandos; usa los documentados en `docs/PROJECT_MAP.md` o `package.json`.
+- Registra evidencia en el spec o slice correspondiente.
+
+## Comandos sugeridos
+
+```bash
+npm test
+npx create-quiver spec validate specs/<spec> --strict
+git diff --check
+```

package/docs/TROUBLESHOOTING.md.es.template

@@ -0,0 +1,35 @@
+# Troubleshooting
+
+**Proyecto:** {{PROJECT_NAME}}
+**Ultima actualizacion:** {{FECHA}}
+
+Usa esta guia cuando falle bootstrap, validacion o ejecucion de Quiver.
+
+## Quiver no aparece en node_modules
+
+### Sintoma
+
+- `npx --yes create-quiver@latest ...` funciona.
+- `node_modules/create-quiver` no existe.
+- `package.json` no declara `create-quiver`.
+
+### Recuperacion
+
+1. Esto es esperado cuando se usa `npx`.
+2. Usa `npx --yes create-quiver@latest` para ejecutar la version publicada mas reciente.
+3. Instala localmente solo si el equipo quiere un workflow pineado:
+
+```bash
+npm install --save-dev create-quiver
+```
+
+## Falta branch base
+
+### Sintoma
+
+- `start-slice` no encuentra `develop` o `main`.
+
+### Recuperacion
+
+1. Crea o fetchea la branch base.
+2. Vuelve a ejecutar la validacion del slice.

package/docs/WORKFLOW.md.es.template

@@ -0,0 +1,29 @@
+# Workflow
+
+**Fecha:** {{FECHA}}
+
+Este documento define el workflow canonico de implementacion del proyecto.
+
+## Reglas centrales
+
+- No implementar sin slice.
+- Un slice equivale a un commit.
+- Un spec equivale a un PR.
+- El spec define el plan; el slice define la ejecucion.
+- Ningun slice debe ejecutarse hasta estar listo.
+- La salida JSON y los artefactos machine-readable no se traducen.
+
+## Planificacion
+
+1. Ejecuta `npx create-quiver flow` si no sabes el siguiente paso seguro.
+2. Redacta criterios de aceptacion.
+3. Redacta y revisa el plan tecnico.
+4. Crea el spec con `npx create-quiver spec create`.
+5. Ejecuta slices de a uno, manteniendo scope y evidencia.
+
+## Validacion
+
+```bash
+npx create-quiver spec validate specs/<spec> --strict
+git diff --check
+```

package/docs/ai/LESSONS.md.es.template

@@ -0,0 +1,24 @@
+# Lecciones aprendidas
+
+**Ultima actualizacion:** {{FECHA}}
+
+## [Titulo de la leccion]
+
+### Contexto
+
+[Que paso]
+
+### Que funciono
+
+- [Item 1]
+- [Item 2]
+
+### Que no funciono
+
+- [Item 1]
+- [Item 2]
+
+### Proxima vez
+
+- [Regla 1]
+- [Regla 2]

package/docs/getting-started/installation.md

@@ -71,10 +71,29 @@ Qué cambia:
 |---|---|
 | Probar Quiver rápidamente | `npx --yes create-quiver@latest` |
 | Inicializar un proyecto nuevo | `npx --yes create-quiver@latest init --name "Mi Proyecto"` |
+| Inicializar docs en espanol | `npx --yes create-quiver@latest --lang es init --name "Mi Proyecto"` |
 | Usar siempre la última versión publicada | `npx --yes create-quiver@latest` |
 | Fijar una versión para el equipo | `npm install --save-dev create-quiver` |
 | Evitar dependencia local de workflow | Usar `npx` |
 
+## Idioma del proyecto
+
+Quiver puede generar documentacion humana inicial en `en` o `es`.
+
+Para una ejecucion puntual:
+
+```bash
+npx --yes create-quiver@latest --lang es init --name "Mi Proyecto"
+```
+
+Para guardar el idioma del proyecto y no repetir flags:
+
+```bash
+npx --yes create-quiver@latest config language set es
+```
+
+El idioma configurado afecta la salida humana y los docs humanos generados. No traduce JSON, JSONL, `package.json`, `slice.json`, comandos, flags, rutas, providers, modelos ni otros artefactos machine-readable.
+
 ## Qué no hace Quiver
 
 Quiver no se instala globalmente por defecto, no modifica credenciales de npm y no agrega una dependencia runtime a tu app salvo que lo pidas explícitamente con npm.

package/docs/reference/commands.md

@@ -29,8 +29,12 @@ Más detalle: [Instalación y uso con npx](../getting-started/installation.md).
 | `npx --yes create-quiver@latest version` | Muestra un reporte de versión con banner Quiver, runtime, package manager y proyecto detectado. |
 | `npx --yes create-quiver@latest version --json` | Emite el reporte de versión como JSON parseable para automatización. |
 | `npx --yes create-quiver@latest --help` | Muestra los comandos soportados. |
+| `npx --yes create-quiver@latest config language show` | Muestra el idioma efectivo y su fuente de configuración. |
+| `npx --yes create-quiver@latest config language show --json` | Emite el idioma efectivo como JSON estable. |
+| `npx --yes create-quiver@latest config language set es` | Guarda `es` como idioma del proyecto en `.quiver/config.json`. |
+| `npx --yes create-quiver@latest config language set en --global` | Guarda `en` como idioma global en `~/.quiver/config.json`. |
 | `npx --yes create-quiver@latest init --name "Proyecto"` | Inicializa Quiver en un proyecto. |
-| `npx --yes create-quiver@latest init --interactive` | Abre una guía interactiva para elegir modo de proyecto, metodología `wdd-sdd`, perfil inicial y próximos pasos de agentes. |
+| `npx --yes create-quiver@latest init --interactive` | Abre una guía interactiva para elegir idioma del proyecto, modo de proyecto, metodología `wdd-sdd`, perfil inicial y próximos pasos de agentes. |
 | `npx --yes create-quiver@latest migrate --dry-run` | Previsualiza migración de un proyecto Quiver anterior. |
 | `npx --yes create-quiver@latest migrate` | Aplica la migración. |
 | `npx --yes create-quiver@latest analyze` | Genera mapa del proyecto y datos de escaneo. |
@@ -42,6 +46,54 @@ Más detalle: [Instalación y uso con npx](../getting-started/installation.md).
 | `npx --yes create-quiver@latest dashboard --section <name>` | Muestra una sección humana puntual como `specs`, `slices`, `blockers`, `warnings`, `agents`, `approvals`, `runs`, `active-slice` o `next-steps`. |
 | `npx --yes create-quiver@latest dashboard --limit <n>` | Ajusta el límite de listas del dashboard compacto entre 1 y 100. |
 
+## Idioma del CLI
+
+Quiver resuelve el idioma de salida humana en este orden:
+
+1. `--lang en|es`
+2. variable de entorno `QUIVER_LANG`
+3. `.quiver/config.json`
+4. `~/.quiver/config.json`
+5. locale del entorno
+6. `en`
+
+Ejemplos:
+
+```bash
+npx --yes create-quiver@latest --lang es dashboard
+QUIVER_LANG=es npx --yes create-quiver@latest flow
+npx --yes create-quiver@latest config language set es
+npx --yes create-quiver@latest config language set en --global
+```
+
+`--json` conserva claves y estructura machine-readable en ingles tecnico; no traduce campos, codigos, comandos, flags, rutas, ids, providers ni modelos.
+
+## Nota de release i18n
+
+La superficie documentada del CLI soporta salida humana en `en` y `es` para comandos de inicializacion, configuracion, lectura de estado, dashboard, workflow de specs/slices, comandos IA, gates y PR. El idioma configurado al ejecutar `config language set es|en` se reutiliza en ejecuciones posteriores sin repetir flags; `--lang` y `QUIVER_LANG` siguen disponibles como overrides puntuales.
+
+La garantia de compatibilidad aplica a la salida humana. JSON/JSONL, nombres de campos, codigos, comandos, flags, rutas, ids, providers, modelos y snippets copiables se mantienen estables para automatizacion.
+
+## Idioma de docs generados
+
+El idioma configurado tambien aplica a documentacion humana generada por Quiver, como los docs creados por `init`.
+
+Ejemplos:
+
+```bash
+npx --yes create-quiver@latest --lang es init --name "Proyecto"
+npx --yes create-quiver@latest config language set es
+npx --yes create-quiver@latest init --name "Proyecto"
+```
+
+Reglas:
+
+- `--lang en|es` puede usarse como override para una ejecucion.
+- `.quiver/config.json` se usa como idioma por defecto del proyecto cuando no se pasa `--lang`.
+- Templates humanos Markdown pueden tener variantes localizadas, por ejemplo `docs/INDEX.md.es.template`.
+- Si falta una variante localizada, Quiver hace fallback explicito al template base en `en`.
+- Artefactos machine-readable como `package.template.json`, `slice.json`, JSON/JSONL, ids, comandos, flags, rutas, providers y modelos no se traducen.
+
 ## Planificación con IA
 
 | Comando | Para qué sirve |
@@ -116,6 +168,8 @@ Más detalle: [Instalación y uso con npx](../getting-started/installation.md).
 | `--methodology wdd-sdd` | Declara la metodología soportada por comandos interactivos o automatizados. |
 | `--no-color` | Desactiva colores ANSI en salida humana. |
 | `--json` | Emite salida machine-readable en comandos que lo soportan, incluyendo `dashboard` y `version`. |
+| `--lang en\|es` | Sobrescribe el idioma efectivo de la salida humana para una ejecución. |
+| `--global` | En `config language set`, escribe la configuración global de usuario en `~/.quiver/config.json`. |
 | `--details` | Expande el dashboard humano completo; no combina con `--json` ni `--section`. |
 | `--section <name>` | Muestra una sección humana del dashboard; no combina con `--json` ni `--details`. |
 | `--limit <n>` | Limita listas del dashboard compacto entre 1 y 100; no combina con `--json`. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-quiver",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "private": false,
   "description": "Quiver CLI for scaffolding projects from the packaged template",
   "license": "MIT",