Contenido detallado
🧩 Qué hace /onboard
O /onboard es un asistente guiado combinado: lee y escribe el aios-intake.md, guía la entrevista de 7 preguntas y crea con scaffold el conjunto completo de archivos del Día 1 al final. Es la primera acción que ejecutas después de clonar el repositorio AIS-OS.
🎯 Qué entrega el wizard
- •Guía las 7 preguntas con un límite estricto — cada respuesta en menos de 60 segundos
- •Genera todos los archivos de contexto del Día 1 en una sola ronda
- •Hace una copia de seguridad automática de todo lo que existía antes de sobrescribirlo
- •Termina con el «wow moment»: la primera respuesta real de tu AIOS
✓ Qué esperar
- ✓Una sola sesión de ~35 minutos, desde cero hasta un contexto activo
- ✓Preguntas directas, sin rodeos — cada una con un propósito claro
- ✓File-set idempotente — puede ejecutarse de nuevo sin destruir lo que existe
✗ Qué NO es
- ✗No es configuración de .env ni de claves de API (eso es el Día 2)
- ✗No genera skills adicionales — solo el conjunto base de archivos
- ✗No supera las 7 preguntas — nunca profundiza más en la primera ejecución
💡 Consejo práctico
Antes de ejecutar /onboard, abre los archivos con muestras de voz que quieres pegar en Q2. Correos, publicaciones, transcripciones: cualquier texto que hayas escrito sin pensar en "sonar bien". La calidad de references/voice.md determina si AIOS va a sonar como tú o como un robot.
❓ Las 7 preguntas (límite estricto)
/onboard guía exactamente 7 preguntas, cada una con un propósito específico en los 4 Cs. El límite es estricto: ninguna pregunta 8 en la primera ejecución. Cada respuesta debe tomar menos de 60 segundos — si te toma más, estás pensando demasiado.
Quién eres / Qué vendes / Para quién
Alimenta: context/about-me.md + about-business.md
Identidad, oferta principal, ICP y modelo de ingresos. Hechos concretos, no un discurso de ventas.
Muestras de voz (la regla que no se dobla)
Alimenta: references/voice.md
Pega textos que hayas escrito de forma natural. Correos electrónicos, publicaciones, comentarios. Nunca los escribas en el chat durante la conversación.
Prioridades para los próximos 90 días
Alimenta: context/priorities.md
3 a 5 objetivos concretos. "Lanzar el producto X", "reducir el churn en Y%". El wow moment usa esto directamente.
Dónde cae el dinero
Alimenta: connections.md fila Financiero
Stripe, PagSeguro, hoja de cálculo, ERP — qué sistema registra los pagos. Define el dominio de Tier-1 más crítico.
Dónde hablas con clientes y con el equipo
Alimenta: connections.md filas Comunicación + Clientes
WhatsApp, Slack, correo electrónico, Discord: quién habla en cada lugar. Crea el mapa inicial de Connections.
Dónde están las reuniones y los documentos
Alimenta: connections.md filas Calendario + Conocimiento
Google Calendar, Notion, Obsidian, Confluence: dónde se registra el conocimiento y se organiza el tiempo.
La tarea que se lleva la semana
Alimenta: context/priorities.md + semilla de /level-up
La tarea tediosa, manual y repetitiva que más haces. No tiene que ser «automatizable», solo ser una respuesta sincera. Es el primer candidato de /level-up.
⏱️ Límite de 60 segundos
Si una respuesta te está llevando más de 60 segundos, estás racionalizando demasiado. /onboard quiere los hechos que recuerdas, no el discurso perfecto. Puedes editar aios-intake.md después y volver a ejecutar.
🎤 La regla de la voz (Q2)
Q2 es la única regla que no se dobla bajo ninguna circunstancia. Las muestras de voz deben pegarse verbatim de textos que escribiste antes de esta conversación. Nunca las escribas durante la sesión de /onboard.
⚠️ Por qué esto importa
Cuando escribes durante una conversación con Claude, el texto ya está tomando forma según el contexto de la conversación: el tono del modelo, las preguntas que acabas de responder y el formato esperado. El resultado no es tu voz: es tu voz filtrada por el modelo.
"Si escribes aquí mientras conversamos, la muestra ya está moldeada por la conversación." El /onboard tiene instrucciones para rechazar muestras que claramente se escribieron en el momento.
✓ Fuentes válidas para Q2
- ✓Emails que escribiste para clientes (sin revisarlos para que parezcan "mejores")
- ✓Publicaciones en redes sociales de los últimos 6 meses
- ✓Mensajes de WhatsApp o Slack para el equipo
- ✓Comentarios en documentos o notas personales
✗ Fuentes inválidas para Q2
- ✗Texto escrito ahora, durante la sesión de /onboard
- ✗Textos revisados por IA antes de colar
- ✗"Resumen de mi forma de escribir" que acabas de redactar
- ✗Copy de un sitio o biografía de LinkedIn pulida por una agencia
💡 Cuánto pegar
Bastan de 2 a 4 muestras de contextos distintos (correo electrónico, publicación, mensaje informal). El volumen no es calidad: el modelo necesita ver variaciones de contexto, no repeticiones del mismo registro.
📁 Estructura inicial del día 1
Al final de las 7 preguntas, /onboard crea el scaffold del conjunto completo de archivos. No es una plantilla vacía: cada archivo ya contiene las respuestas procesadas de la entrevista, listas para usar de inmediato en una nueva sesión de Claude.
🗂️ Qué hace cada archivo
- about-me.md: Quién eres, cuál es tu rol y cuál es tu principal problema. Interpretado, no un currículum.
- about-business.md: Qué hace el negocio, quién es el cliente ideal y cómo ingresan los ingresos. Hechos, no un discurso de venta.
- priorities.md: Los 3–5 objetivos para los próximos 90 días, más la tarea que ocupa toda la semana (semilla de /level-up).
- voice.md: Las muestras verbatim de Q2. El modelo las lee antes de generar cualquier output dirigido al exterior.
- connections.md: Tabla con los 7 dominios Tier-1 completada con lo que usas. Vacía donde aún no hay ninguna herramienta.
💡 Respaldo automático
/onboard hace una copia de seguridad de cualquier archivo existente en archives/intake-{timestamp}/ antes de sobrescribir. Nunca pierdes lo que había antes; puedes comparar versiones o revertir.
✨ El "wow moment"
El prompt de cierre de /onboard está diseñado para sembrar el Cambio de predeterminado inmediatamente. Después de generar los archivos, el wizard te indica que hagas la primera pregunta real a tu AIOS recién configurado.
← instrucción al usuario después del scaffold
"Ahora abre una nueva sesión de Claude y pregunta:
'¿En qué debería enfocarme esta semana?'
La respuesta debe usar solo los archivos de contexto que acabamos de crear, presenta 3 viñetas con tu voz, cada una vinculada a una prioridad de priorities.md."
🧠 Por qué este es el momento wow
La respuesta usa solo los archivos que acabas de crear — sin contexto de conversación, sin memoria de sesión. Es el AIOS respondiendo desde cero, con base en lo que escribiste sobre ti.
Cuando los bullets suenan como tú y están alineados con lo que definiste como prioritario, ocurre el Default Shift: dejas de pensar que la IA es una herramienta de búsqueda y empiezas a tratarla como un sistema operativo.
- •Si la respuesta es genérica → voice.md necesita más muestras textuales
- •Si la respuesta se desvía del tema → priorities.md necesita objetivos más concretos
- •Si la respuesta es perfecta → acabas de configurar un AIOS funcional
Una buena respuesta se parece a...
"Esta semana el foco es terminar el onboarding del cliente X, ya que representa el mayor ingreso en riesgo antes de que termine el trimestre..." (con tu tono, con contexto real)
Una mala respuesta se parece a...
"Para tener éxito esta semana, debes concentrarte en tareas de alto impacto y administrar tu tiempo con eficiencia..." (genérico — repón el voice.md)
🔄 Idempotencia + re-run
/onboard es idempotente: volver a ejecutarlo no destruye lo que ya existe. Edita el aios-intake.md con las respuestas que quieres actualizar y vuelve a ejecutarlo — el asistente actualiza solo los archivos afectados.
Edita el aios-intake.md
Abre el archivo, encuentra la respuesta que quieres actualizar y edítala directamente. Las respuestas originales quedan comentadas como referencia.
Ejecuta /onboard de nuevo
El wizard detecta el archivo aios-intake.md existente, omite las preguntas ya respondidas y se enfoca solo en las que se modificaron.
Respaldo automático antes de sobrescribir
Antes de actualizar cualquier archivo, /onboard crea una nueva copia de seguridad en archives/intake-{timestamp}/. Siempre puedes revertirlo.
📊 Cuándo volver a ejecutar
- •Las prioridades cambiaron: nuevo trimestre, nuevo objetivo, pivote del negocio
- •Voz insatisfactoria: el AIOS no está sonando como tú — más muestras Q2
- •Nuevos sistemas conectados: actualiza Q4/Q5/Q6 para reflejarlo en connections.md
- •Onboarding de otra persona: clona y ejecuta /onboard en su nuevo proyecto
💡 Revisión trimestral
El CLAUDE.md recomienda una revisión trimestral. Usa /onboard como mecanismo oficial de actualización; no edites los archivos de contexto directamente y de manera ad hoc. Mantener el aios-intake.md como fuente de verdad evita divergencias entre archivos.
🚫 Lo que /onboard NO hace
Tan importante como saber qué hace /onboard es saber qué no hace. Estas limitaciones son intencionales: no son bugs ni brechas que haya que corregir.
✗ Limitaciones intencionales
- ✗No supera las 7 preguntas: la profundidad llega con el tiempo, no el Día 1
- ✗No configura .env: las claves de API y las credenciales quedan para el Día 2
- ✗No genera skills adicionales: solo el file-set base — las skills vienen de /level-up
- ✗No escribe en 3ms-framework.md: la documentación del framework es de solo lectura
✓ Qué viene después
- ✓Día 2: configura las conexiones — MCP, scripts, claves de API
- ✓Día 7: ejecuta /audit para ver el score de los 4 Cs
- ✓Todos los viernes: /level-up — una automatización por semana
- ✓Con cada nuevo uso: edita aios-intake.md y vuelve a ejecutarlo para mantenerlo actualizado
🗺️ Cadencia recomendada del kit
💡 La filosofía del Día 1
/onboard se diseñó para que ninguna pregunta sea un bloqueo. Si ahora no sabes la respuesta a Q4, escribe «Stripe — todavía no está integrado» y continúa. Un AIOS con el 80% del contexto correcto hoy vale más que uno con el 100% dentro de dos semanas.
🚀 Resumen del módulo
Próximo módulo:
3.2 — /audit: Diagnóstico Four-Cs · "Mira cómo sube el puntaje" · El score honesto que muestra dónde AIOS es fuerte y dónde está débil.