ricardo/Alpha
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

agregar regla de observabilidad: loguear [Alpha] + accion + datos + errores en toda funcion

Browse Source
This commit is contained in:
Ricardo Gonzalez
2026-05-27 20:42:55 -05:00
parent 98d6d608a6
commit 1e3ed6ac02
2 changed files with 3 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+1
View File
@@ -24,6 +24,7 @@
2. **KAPPA retorna tipos mixtos**: strings, números y booleanos para el mismo campo (ej: `status` puede ser `"active"`, `true`, o `3`). Siempre usar `String(valor)` o `safeStr()` antes de operar. 2. **KAPPA retorna tipos mixtos**: strings, números y booleanos para el mismo campo (ej: `status` puede ser `"active"`, `true`, o `3`). Siempre usar `String(valor)` o `safeStr()` antes de operar.
3. **No usar `.catch(() => {})`** sin loguear el error. Siempre `console.error()`. 3. **No usar `.catch(() => {})`** sin loguear el error. Siempre `console.error()`.
4. **Los nombres de funciones y archivos van en español** cuando son semánticos del dominio (ej: `syncHUsToTurso` → OK, pero labels visibles van en i18n). 4. **Los nombres de funciones y archivos van en español** cuando son semánticos del dominio (ej: `syncHUsToTurso` → OK, pero labels visibles van en i18n).
5. **Toda función debe tener observabilidad**: loguear entrada con `[Alpha]` + acción + datos clave, loguear errores con `[Alpha]` + descripción + error completo. Sin logs no se puede diagnosticar.
## Sincronización entre máquinas (Mac Mini ↔ MacBook Air) ## Sincronización entre máquinas (Mac Mini ↔ MacBook Air)
README.md
+2 -1
View File
@@ -86,7 +86,8 @@ kappa-hub/
1. **No hardcodear texto** — usar `t('clave')` de vue-i18n 1. **No hardcodear texto** — usar `t('clave')` de vue-i18n
2. **KAPPA retorna tipos mixtos** — usar `String()` siempre 2. **KAPPA retorna tipos mixtos** — usar `String()` siempre
3. **No silenciar errores** — siempre `console.error()` 3. **No silenciar errores** — siempre `console.error()`
4. **Build verde siempre** — `bun run build` + `cargo build` sin errores 4. **Observabilidad obligatoria** — toda función debe loguear `[Alpha]` + acción + datos clave + errores completos
5. **Build verde siempre** — `bun run build` + `cargo build` sin errores
## Documentos clave ## Documentos clave