sergio/takana

La regla existía —kernel_cmd.rs la cita como «Regla 7.bis»— pero no estaba
escrita en ningún sitio que un agente lea, así que nadie la respetó: el ADR
0015 nació proponiendo traer/crear/correr. Queda en CLAUDE.md, que es lo que
se carga en cada sesión.

Con la deuda declarada en vez de tapada: varios scripts/ exponen flags en
castellano y el barrido es su propia unidad de trabajo, porque tocarlos de
paso rompe cron y la granja. Código nuevo nace en inglés desde hoy.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U5cQtQrYNjWJVXVE6aEpQ2

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.