es localization

Flujo de localización

Objetivo

Definir un pipeline repetible para localización de documentación (README y wiki) en ClawSec.

Alcance

• Idioma fuente: inglés (README.md, wiki/*.md)
• Idioma traducido actual: español (README.es.md, wiki/es/*.md)
• Idiomas futuros: wiki/<lang>/... y README.<lang>.md

Reglas de fuente de verdad

1. Los archivos en inglés son canónicos.
2. Las traducciones deben preservar exactamente comandos, rutas, bloques de código e identificadores.
3. Nombres de producto y skills no se traducen (ClawSec, OpenClaw, NanoClaw, Hermes, Picoclaw).
4. Si la cobertura de traducción es parcial, el archivo traducido debe declararlo.

Convenciones de carpetas

• Traducciones README:
• README.es.md
  • Futuro: README.fr.md, README.de.md, README.ja.md
• Traducciones wiki:
• wiki/es/INDEX.md
• wiki/es/<page>.md
• Assets de localización:
• wiki/i18n/terminology-en-es.md
• wiki/i18n/translation-tracker.md

Flujo de actualización

1. Normalizar docs fuente en inglés.
2. Registrar cambios en wiki/i18n/translation-tracker.md.
3. Traducir páginas modificadas preservando estructura Markdown.
4. Ejecutar QA (enlaces, comandos, terminología).
5. Ejecutar npm run gen:wiki-llms.
6. Abrir PR con páginas traducidas y gaps pendientes.

Checklist QA

• Jerarquía de títulos preservada.
• Snippets de comandos sin cambios.
• Rutas y URLs sin cambios.
• Nombres de skills/plataformas sin cambios.
• Terminología de seguridad consistente.
• Enlaces de traducción visibles desde índices.