regla 4: la superficie de la CLI va en inglés, los mensajes en castellano
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
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user