Contenido detallado
🚀 El comando iniciar
Ejecutas /os-coach start <tu objetivo> dentro de una carpeta, y allí nace un OS. El texto después de iniciar es tu objetivo, con tus propias palabras — no es un título técnico, sino la frase honesta de lo que quieres resolver. La carpeta donde ejecutas se convierte el OS.
Cómo leer: el objetivo entra, el coach hace pocas preguntas y, al final, escribe dos archivos reales: el memory.md (tu lugar) y el CLAUDE.md (la Identidad). Un comando inicia toda la primera capa.
Por qué aprender
Porque el objetivo es el ancla de todo. Cada capa futura —sustrato, reglas, skills— se evaluará en función de esta frase. Un objetivo claro y honesto ahora evita un OS genérico después. Por eso el coach registra tus palabras exactas, sin traducirlo a "tecnicismos".
Conceptos clave
❓ Las 2-3 preguntas
Después del objetivo, el coach hace como máximo tres preguntas cortas — y detente y espera. Respondes en el siguiente turno y solo entonces lo construye. Es el «un paso a la vez» en acción.
¿Para quién es este OS?
¿Solo tú, tu equipo o tus clientes? Define el tono y a quién responde el sistema.
¿Qué te gustaría simplemente pedirle?
La pregunta de tus sueños. Ej.: "¿qué vence en los próximos 10 días y qué ya está atrasado?".
¿Una cosa que siempre debe hacer y otra que nunca debe hacer?
Los dos primeros valores predeterminados y la primera negativa firme de tu OS.
🔎 ¿Por qué tan pocas preguntas?
Porque tres respuestas breves ya contienen casi toda la Identidad: quién eres, a quién sirves, qué haces y qué rechazas. El coach es conciso a propósito: prefiere construir pronto y ajustar después antes que interrogarte durante diez minutos.
Por qué aprender
Porque saber las preguntas de antemano te permite responder bien. La de "siempre/nunca" es la más valiosa: la parte de "nunca" se convierte en un rechazo firme en el CLAUDE.md, la primera barrera de tu OS. Piénsala con calma.
Conceptos clave
♻️ Reutilizar respuestas
Este es un detalle sutil pero importante: el coach nunca pregunta dos veces. Antes de preguntar cualquier cosa, comprueba lo que ya dijiste: en el objetivo, en el memory.md y en las respuestas anteriores, y las reutiliza. Jamás pregunta "¿para quién es?" si ya se lo dijiste.
💡 Objetivo + start ya cubren casi toda la Identidad
Por eso, al iniciar la capa de Identidad, el coach no vuelve a preguntar objetivo ni para quién: eso ya lo tiene. Por lo general, solo queda la pregunta del «siempre/nunca». Sientes que el inicio fue rápido precisamente porque aprovecha todo.
✓ El coach reutiliza
- ✓El objetivo que diste en el iniciar.
- ✓El «para quién» y la pregunta de los sueños.
- ✓Decisiones ya registradas en el memory.md.
✗ El coach evita
- ✗Repetir una pregunta que ya respondiste.
- ✗Responder por ti («voy a suponer que…») sin necesidad.
- ✗Volcar todas las preguntas de todas las capas a la vez.
Por qué aprender
Porque muestra la economía del método: cada respuesta tuya es un recurso reutilizable, no algo que se pierde. También te indica qué esperar: si el coach repite una pregunta, algo se salió del camino (quizá el memory.md no se leyó).
Conceptos clave
🪪 O CLAUDE.md generado
Con las respuestas en mano, el coach escribe el CLAUDE.md: un archivo corto (apunta a menos de 30 líneas) con quién es el OS, a quién sirve, el objetivo, dos o tres defaults de comportamiento y dos o tres rechazos rotundos. Todo con tu voz, basado en tus respuestas.
🌱 ¿Nuevo aquí?
O CLAUDE.md es un archivo de texto común (formato Markdown, solo texto con algunos símbolos). El harness lo lee primero, antes que nada; por eso es "el alma". Un default es un comportamiento predeterminado («avísame siempre con 3 días de anticipación»); una rechazo rotundo es un «nunca» innegociable.
Recreación ilustrativa — el CLAUDE.md de un fotógrafo (objetivo: no volver a perder un plazo)
# Quem eu sou Sou o sistema operacional de um fotógrafo de casamentos solo. Existo para que nenhuma entrega a cliente atrase. ## A quem sirvo Só a mim (operação de uma pessoa). ## Sempre (defaults) - Avisar com 3 dias de antecedência de qualquer data contratada. ## Recusas duras (never) - Nunca mandar mensagem a um cliente sem você ler e aprovar antes. - Nunca deixar um prazo passar em silêncio.
Breve, específico, con la voz del dueño. Fíjate: ningún guion largo, ningún nombre real de cliente.
✓ Identidad acotada
- ✓Menos de 30 líneas, recortado hasta que duela.
- ✓Rechazos concretos, no «ten cuidado».
- ✓Con tu voz, sobre tu objetivo.
✗ Identidad inflada
- ✗Páginas de texto genérico de «buenas prácticas».
- ✗Rechazos vagos que no se pueden probar.
- ✗Copiada de otro dominio, sin tu objetivo.
Por qué aprender
Porque el CLAUDE.md es el archivo que el OS lee antes que cualquier otro: marca el tono de todo. Un archivo-alma inflado confunde al sistema. El error común aquí es dejarlo largo y genérico: recorta hasta que duela.
Conceptos clave
🔒 Protección de datos sensibles
Si en alguna respuesta marcas un campo como privado —un nombre, un correo electrónico, un valor—, el coach nunca guarda este valor real en ningún archivo de la carpeta. En su lugar, usa un identificador estable que no permite identificar a nadie: "Cliente A", iniciales, un código corto.
🌱 ¿Nuevo aquí?
Un handle (identificador) es un apodo que representa un dato sin revelarlo. En vez de escribir "Maria e João Silva", el sistema operativo escribe "Pareja A". Tú sabes quién es; el archivo, no. Así, aunque la carpeta se filtre, no se filtra ningún dato personal.
⚠️ La contradicción prohibida
El coach nunca escribe un archivo que diga «este campo fue excluido» y justo debajo enumere el campo. Esa contradicción es, por sí sola, una filtración. Si un identificador hiciera que el OS te resultara inutilizable, pregunta antes de registrar el valor real, en vez de decidirlo por sí solo.
Por qué aprender
Porque la protección empieza en la primera capa y se aplica a todo el OS. Marcar lo que es sensible desde el iniciar garantiza que, desde las skills hasta las auditorías, ningún archivo que se pueda guardar (como el OS-AUDIT.md) carga un dato real. No necesitas vigilarlo; la regla de oro n.º 8 se encarga.
Conceptos clave
✅ Done-check: la prueba de lo extraño
¿Cómo saber si la Identidad está lista? Con el prueba de la persona ajena: alguien que nunca ha visto tu proyecto lee el CLAUDE.md y puedes describir correctamente para qué sirve el OS y una cosa que se niega a hacer. Si pasa la prueba, la capa se convierte en sólido.
✓ Pasa la prueba
- ✓El propósito del OS queda claro en una frase.
- ✓Hay al menos un rechazo concreto y fácil de entender.
- ✓Una persona sin conocimientos técnicos lo entiende sin que tengas que estar a su lado.
✗ Todavía no
- ✗La persona ajena no sabría decir para qué sirve.
- ✗No hay ninguna negativa, o es demasiado vaga.
- ✗Es largo y genérico; confunde más de lo que ayuda.
💡 Consejo práctico
¿No conseguiste a alguien extraño? Vuelve a leer tu CLAUDE.md fingiendo que nunca vio el proyecto. Si te bloqueas con «pero ¿para qué sirve esto?», la capa todavía está in progress — elimina lo genérico y deja que la misión y el rechazo hablen con claridad.
Por qué aprender
Porque te da una señal verde objetiva en lugar de un "creo que está bien". El done-check evita los dos extremos: detenerse demasiado pronto (Identidad vaga) o perfeccionar para siempre. Si pasa la prueba del desconocido, sigue al Sustrato.
Conceptos clave
▶️ Copy-run: ejecuta el iniciar
Hora de construir de verdad. Vas a crear una carpeta nueva para tu primer OS y ejecutar el iniciar con tu objetivo real. Al final, habrá dos archivos en la carpeta: memory.md e CLAUDE.md.
▶ Copy-run · iniciar tu OS
Objetivo: capturar tu objetivo y generar la Identidad. Abre Claude Code dentro de una carpeta nueva (vacía) para ese OS y escribe:
/os-coach start <seu objetivo em uma frase>
Cambia: <tu objetivo en una frase> por lo que quieres resolver, en tus propias palabras. P. ej.: /os-coach start quiero no volver a perder nunca una fecha de entrega para un cliente.
Qué va a pasar: el coach confirma el objetivo y hace 2-3 preguntas. Responde (él espera) y luego escribe los archivos.
Cómo verificar: lista la carpeta y comprueba que existan memory.md e CLAUDE.md. Abre el CLAUDE.md y aplica la prueba de lo extraño: ¿se puede decir cuál es el propósito y una negativa? Si es así, la Identidad está sólido y puedes ir al módulo 4.3.
Consejo: si marcaste algún nombre o valor como sensible, comprueba que el CLAUDE.md usa un handle («Cliente A»), no el dato real.
Por qué aprender
Porque es tu primera capa construida con tus propias manos. A partir de aquí ya no estás leyendo sobre el método: lo estás usando. Y el memory.md lo recién creado es lo que te permitirá continuar en los próximos módulos sin volver a empezar.
Conceptos clave
✅ Resumen del módulo
Siguiente módulo:
4.3 — siguiente: organiza el Sustrato (lo que ocurre entre bastidores) 🗂️