🛠️ Operar en la práctica

Una skill que lee/escribe aios-intake.md, guía la entrevista de 7 preguntas y crea con scaffold el conjunto de archivos del Día 1 al final. Es idempotente: volver a ejecutarlo solo actualiza lo que cambió.

Sin /onboard, el sistema queda genérico. Con él, Claude Code ya conoce tu negocio, tu voz y tus prioridades desde la primera conversación, e instala el Default Shift de inmediato.

Idempotencia · asistente combinado · aios-intake.md · Default Shift · estructura base del Día 1.

Siete preguntas con límite estricto: Q1 quién vende qué y a quién · Q2 muestras de voz · Q3 prioridades para los próximos 90 días · Q4 dónde cae la facturación · Q5 dónde hablas con clientes/equipo · Q6 dónde están las reuniones/documentos · Q7 la tarea que te consume la semana. Menos de 60s cada una.

El límite de 7 es intencional: más preguntas = menos respuestas. Siete es el mínimo para generar suficiente contexto y el máximo para no cansarte el Día 1.

Límite estricto · 7 dominios de contexto · receta · voz · prioridades de 90 días.

La única regla inquebrantable de /onboard: las muestras de voz deben PEGARSE verbatim, nunca escribirse durante la conversación. «Si escribes aquí mientras conversamos, la muestra ya está moldeada por la conversación.»

La voz es el diferencial del contenido generado. Una muestra contaminada por la sesión genera textos que parecen «IA genérica» en vez de sonar como tú. /onboard rechaza activamente la muestra si detecta escritura en vivo.

Verbatim · contaminación de voz · references/voice.md · muestra vs. descripción de voz.

Al final de las 7 preguntas, /onboard genera: context/about-me.md, context/about-business.md, context/priorities.md, references/voice.md, connections.md (7 líneas) y completa el CLAUDE.md. Copia de seguridad en archives/intake-{ts}/.

Estos archivos son la memoria permanente del sistema. Sin ellos, cada conversación empieza desde cero. Con ellos, Claude sabe quién eres, qué vendes y dónde enfocarse, sin que tengas que volver a explicarlo.

File-set · context/ · references/ · CLAUDE.md · copia de seguridad en archives/ · idempotencia.

Prompt automático al final del /onboard: "¿en qué debería enfocarme esta semana?". La respuesta usa SOLO los archivos de contexto generados, en 3 viñetas con la voz del usuario, cada una vinculada a una prioridad de los 90 días.

Es el momento que siembra el Default Shift: el usuario ve por primera vez el sistema responder como socio estratégico, no como mecanógrafo. La primera experiencia define si el ritual perdurará.

Cambio de predeterminado · momento sorprendente · 3 viñetas · voz del usuario · prioridades para los próximos 90 días.

Edita aios-intake.md y ejecuta /onboard de nuevo. Solo actualiza lo que cambió, omite las preguntas ya respondidas y hace una copia de seguridad automática antes de sobrescribir.

Tu negocio cambia. Cuando cambie, basta con editar el intake y volver a ejecutarlo: no hace falta reconfigurarlo desde cero. La idempotencia convierte el onboarding en una rutina de actualización.

Volver a ejecutar · diff incremental · backup automático · aios-intake.md como fuente de verdad.

No supera las 7 preguntas · no escribe .env (sin claves el Día 1 — las conexiones llegan el Día 2) · no genera skills adicionales · read-only en el 3ms-framework.md.

Los límites explícitos evitan que el alcance se expanda. /onboard es acotado por diseño: hace una cosa bien. Las conexiones y automatizaciones vienen en las rutas siguientes; no las mezcles.

Narrow by design · scope creep · conexiones en el Día 2 · read-only · separación de responsabilidades.

/audit recorre el sistema según los 4 Cs (Context, Connections, Capabilities, Cadence), asigna un score a cada dimensión, identifica brechas y genera una lista de próximas acciones ordenadas por apalancamiento.

Sin diagnóstico, las mejoras son aleatorias. /audit hace visible el progreso: ves cómo sube el puntaje semana tras semana, lo que afianza el comportamiento y justifica la inversión de tiempo.

4 Cs · score de salud · brechas · próximas acciones · apalancamiento.

Verifica si context/, references/voice.md, priorities.md y CLAUDE.md están presentes, completos y actualizados. El score baja si los archivos son vagos, están desactualizados o faltan.

Context es la base de todo. Un sistema con Capabilities y Connections excelentes, pero con Context pobre, producirá respuestas genéricas. La auditoría obliga a revisar el contexto antes de escalar.

Puntuación de Context · completitud · actualidad · CLAUDE.md como radar.

Revisa connections.md y los MCP configurados. El score refleja cuántas herramientas reales de tu negocio puede alcanzar el sistema frente a cuántas todavía requieren copiar y pegar manualmente.

