El OS completo de una clínica dental, construido capa por capa con la skill os-agentes. Seis carpetas, ni una línea de código.
# todo el OS es una carpeta criaagentes/ ├── CLAUDE.md # quién es ├── substrate/ # qué sabe │ ├── compendium.md # ← la única fuente │ ├── sources.md │ └── subject-matter-expertise/ ├── rules/ # qué nunca hace │ ├── never.md │ └── always.md ├── skills/ # cómo responde │ └── responder-duvida-whatsapp/ ├── tools.md # a qué tiene acceso ├── agents/ # quién decide │ └── recepcionista-whatsapp/ ├── memory.md # cada decisión y el motivo └── OS-AUDIT.md # dónde falla primero
Este repositorio es el estudio de caso completo de un asistente de WhatsApp para la Clínica Sorriso Prime (una clínica ficticia, usada para demostración). Se construyó por completo con la skill os-agentes (/os-agentes), una capa a la vez, y cada decisión queda registrada con su motivo. La mayoría de los mensajes que llegan al WhatsApp de una clínica son de gente nueva que pregunta precios y horarios. Eso es lo que resuelve.
Si no está escrito en el compendio, no existe. El asistente no completa la respuesta por su cuenta, aunque parezca obvia. Prueba rápida para cualquier respuesta: ¿dónde está escrito eso?
El dolor, los síntomas, los medicamentos, los descuentos, las quejas, las urgencias o cualquier cosa fuera del compendio se convierten en una alerta en Telegram, con prioridad normal, alta o urgente. Detenerse no significa que el agente falle: significa que está funcionando.
O memory.md guarda las decisiones y sus motivos. Por qué la alerta es por Telegram y no por WhatsApp, por qué la agenda es de solo lectura, por qué solo hay una skill. Dentro de tres meses, nadie tendrá que recordarlo.
El orden no es decorativo. La identidad define lo que el sustrato debe cubrir; el sustrato alimenta las skills; las skills existen antes que el agente que las orquesta. Saltarse una etapa es construir sobre arena.
26 líneas. Quién es, a quién atiende y cuatro negativas que se pueden probar. La más importante: nunca decir que hay turnos disponibles.
La capa más grande. El documento oficial de la clínica queda como fuente; el compendium.md es el destilado que el asistente lee en el día a día.
Una regla es un letrero que dice «no entres». Un hook es una puerta cerrada con llave. Aquí hay un hook que importa: la alerta de Telegram se activa sola.
Solo una, a propósito. Clasificar el mensaje en tres categorías: responde por su cuenta, depende de la agenda o necesita intervención humana.
Google Calendar de solo lectura y alertas en un grupo de Telegram. Una ventana, no la llave de la casa. No hay secretos en la carpeta.
La skill es la herramienta, el agente es el cocinero. Un rol acotado y un filtro de revisión de cinco preguntas antes de que salga cualquier respuesta.
Sin servidor, compilación ni dependencias. El OS es una carpeta de archivos de texto. Quien hace el trabajo es Claude Code al leer esa carpeta.
Es donde se construyen las capas y donde se ejecuta el agente.
# ábrelo en la carpeta del OS cd criaagentes && claude
Es lo que hace que este proyecto exista: guía la construcción capa por capa, hace las preguntas y escribe los archivos. Instálalo y llámalo por /os-agentes.
# repo: github.com/inematds/os-agentes /os-agentes help
Precios, horarios, políticas y las preguntas más frecuentes. Sirve tanto si está escrito como si lo tienes en la cabeza.
# se convierte en substrate/compendium.md /os-agentes layer substrate
Este OS se construyó exactamente con los comandos que aparecen a continuación, en este orden. Cada comando termina haciendo dos o tres preguntas sencillas y escribiendo los archivos de esa capa.
Sin jerga. Di qué quieres que pase. OS Coach crea el memory.md y ya entra en la capa de Identidad.
/os-agentes start quero criar um agente para atender dúvidas das pessoas na minha clínica usando whatsapp # → memory.md + CLAUDE.md
Cada next toma la siguiente capa sin terminar, pregunta solo lo que falta y escribe los archivos. Sin volcar las seis capas de una vez.
/os-agentes next # → substrate/compendium.md + sources.md /os-agentes next # → rules/never.md + rules/always.md /os-agentes next # → skills/responder-duvida-whatsapp/SKILL.md /os-agentes next # → tools.md /os-agentes next # → agents/recepcionista-whatsapp/AGENT.md
Si ya existe una tabla de precios, un documento de políticas o un papel en la recepción, indica el archivo. El sustrato es la capa más grande y la que más tiempo ahorra cuando el material ya existe.
# basta con indicar la ruta del archivo en la conversación # → se convierte en substrate/subject-matter-expertise/ (fuente) # → destilado en substrate/compendium.md (lo que lee el agente)
Las capas no son peldaños de un solo sentido. Cada vez que una respuesta sale mal, la corrección se hace en el compendio o en la skill, nunca en la cabeza de quien estaba de turno.
/os-agentes layer substrate # identity | substrate | rules | skills | tools | agents /os-agentes status # ¿dónde me quedé?
Califica las seis capas, señala dónde falla primero y escribe el resultado en OS-AUDIT.md. En esta auditoría, dos capas bajaron de nota, y una de ellas por un motivo que nadie había visto.
/os-agentes audit # → OS-AUDIT.md: scorecard + las 3 acciones más importantes
Cada mensaje cae en una de las tres categorías. Y hay una regla que resuelve los casos difíciles: si tienes dudas sobre la categoría, siempre es la tercera.
No es la respuesta desagradable. Es la respuesta amable, simpática, verosímil e inventada. Pasa desapercibida precisamente porque parece correcta. Un precio inventado se convierte en una queja, un horario inventado hace que un paciente llegue sin tener una cita y una opinión sobre el dolor se convierte en un riesgo para la salud. Todo es el mismo error con distinto aspecto: afirmar como oficial algo que no sabe.
Las seis capas están escritas. La auditoría de 2026-07-15 bajó de nota a dos, y por motivos honestos en ambos casos. El scorecard completo está en OS-AUDIT.md.