⚙️ Paso a paso con /os-coach
La ruta práctica. Instalas una skill que hace el trabajo técnico por ti y construyes un OS real, una capa a la vez, comando a comando: iniciar → siguiente → audit. Todos los módulos tienen un ejemplo listo para copiar y ejecutar.
Cómo leer: la fila de arriba son los comandos que escribes; justo debajo, en cian, la capa que construye cada uno. Todo fluye hacia el memory.md, que guarda tu lugar. Al final, audit puntúa el OS y vuelve como feedback. Esta ruta recorre ese proceso de principio a fin.
Mapa de la ruta
⚙️ Instalar el OS Coach
Una skill, seis comandos
🎯 start — Identidad
El objetivo se convierte en el alma
🗂️ next — Substrato
Ordena los bastidores
🚧 next — Reglas
Las barreras del OS
🧩 Skills → Tools → Agentes
La capacidad por encima
📊 audit — puntuar
El scorecard frente al objetivo
Contenido detallado
⚙️ Instalar y entender el OS Coach
Copia la skill en una carpeta, conoce los 6 comandos, el memory.md, las 8 reglas de oro, los guards y el loop que lo sostiene todo.
Instalar es copiar la carpeta os-coach para ~/.claude/skills/. Un comando, sin build ni dependencias.
Es el único paso previo. Sin esto, el /os-coach no existe en tu máquina.
cp -r · carpeta de skills · cero dependencias.
Un copiloto que hace el trabajo técnico por ti. Él pregunta, tú decides; él crea los archivos.
No necesitas saber programar; se asume que nunca abriste una terminal.
Lo hace por ti · una capa a la vez · tú decides.
Seis verbos: iniciar (empieza), siguiente (siguiente capa), layer (salta a una), estado (mapa), audit (puntúa), help (explica).
Es todo el teclado que vas a usar en esta ruta. Basta con memorizar estas seis teclas.
iniciar · siguiente · capa · estado · auditoría · ayuda.
Un archivo que guarda el objetivo, la capa actual y las decisiones. Se lee primero y se actualiza al final de cada turno.
Es lo que te permite parar a mitad de camino y volver días después sin perder el hilo.
Estado persistente · retomar después · siempre actualizado.
Habla como una persona, un paso a la vez; quien construye es la skill, nunca genérico, siempre persiste, cierra el turno igual, sin rayas largas, protege lo sensible.
Conocer las reglas te dice qué esperar y cuándo el coach se está desviando del guion.
8 reglas · basadas en la realidad · protege los datos.
Comprobaciones que evitan errores: ejecutar siguiente sin tener iniciar, sobrescribir un OS, inventar una 7.ª capa.
Entender los guards explica por qué el coach a veces se detiene y pregunta en vez de actuar.
Sin memoria → pide start · no sobrescribas · no inventes.
El motor: pregunta, construye, persiste, avanza, audita. Todo leyendo y escribiendo lo mismo memory.md.
Es el ritmo de toda la ruta. Tu primera acción práctica: ejecutar /os-coach help.
Ask · Build · Persist · Next · Audit.
🎯 iniciar — objetivo + Identidad
El primer comando. Dices el objetivo, respondes 2-3 preguntas y el coach escribe el CLAUDE.md — el alma concisa de tu OS.
El comando que crea un OS nuevo en la carpeta actual y captura tu objetivo con tus propias palabras.
Todo lo demás se ancla en ese objetivo: empezar bien evita un OS genérico.
iniciar · objetivo en tus palabras · carpeta = OS.
¿Para quién es el OS, qué te gustaría simplemente pedirle, y una cosa que siempre debe hacer y otra que nunca debe hacer?
Tres respuestas breves ya dan casi toda la Identidad. Es rápido a propósito.
Para quién · qué pedir · siempre / nunca.
El coach revisa lo que ya dijiste y lo reutiliza. Nunca pregunta «¿para quién es?» dos veces.
Muestra que el objetivo + las respuestas del inicio ya cubren casi toda la Identidad.
Reutilización · sin repeticiones · solo la pregunta que falta.
Un archivo breve: quién es el OS, a quién sirve, el objetivo, 2-3 valores predeterminados y 2-3 rechazos firmes.
Es el primer archivo que lee el OS. Cuanto más conciso, mejor: recorta hasta que duela.
< 30 líneas · valores predeterminados · rechazos firmes.
Si marcas un campo como privado, el coach guarda un identificador («Cliente A»), nunca el valor real.
Protege nombres, correos electrónicos y valores desde la primera capa, sin que tengas que estar vigilándolos.
Handle · valor real fuera · sin filtraciones.
Un desconocido lee el CLAUDE.md y describe para qué sirve el OS y una cosa que rechaza.
Es la señal verde de Identidad. Si pasa la prueba, la capa es sólida.
Prueba de lo extraño · sólido · un rechazo claro.
Tu primera construcción real: ejecutar el iniciar con tu objetivo, dentro de una carpeta nueva.
Pasa del concepto a crear los primeros archivos: memory.md + CLAUDE.md.
Manos a la obra · objetivo concreto · verificar los archivos.
🗂️ siguiente — Sustrato
La capa más grande y la que más se omite. El siguiente abre el Substrato: sources.md + compendium.md, la eliminación de identificadores y la verificación de finalización en varias partes.
O siguiente lee el memory.md y abre la siguiente capa no lista. Después de la Identidad, pasa al Sustrato.
Es el comando que más repites. Sigue el orden correcto por ti.
siguiente · orden de construcción · una capa a la vez.
sources.md lista de dónde viene el material; compendium.md es la referencia destilada que realmente lee el OS.
Son los dos archivos canónicos. La auditoría los busca con esos nombres.
sources · compendium · destilado > pila sin procesar.
Al destilar, los nombres y valores marcados como sensibles se convierten en identificadores. Nunca un archivo que diga "excluí X" y enumere X.
El sustrato es donde más se filtra información sin querer: es donde entran los datos reales.
Handle estable · sin contradicciones · pregunta antes.
Si ya tienes el material, el coach ofrece recopilarlo y destilarlo en el momento; si no, anota lo que falta en el memory.md.
Avanzas aunque no tengas todo a mano: la brecha queda registrada, no olvidada.
Recopilar · destilar · registrar lo que falta.
Si la pregunta difícil tiene dos partes («qué vence Y qué ya se atrasó») y falta un dato, la capa es in progress, no sólido.
El coach es honesto sobre lo que todavía no se puede responder y dice qué dato lo resolvería.
Multiparte · honestidad · qué input falta.
Poner todo en bruto en el compendium.md. Un compendio pequeño y limpio vence a uno gigante y desordenado.
Un sustrato sucio atasca el contexto. Destilar es el verdadero trabajo de esta capa.
Destilar > volcar · pequeño y limpio.
Ejecutar /os-coach next en la misma carpeta para que el coach abra y construya el Substrato.
Crea la carpeta substrate/ con los archivos canónicos, alineada con tu objetivo.
siguiente · substrate/ · verificar el compendium.
🚧 siguiente — Reglas
Las barreras del OS: always.md + never.md. El peor error se convierte en un never, más un reflejo automático y la regla de datos privados.
La carpeta rules/ con always.md (lo que siempre debes seguir) y never.md (límites estrictos).
Las reglas escritas se convierten en comportamientos confiables: no dependen de que tú las recuerdes.
siempre · nunca · reglas/.
"¿Cuál es el peor error que podría cometer este OS?" La respuesta se convierte en una never-rule clara.
Transforma tu mayor miedo en una cerca en blanco y negro.
Peor error · regla concreta de nunca hacer · en blanco y negro.
Un gancho es una puerta cerrada: un recordatorio, una verificación o un respaldo que ocurre cada vez sin que nadie tenga que acordarse.
Una regla es un letrero que dice «no pasar»; un gancho es más fuerte porque no se puede ignorar.
Gancho > regla · automático · puerta cerrada.
Si hay datos privados en la carpeta, agrega un never: «nunca subir ni compartir esta carpeta públicamente».
Una filtración no se puede deshacer. Esta regla suele ser el paso n.º 1 de la auditoría.
Nunca público · irreversible · prioridad alta.
"Sé cuidadoso" no es una regla. "Nunca mezcles los números de dos clientes" sí lo es: se puede probar.
Una regla vaga no protege nada. El estándar es que sea concreta y comprobable.
Concreto · comprobable · sin vaguedades.
La capa está lista cuando el peor error se convirtió en una regla clara de nunca hacer y se identificó al menos un reflejo automático.
Da un objetivo claro para «Reglas listas» en lugar de una lista infinita.
Nunca escrito · 1 reflejo · objetivo claro.
Ejecutar /os-coach next de nuevo para que el coach abra las Reglas y escriba always.md + never.md.
Refuerza que siguiente es el mismo comando para cada capa; el orden es automático.
siguiente · rules/ · mismo verbo.
🧩 Habilidades → Herramientas → Agentes
Las tres capas de capacidad, en orden. La primera skill (la más repetida), el tools.md read-only y el primer agente — solo después de las skills.
Una carpeta skills/ con un UM SKILL.md: cuándo usarla, los pasos y cómo saber que quedó bien.
Empieza por la tarea que más repites. Una buena skill vale más que diez a medias.
Una skill · la más repetida · SKILL.md.
Cocinas "a ojo" varias veces y recién entonces escribes la receta. La skill es un verbo que se conquista.
Escribir una skill sobre algo que nunca hiciste a mano genera una receta equivocada.
Primero el manual · capturar después · verbo conquistado.
Un tools.md que enumera cada conexión, para qué sirve y si es de solo lectura o permite escribir. Nunca pongas secretos en la carpeta.
El patrón de solo lectura es el hack de seguridad: el OS observa, pero no modifica nada.
Read-only · sin secretos · solo donde necesitas escribir.
Un AGENT.md para el primer rol que vale la pena promover: qué hace, qué skills coordina y el control de revisión antes de salir.
Promueve a agente solo una rutina que ya haces a mano hoy y para la que haya skills que pueda orquestar.
AGENT.md · orquesta skills · puerta de revisión.
Skills antes que Tools y antes que Agentes. El coach impide construir un agente sin skills que pueda orquestar.
Saltar directamente a Agentes demasiado pronto es el error más común. El orden te protege de él.
Orden · skills primero · agentes al final.
Si una capa todavía no se aplica a tu objetivo, el coach la marca no iniciado con un motivo de una línea y sigue.
Mejor ser honesto que inventar trabajo. No te empujan a usar un agente innecesario.
no iniciado · motivo en 1 línea · sin trabajo innecesario.
Tres siguiente seguidos cubren Habilidades, Herramientas y Agentes: cada uno cuando esté listo.
Construyes las tres capas de capacidad de tu OS, en el orden seguro.
siguiente ×3 · skills/ · tools.md · agents/.
📊 audit — puntuar en función del objetivo
El comando que cierra el ciclo. Puntúa las 6 capas, escribe el OS-AUDIT.md, da los 3 movimientos de mayor impacto y cierra con el ejemplo guiado del fotógrafo.
Lee el memory.md, abre la carpeta real y evalúa cada capa según tu objetivo.
Es el comando que dice, con honestidad, dónde está realmente tu OS.
audit · según el objetivo · escanea la carpeta.
Un archivo con el cuadro de evaluación, los 3 próximos pasos y lo que ya funciona, escrito para que lo guardes.
Al poder guardarse, jamás puede contener un dato sensible filtrado.
Scorecard · guardable · sin filtraciones.
Missing (no existe), Started (básico), Solid (pasa la verificación de finalización), Compounding (mejora por sí solo con el tiempo).
Es la vara de medir honesta. La mayoría de los OS nuevos están en Missing o Started, y está bien.
4 niveles · honesto · empieza poco a poco.
En vez de una lista enorme, tres acciones en orden, cada una vinculada al objetivo y a un archivo real.
Enfoque. Sales de la auditoría sabiendo exactamente qué hacer a continuación.
3 movimientos · por apalancamiento · archivo real.
Cada línea de la auditoría debe fallar si se pega en la auditoría de otra persona. Cita el objetivo, la brecha y el nombre de archivo reales.
Una auditoría genérica es una auditoría fallida. Esta prueba garantiza consejos que te sirven A TI.
Específico · cita archivos · nada de boilerplate.
La regla estricta urgente/irreversible va primero; si no, prevalece la falta de sustrato; las skills solo con sustrato; los agentes al final.
Explica por qué el audit a veces ignora la «parte legal» y te pide que arregles la base.
Precedencia · base antes que capacidad · agentes al final.
El audit reescribe el bloque de estado en el memory.md y anota la fecha; entonces el siguiente siguiente ya parte de ahí.
Cierra el ciclo: auditar no es un informe muerto, es combustible para el siguiente paso.
Feedback · reescribe el estado · alimenta el next.
Una ejecución real, condensada: desde iniciar ("nunca más perder un plazo") al audit, con identificadores "Pareja A/B".
Conecta todo el recorrido en un solo caso: ves cómo nace y se evalúa el OS.
Ejemplo de principio a fin · handles · scorecard real.