Las conexiones son multiplicadores de leverage. Cada MCP conectado elimina un puente manual. El audit muestra exactamente dónde están los puentes restantes y prioriza cuáles eliminar primero.

connections.md · MCP · puentes manuales · apalancamiento de integración.

Cuenta y evalúa las skills en .claude/skills/ y artefactos en decisions/log.md. Score mide la profundidad (skills especializadas) frente a la amplitud (áreas cubiertas).

Capabilities crece con cada /level-up. La auditoría muestra si estás acumulando skills de forma estratégica o aleatoria, e identifica áreas del negocio que aún no tienen cobertura.

Skills · artefactos · decisions/log.md · profundidad vs. amplitud · cobertura estratégica.

Verifica si hay cadencias definidas, cuáles se ejecutan sin una solicitud explícita y cuáles todavía dependen de un trigger manual. El score penaliza las tareas que "deberían ejecutarse solas" pero no lo hacen.

Cadence es el C más difícil de implementar. El audit hace evidente la brecha entre «lo automaticé» y «está funcionando de verdad»; una diferencia que normalmente lleva semanas descubrir sin un diagnóstico.

Cadencias · activación manual vs. automática · brecha de ejecución · puntuación de Cadence.

Al final, /audit entrega: puntuación de 0 a 100 por cada C + total · lista de acciones priorizadas (primero las de mayor impacto) · sugerencia del próximo objetivo de /level-up.

El marcador genera responsabilidad. Ver cómo el número sube de 42 a 67 en dos semanas es lo que convierte al operador de «lo estoy intentando» en «estoy progresando». La lista elimina la parálisis por tener que elegir.

Puntuación de 0-100 · rendición de cuentas · lista priorizada · próximo objetivo · progreso visible.

Primera ronda: Día 7 después del /onboard. A partir de ahí: semanal (puedes combinarla con el /level-up cada viernes) o quincenal para quien esté en una fase de expansión acelerada.

La frecuencia define la velocidad de mejora. Audit mensual = feedback muy lento. Audit diario = trabajo adicional sin una señal clara. Semanal es el punto de equilibrio demostrado por el kit AIS-OS.

Día 7 · ritual semanal · frecuencia de feedback · carga adicional vs. señal.

Skill que recorre las 3 Ms (Mindset → Method → Machine) cada semana para encontrar y lanzar UNA automatización. Además de entregar el artefacto, instala las 3 Ms en la mente de quien la opera.

La mayoría de las personas intenta automatizarlo todo de una vez y no entrega nada. /level-up te obliga a enfocarte en UNA cosa por semana: ese es el ritmo que produce 52 automatizaciones al año sin agotamiento.

3 Ms · una automatización/semana · brain-rewire · entrevista estructurada · artefacto scaffoldado.

5 preguntas para encontrar candidatos: ¿qué hiciste 3+ veces? ¿Algo manual o de copiar y pegar? ¿"Un pasante listo podría hacerlo"? Si llegaran 500 clientes, ¿qué se rompería? ¿Qué permitiría atender a 500 clientes? Resultado: 1-3 candidatos clasificados por apalancamiento.

La mayoría quiere automatizar lo emocionante, no lo que bloquea. Las 5 preguntas te obligan a identificar el verdadero cuello de botella antes de construir cualquier cosa.

Candidato · clasificación por apalancamiento · cuello de botella real · copia mental · cuello de botella de escala.

5 pasos: Find constraint → EAD (Eliminar primero; si "nada se rompe", sales feliz y registras la victoria) → Map (5 elementos) → Autonomy (valor predeterminado en el nivel más bajo) → KPI (categoría + métrica, obligatorio; de lo contrario, se detiene).

EAD es la etapa más contraintuitiva y valiosa: a veces, la mejor "automatización" es eliminar la tarea por completo. El KPI obligatorio evita construir cosas imposibles de medir y, por lo tanto, imposibles de mejorar.

EAD · constraint · Map 5 elementos · Autonomy ladder · KPI como puerta de salida.

4 opciones en orden Boring-is-Beautiful: (1) prompt guardado → (2) Skill determinística → (3) Skill asistida por IA → (4) sub-agent (último recurso). El valor predeterminado = la opción más alta SIN IA que resuelve el problema.

La tendencia natural es ir directamente al sub-agent complejo. Boring-is-Beautiful lo revierte: las soluciones simples son más confiables, más fáciles de depurar y se entregan más rápido. La IA es el último recurso, no la opción predeterminada.

Boring-is-Beautiful · escalera de complejidad · prompt guardado → skill → sub-agent · predeterminado simple.

Todo artefacto nace con bike-method-phase: 1 en el frontmatter. Esto bloquea al usuario en la Fase 1 (validación manual). Avanzar a la Fase 2 requiere editar el archivo explícitamente — sin atajos.

