diff --git a/AGENTS.md b/AGENTS.md
index 40bd1bd..77b6419 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -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.
 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).
+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)
 
diff --git a/README.md b/README.md
index 123018f..8fab930 100644
--- a/README.md
+++ b/README.md
@@ -86,7 +86,8 @@ kappa-hub/
 1. **No hardcodear texto** — usar `t('clave')` de vue-i18n
 2. **KAPPA retorna tipos mixtos** — usar `String()` siempre
 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