diff --git a/CLAUDE.md b/CLAUDE.md index d4ed0751..e08f4937 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -41,3 +41,17 @@ Un directorio **vacío** en el store no es un artefacto: es un nombre. `Store::h `respaldo-storagebox.sh --listar` los separa a `work/respaldo-vacios.txt`, pero la regla general sigue valiendo para cualquier código nuevo — **un ausente falla ruidosamente; un vacío llega hasta el final diciendo que todo fue bien**. + +## 4. La superficie de la CLI va en INGLÉS; los mensajes, en castellano + +Subcomandos, flags y nombres de opciones: **inglés**, sin excepción (`build`, `hash`, `hydrate`, +`mirror push`, `kernel closure`, `qorpa pull`). Lo que el usuario LEE —ayuda, errores, logs— va en +castellano, y los nombres propios del proyecto son quechua (`qorpa`, `harkaq`, `yupana`, `arje`). + +**Por qué.** Un verbo de CLI es contrato: entra en scripts, cron y runbooks, y renombrarlo después +rompe llamadores que nadie recuerda. Media superficie en cada idioma obliga a adivinar en cada +comando nuevo, y ya pasó: el ADR 0015 nació con `traer/crear/correr` y hubo que corregirlo. + +⚠ **Deuda conocida, NO barrida todavía:** varios scripts de `scripts/` exponen flags en castellano +(`--crear`, `--traer`, `--listar`, `--sha`). El barrido es su propia unidad de trabajo — tocarlos de +paso rompe cron y la granja. Código NUEVO nace en inglés desde hoy.