Contenido detallado
🚧 Dónde estamos en el loop
Ya completaste la Identidad (Módulo 4.2) y el Sustrato (Módulo 4.3). Al escribir /os-coach next, el coach lee tu memory.md, ve que la siguiente capa sin completar es la número 3 — Reglas y Ganchos, y empieza a acompañarte como coach. El loop siempre es el mismo: hace 2-3 preguntas, espera, crea los archivos reales, anota dónde te quedaste y señala el siguiente paso.
🌱 ¿Nuevo aquí?
Capa es cada una de las 6 partes de un OS (Identidad, Sustrato, Reglas, Habilidades, Herramientas, Agentes). Guardrail (en PT: cerca) es una protección que impide que el sistema haga algo indebido. memory.md es el archivo donde el coach guarda dónde estás, para retomar desde el mismo punto en cualquier sesión.
🚧 Qué es
La capa de Reglas y ganchos son las barreras de tu OS: las líneas que él nunca puede cruzarse, algunos reflejos automáticos más que aplican estas pautas sin que nadie tenga que recordarlas.
- •Viene después de Identidad y Sustrato: solo proteges lo que ya existe.
- •Vive en la carpeta rules/, en dos archivos: always.md e never.md.
Cómo leer: las dos capas de abajo ya están hechas. siguiente te lleva a la capa 3 y ejecuta el mismo ciclo de siempre: preguntar, construir, persistir, seguir.
Por qué aprender
Porque el orden importa. Las reglas sin substrato protegen el vacío; las reglas anteriores a la identidad no saben qué están defendiendo. Al llegar aquí en el orden correcto, cada barrera que levantas protege algo que ya tiene valor — y el coach ya conoce tu objetivo, así que las preguntas son breves.
Conceptos clave
🪧 Regla vs. Gancho: la señal y la puerta cerrada
El coach distingue dos cosas que parecen iguales, pero tienen distinto peso. La analogía que usa: una regla es un letrero que dice «no entres»; un gancho es una puerta cerrada con llave que físicamente no se abre. La señal es una sugerencia fuerte: el modelo casi siempre obedece, pero puede juzgar. La puerta cerrada es determinista: no hay "casi".
🌱 ¿Nuevo aquí?
Gancho (en inglés hook) es un pequeño fragmento de automatización que el harness activa por tu cuenta en cierto momento (p. ej.: cada vez que vas a guardar algo). Determinista significa "ocurre siempre igual, sin depender del sentido común". El harness es el programa de terminal (Claude Code, Codex) que le da manos a la IA.
Cómo leer: empieza por las reglas (texto que escribes hoy). El gancho es la versión de «puerta cerrada» de una regla crítica: el coach identifica ¿qué regla merece convertirse en reflejo y anótala para que tú (o un técnico) la conecten después.
✓ Buena regla
- ✓Concreta y comprobable: puedes decir «se violó» o «no se violó».
- ✓Vinculada a tu objetivo, no genérica.
- ✓Breve: una línea por regla.
✗ Regla débil
- ✗Vago: «ten cuidado», «usa el sentido común».
- ✗Genérica: serviría para cualquier OS.
- ✗Tan larga que nadie puede revisarla.
Por qué aprender
Porque saber la diferencia evita dos errores: confiar en un letrero para cosas que requieren una puerta cerrada con llave (p. ej., filtrar datos privados) y gastar energía construyendo automatización para cosas que se resuelven con una simple línea de texto. La regla es sencilla; el hook es potente. Usa cada uno donde corresponde.
Conceptos clave
❓ Las 2-3 preguntas que hace el coach
Como en toda capa, el coach hace como máximo 2-3 preguntas en lenguaje sencillo y entonces espera tu respuesta. No vuelca las seis capas de una vez ni te entrega un formulario. Para la capa de Reglas, las preguntas del playbook son estas:
¿Cuál es el peor error?
"¿Cuál es el peor error que podría cometer este OS?" — esa respuesta se convierte en una regla de nunca.
¿Algo automático?
"¿Hay algo que debería ocurrir automáticamente cada vez?" (un recordatorio, una verificación, una copia de seguridad): eso es candidato a gancho.
¿Dato privado?
"¿Hay algún dato privado que nunca pueda salir de esta carpeta ni compartirse?" — se convierte en una regla de "nunca publicar/compartir".
💡 La idea clave
No necesitas pensar en "todas las reglas posibles". Piensa solo en la única cosa que más te dolería si ocurriera. Una never-rule bien definida vale más que diez reglas tibias, y el coach reutiliza el objetivo de memory.md, así que no repite lo que ya contaste.
Por qué aprender
Porque te saca del bloqueo inicial. "¿Qué reglas pongo?" paraliza; "¿cuál es el peor error posible?" es fácil de responder. Las tres preguntas convierten un miedo difuso en tres artefactos concretos, y avanzas de a un paso por vez.
Conceptos clave
⛔ El peor error → regla never concreta
Tu respuesta al «peor error» no queda vaga: el coach la escribe como una regla de nunca clara y comprobable en rules/never.md. El error común que evita es la regla vaga. Compara: "sé cuidadoso con los clientes" no se puede verificar; "nunca mezcles los números de dos clientes diferentes" sí — o se mezcló, o no.
Recreación ilustrativa — rules/never.md
# Never # O que este OS nunca pode fazer. - Nunca envio mensagem a um cliente sem você ler e aprovar antes. - Nunca deixo um prazo passar em silêncio: se algo está em risco, eu aviso alto. - Nunca misturo os números de dois clientes diferentes.
✓ Concreta (verificable)
- ✓"Nunca mezclo los números de dos clientes."
- ✓"Nunca envío nada sin tu aprobación."
- ✓"Nunca convierto valores sin indicar la moneda."
✗ Vago (no verificable)
- ✗"Sé cuidadoso."
- ✗"Evita confusiones."
- ✗"Usa el sentido común con los datos."
Por qué aprender
Porque una regla solo protege si se puede verificar. La versión comprobable también es la que la auditoría (Módulo 4.6) puede puntuar: se convierte en el criterio para saber si "esta capa es sólida". Lo vago no puntúa; lo concreto, sí.
Conceptos clave
♻️ El reflejo automático (el gancho que debes anotar)
El done-check de esta capa requiere al menos un reflejo automático identificado. Si nombraste un comportamiento que debería ocurrir siempre, el coach lo anota como un gancho para conectar después y describe lo que guardaría — sin fingir que ya está implementado. No necesitas programar nada ahora: basta con decir qué reflejo importa.
🔁 Reflejos típicos según el objetivo
- Nunca incumplir un plazo — avisar automáticamente cuando falten 3 días para una fecha contractual.
- Dato sensible — verificar y bloquear la información privada antes de cualquier envío al exterior (un protección de PII).
- Trabajo que se entrega — exigir tu aprobación antes de que algo llegue a un cliente.
Recreación ilustrativa — anotación del gancho en memory.md
## Open questions
- Gancho a ligar: avisar 3 dias antes de cada data contratada
(hoje é uma regra em always.md; vira reflexo determinístico depois).
🌱 ¿Nuevo aquí?
PII es "Personally Identifiable Information": información que identifica a una persona (nombre, correo electrónico, CPF, teléfono). Un protección de PII es un reflejo que revisa lo que va a salir y barra si encuentra este tipo de dato. Es el ejemplo clásico de una regla que merece convertirse en un gancho, porque una filtración no se puede deshacer.
Por qué aprender
Porque un reflejo no depende de la memoria humana. Una regla que tienes que "recordar seguir" falla el peor día; un hook que se activa solo, no. Identificar el reflejo ahora deja el camino listo para blindar la parte más crítica de tu OS cuando tú (o un técnico) actives la automatización.
Conceptos clave
🔒 La regla de los datos privados
Si marcaste algún dato como privado, el coach agrega una regla de "nunca hagas commit ni compartas" y mantiene la regla de oro de la skill: un valor sensible nunca se escribe literalmente dentro de la carpeta. En su lugar va un handle no identificador (iniciales, "Cliente A", un código corto). Y nunca escribe una nota que diga "este campo está excluido" para luego enumerar el campo: esa contradicción, por sí misma, es una filtración.
⚠️ Por qué esto es una «puerta cerrada», no un «cartel»
Una filtración de datos personales es irreversible — no se puede «despublicar» lo que ya salió. Por eso la regla de datos privados es la primera candidata a convertirse en un gancho (PII guard), y por eso, en una auditoría, una filtración limita esa capa y se convierte en el primer punto que hay que corregir.
Recreación ilustrativa — rules/always.md (fragmento)
# Always
- Sempre uso um handle ("Cliente A") no lugar do nome real do cliente.
- Sempre mantenho o mapa nome-real fora desta pasta.
- Sempre trato esta pasta como se ela pudesse ir parar num backup público.
Por qué aprender
Porque es lo que hace que tu OS sea seguro de cultivar. Querrás versionar la carpeta, hacer respaldos y quizá sincronizarla entre máquinas. Sin la regla de datos privados, cualquiera de esas acciones puede exponer lo que debería quedarse solo contigo. La barrera aquí no es burocracia: es lo que te permite dormir tranquilo mientras usas el sistema a diario.
Conceptos clave
✅ Done-check + copy-run
La capa de Reglas está sólida cuando: (1) la respuesta al peor error está escrita como una never-rule clara y comprobable; y (2) se identificó al menos un reflejo automático. Si falta una de estas, el coach marca la capa como in progress y dice exactamente qué falta — no infla un "ok" falso.
Checklist de la capa Reglas
- ✓rules/never.md tiene el peor error como una regla concreta de tipo never.
- ✓rules/always.md tiene las restricciones del día a día (p. ej., aprobación, manejo de datos privados).
- ✓Se identifica y anota al menos un reflejo (gancho).
- ✓No se escribió ningún valor sensible literalmente en la carpeta.
Objetivo: abrir la capa de Reglas y dejar que el coach construya los dos archivos a partir de tus respuestas.
1) Pégalo en Claude Code (dentro de la carpeta de tu OS):
/os-coach next
2) Hace 2-3 preguntas. Responde en texto libre (cámbialas por las tuyas):
Pior erro: <ex.: enviar algo errado a um cliente sem eu ver> Algo automático: <ex.: me avisar 3 dias antes de cada prazo> Dado privado: <ex.: nomes dos clientes, nunca compartilhar>
3) El coach crea en tu carpeta:
rules/ ├── always.md # o que ele sempre faz └── never.md # os hard stops (pior erro)
Cómo verificar: abre rules/never.md y verifica si el peor error se convirtió en una línea que se pueda responder con «¿se violó o no?». Ejecuta /os-coach status y confirma que Rules aparece como sólido (o in progress con lo que falta).
Por qué aprender
Porque el done-check es lo que separa "hay un archivo" de "hay un límite real". Ejecutar el copy-run y revisar el resultado es el hábito que repites en cada capa, y es exactamente lo que evaluará después la auditoría del Módulo 4.6. Con la capa lista, el coach te lleva a la siguiente: Habilidades.
Conceptos clave
✅ Resumen del módulo
Siguiente módulo:
4.5 — Habilidades → Herramientas → Agentes 🧩