La mayoría omite la validación manual y solo descubre que la automatización no funciona después de semanas. El lock exige un ciclo de retroalimentación humana antes de escalar: ahorra tiempo y evita bugs en producción.

bike-method-phase · frontmatter · validación manual · Fase 1 → 2 → 3 explícita · ciclo de feedback.

Cada run de /level-up produce exactamente: 1 entrada en decisions/log.md (spec del Method) + 1 artefacto con scaffold + 1 pantalla de cierre con recordatorio de la Fase 1.

El contrato de salida garantiza la trazabilidad. Sin un log de decisions, no sabes qué se decidió ni por qué. Con él, en 6 meses tendrás un historial de 24+ automatizaciones con su rationale.

decisions/log.md · spec · artefacto con scaffold · trazabilidad · justificación.

Después de ejecutar /level-up cada viernes durante 4-6 semanas, los 3 Ms se internalizan. Empiezas a identificar oportunidades de automatización durante reuniones, correos y conversaciones, sin necesitar la Skill para detectarlas.

/level-up no es solo una herramienta: es un programa de entrenamiento cognitivo. El objetivo final no es la skill en sí, sino instalar permanentemente la mentalidad de operador de AIOS.

Brain-rewire · 3 Ms internalizadas · mentalidad de operador · 4-6 ejecuciones · rituales todos los viernes.

Estructura base inmutable: context/ · references/ · decisions/log.md · archives/ · connections.md · .claude/skills/ · aios-intake.md · CLAUDE.md. Quitar cualquiera de ellos rompe el sistema.

Saber qué no eliminar es tan importante como saber qué agregar. Cada archivo de la base cumple una función crítica: sin él, una skill entera deja de funcionar.

Estructura base · inmutabilidad del core · dependencias implícitas · kit de integridad.

Cuando la operación lo justifica: projects/ (2+ flujos de trabajo) · templates/ (dejó de copiar el prompt) · brand-assets/ · references/sops/ · references/{tool}-api.md · scripts/ · .claude/agents/ · carpetas sub-OS.

Cada expansión tiene un desencadenante claro («dejaste de copiar el prompt» = templates/). Sin ese criterio, creas carpetas por adelantado, que se convierten en un sótano en 2 semanas.

Disparador de expansión · templates/ · projects/ · sub-OS · expansión bajo demanda.

Cinco antipatrones fatales: volcar correos electrónicos/Slack en references/ · carpeta de carpetas (una estructura plana con buenos nombres es mejor) · notes/misc/tmp/inbox (cementerios) · crear carpetas de antemano · duplicar decisions · más de 1 CLAUDE.md en la raíz.

Cada antipatrón transforma el AIOS en un sótano. La diferencia entre un «negocio bien gestionado» y un «desorden digital» está en seguir estas 5 reglas de higiene de forma constante.

Antipatrones · estructura plana · cementerio digital · crear de antemano · duplicación · un único CLAUDE.md.

Cadencias por archivo: decisions/log.md (cada decisión tomada) · archives/ (limpieza trimestral) · sops/ (cuando alguien nuevo vuelve a ejecutar un proceso) · connections.md (cada tool nuevo) · CLAUDE.md (revisión trimestral).

Sin una cadencia, los archivos quedan desactualizados y pierden valor. Con una cadencia, el sistema crece de forma orgánica: cada archivo tiene un responsable temporal claro.

Cadencia por archivo · decisión inmediata · limpieza trimestral · revisión periódica · sistema vivo.

Antes de crear una carpeta: (1) ¿es algo conceptualmente nuevo? (2) ¿la voy a usar 3+ veces el próximo mes? (3) ¿/level-up dirigiría una Skill futura aquí? 2 respuestas afirmativas = agrégala. 1 respuesta afirmativa = espera.

Es la puerta de entrada para cualquier expansión. La mayoría crea una carpeta en el primer uso. La regla exige evidencia de un patrón antes de estructurar — previene el 80% de los sótanos.

3 síes · puerta de expansión · primero el patrón, luego la estructura · 2/3 síes = crear · 1/3 = esperar.

Frameworks avanzados para cuando el sistema crezca: Data Retrieval Hierarchy · Integration Ladder · Error Handling Playbook · Model Selection · Context Engineering · Discovery · Security & Permissions. Filosofía central: "Tu AIOS debe parecer un negocio pequeño y bien gestionado, no un sótano de acumulador."

Cuando el sistema escala, estos frameworks ofrecen patrones para decisiones que no tienen una respuesta obvia. Conocerlos antes de necesitarlos significa no improvisar bajo presión.

Frameworks de branch · escala · sótano vs. negocio bien gestionado · decisiones bajo presión · filosofía operativa.