iAmasters OS

El sistema operativo agéntico para operadores de IA.
Castellano. Multi-cliente. Con memoria que evoluciona.

🚀 Instalación (v0.6+ — con install gate)

Camino corto (recomendado) — desde terminal:

git clone https://github.com/iamasters-academy/iamasters-os.git ~/iamasters-os
cd ~/iamasters-os
bash scripts/install.sh

Esto instala las fases técnicas (prereqs + Sinapsis engine) con validación profunda. Cuando termine, abre Claude Code en esta carpeta y el resto se completa por dentro:

1. El hook SessionStart detecta que faltan fases (onboarding + welcome) y guía al agente.
2. El agente invoca el comando /install que orquesta las 4 fases conversacionales restantes.
3. El onboarding wizard te entrevista por sub-fases con commits incrementales: si te interrumpes a mitad, lo guardado queda guardado y /install --resume retoma exactamente donde lo dejaste.
4. Tras el wizard se genera tu primer entregable (welcome-quick-win, ~5 min).

Total realista: 15-20 minutos.

¿Algo falla? Ejecuta:

bash scripts/install.sh --resume        # continúa desde la última fase exitosa
bash scripts/install.sh --force-reinstall  # backup del state actual y arranca limpio

Y desde dentro de Claude Code: /install-status te muestra el dashboard sin tocar nada.

💡 Por qué este flujo (v0.6+): la versión anterior reportaba a veces "todo instalado" cuando partes habían fallado silenciosamente. Ahora hay un state machine persistente en ~/.claude/skills/_install-state.json que es la fuente de verdad sobre qué está realmente instalado. Validación profunda, no solo presencia de archivos. Ver docs/install-state-schema.md.

¿No tienes Claude Desktop todavía? Descárgalo aquí. ¿No sabes qué plan necesitas? Ver 💰 Coste real abajo.

Qué es

iAmasters OS es un repositorio Claude Code que convierte una sesión vanilla en un sistema operativo profesional para operadores de IA. Tres capas:

1. Sinapsis v4.5 (engine) — memoria persistente, instintos auto-aprendidos, skills on-demand. Vendoreado intacto del repo de Luis Pitik.
2. Capa OS — brand context (voice, positioning, ICP), agent context sectorizado (me, work, team, priorities, goals), proyectos estructurados, multi-cliente con templates por vertical.
3. Skills curadas — 23 skills validadas para marketing, estrategia, automatización, tools, visualización y meta-pensamiento. Todas siguen patrón skill.md + references/ + scripts/. Skills oficiales de Anthropic (docx, xlsx, pdf, pptx) se instalan vía marketplace en el día 4 de /aprende.

🌱 Sistema vivo: el catálogo crece con la comunidad. Cuando una skill nueva de IA Masters Academy demuestra valor en producción, entra al repo. Ver docs/skills-recommended.md para proponer una.

Para quién

• Operador IA freelancer que sirve a varios clientes
• Empresario que automatiza su negocio con Claude Code
• Agencia pequeña que quiere estandarizar su stack agéntico
• Formador que enseña Claude Code y necesita un repo de referencia
• Cualquier miembro de IA Masters Academy (es la audiencia principal)

No requiere conocimientos de programación. Sí requiere paciencia para configurarlo la primera vez (~15-20 min de onboarding guiado).

Qué te da el primer día

• ✅ Memoria que persiste entre sesiones (no más "explícame tu stack otra vez")
• ✅ Tu primer entregable real generado por el sistema en los primeros 20 min (welcome-quick-win)
• ✅ 23 skills curadas, instaladas, listas para activarse cuando hablas con Claude
• ✅ Brand context (voz, posicionamiento, ICP) generable en 30 minutos extra
• ✅ Multi-cliente listo para escalar (4 templates de vertical incluidos)
• ✅ Sistema de aprendizaje continuo: lo que repites se gradúa a regla
• ✅ Decisions log append-only que mantiene a Claude coherente entre sesiones
• ✅ /doctor para diagnosticar y arreglar cualquier desviación

💰 Coste real

Importante leerlo antes de instalar. iAmasters OS es gratis y open source, pero requiere Claude (de Anthropic), que NO es gratis.

Conclusión: el coste mínimo realista para empezar bien es $20/mes de Anthropic Pro. Con plan Free los modelos buenos no llegan y el OS se siente roto.

Si vienes de iAmasters Academy: tu membresía NO incluye Anthropic. Son cuentas separadas. Lo decimos claro porque otros productos lo esconden.

Instalación alternativa (vía Claude Code)

Si prefieres lanzar todo desde Claude Code (no recomendado para v0.6 — el script técnico se ejecuta mejor desde terminal):

Instala iAmasters OS desde
https://github.com/iamasters-academy/iamasters-os
y guíame en el setup

Claude Code clonará el repo y te indicará abrir terminal para ejecutar bash scripts/install.sh (las fases técnicas necesitan terminal). Tras eso, el flujo es el mismo: el install gate guía las fases restantes.

Detalle completo en docs/installation.md y schema del state machine en docs/install-state-schema.md.

Después de instalar

Lo más útil para arrancar:

Skills incluidas (Capa 1 — preinstaladas)

_meta/                            Sistema y rituales del OS
├── meta-skill-creator            Crea skills nuevas siguiendo el patrón canónico
├── meta-onboarding-wizard        Entrevista express adaptativa (8 dimensiones críticas)
├── meta-deep-dive                🆕 Entrevista profunda adaptativa (22-25 dimensiones)
├── meta-start-here               Ritual diario de inicio
├── meta-wrap-up                  Ritual diario de cierre
├── welcome-quick-win             Tu primer entregable garantizado en 5 min
├── seis-sombreros                Método 6 sombreros de De Bono con anti-ancla y 7 variantes (v0.7)
├── decisions-log                 Diario append-only inspirado en second-brain
├── health-check                  Diagnóstico (vía `/doctor`)
└── find-skills                   Descoverabilidad por intent en lenguaje natural

marketing/                        Voz, contenido y conversión
├── marketing-brand-voice         Voice profile + 3 registros A/B/C
├── marketing-positioning         Análisis de posicionamiento
├── marketing-icp                 Cliente ideal: dolores, lenguaje, triggers
├── marketing-copywriting         Copy con humanizer gate obligatorio
├── marketing-content-repurposing Distribución multiplataforma
└── marketing-email-sequence      🆕 Secuencias de email (welcome, nurture, win-back)

automation/                       🆕 Automatización y migración
├── automation-n8n-to-claude      Migra workflows n8n al ecosistema Claude
└── automation-n8n-builder        Crea workflows n8n desde Claude (vía MCP n8n-mcp)

strategy/                         Investigación, estrategia y metodologías
├── metodo-ias                    🆕 Método I.A.S. (Intención · Acción · Síntesis) anti-AI-brain-fry (v0.7)
└── strategy-web-research         Research profundo multi-fuente (LangChain)

tools/                            Utilidades transversales
├── tool-firecrawl-scraper        Wrapper Firecrawl con fallback manual
├── tool-humanizer                Quita patrones AI-tell del output
├── tool-output-verifier          Gate de calidad (humanizer + voice + length)
└── tool-zoom-summary             🆕 Resumen HTML interactivo de reuniones Zoom (v0.7)

visualization/                    Outputs compartibles
└── tool-visual-explainer         Genera HTML autocontenido compartible

_meta/_optional/                  Activables con `/install-skill <nombre>`
├── cognito                       Sistema Operativo de Pensamiento (Luis Pitik)
└── arnes                         🆕 Arrancar proyectos software por niveles
                                    (Express / Estándar / PRO) — vibe-coders
                                    no técnicos. Concepto fs-scaffold (Fernando Montero)

📦 Skills oficiales Anthropic (docx, xlsx, pdf, pptx): NO se vendorean en este repo porque su licencia es "source-available" (no permite redistribución). Se instalan vía marketplace oficial dentro de Claude Code (/plugin install anthropic-skills). El comando /aprende día 4 te guía paso a paso.

¿Quieres más? Ver docs/skills-recommended.md — catálogo de Capa 2 instalable on-demand con /install-skill.

Estructura del repo

iamasters-os/
├── .claude/
│   ├── settings.json           # Hooks Sinapsis + permisos seguros por defecto
│   ├── commands/               # Slash commands del OS
│   └── skills/                 # 22 skills curadas por categoría
│
├── brand-context/              # Tu marca: voice, positioning, ICP, assets
├── context/                    # Contexto sectorizado: me, work, team, priorities, goals
│   ├── me.md                   # Identidad
│   ├── work.md                 # Negocio y revenue
│   ├── team.md                 # Equipo
│   ├── current-priorities.md   # Foco actual (cambia mensualmente)
│   ├── goals.md                # Objetivos 12 meses
│   ├── decisions-log.md        # Decisiones append-only
│   ├── learnings.md            # Feedback de skills
│   └── soul.md                 # Personalidad agente
│
├── projects/                   # Outputs por skill o por brief
│   └── welcome/                # Tu primer entregable vive aquí
│
├── clients/                    # Multi-cliente
│   └── _templates/             # 4 verticales: freelance-ia, agencia-marketing,
│                               #               formador-online, consultoria-b2b
│
├── docs/                       # Guías de instalación, multi-cliente, skills curadas
├── scripts/                    # install, update, add-client, validate-skill
└── vendor/
    └── sinapsis/               # Sinapsis v4.5 vendored (engine de memoria)

Diferencial vs vanilla Claude Code

Compatibilidad

• Anthropic Plan: Pro o Max (Free no llega)
• OS: macOS, Linux, Windows (Git Bash o WSL)
• Requiere: Claude Code (incluido en Claude Desktop), Node.js 18+, Python 3.9+, Git
• Opcional: Firecrawl API key (para auto-extraer voice profile y brand assets)

Roadmap

Ver CHANGELOG.md para historial detallado.

• v0.1.0 ✅ esqueleto + Sinapsis vendored + meta-skills + brand-context flow
• v0.2.0 ✅ skills marketing core + output-verifier + skill marketplace local
• v0.3.0 ✅ multi-cliente + 4 templates verticales + update.sh con conflict resolution
• v0.4.0 ✅ MCPs curated + atribución (6 capas)
• v0.4.3 ✅ Plug-and-play (URL conversacional, /doctor, welcome quick-win, six-hats, decisions-log, sectorización context)
• v0.5.0 ✅ Sistema vivo + skills automation/email/strategy + comando /aprende (tour de 5 días) + showcase pre-poblado + plugins Anthropic vía marketplace
• v0.6.0 ✅ Install gate con state machine persistente, validación profunda anti-"instalación fantasma", hook SessionStart, onboarding por sub-fases con commits incrementales, comandos /install y /install-status, detección Python multi-plataforma
• v0.7.0 ✅ Skills nativas en español: seis-sombreros (renombre + reescritura completa con anti-ancla y 7 variantes), metodo-ias (método I.A.S. propio para sesiones agénticas), tool-zoom-summary (resumen HTML interactivo de reuniones Zoom)
• v0.8.0 ✅ Skill opt-in arnes — arrancar proyectos software por niveles (Express 5 min / Estándar 20-30 min / PRO 1-2 h) para vibe-coders no técnicos. Concepto fs-scaffold de Fernando Montero, adaptación de Angel Aparicio. Vendoreada en vendor/arnes/, activable con /install-skill arnes. Repo upstream: iamasters-academy/arnes
• v1.0.0 — release pública estable + vídeos Loom integrados + landing en iamastersacademy.com/os

🌱 Sistema vivo

iAmasters OS no es un producto cerrado. Es un repositorio que crece con la comunidad de IA Masters Academy.

Cada vez que un miembro construye una skill que demuestra valor en producción (validada ≥2 semanas, útil para ≥3 avatares, sin dependencias privadas), entra al catálogo en la siguiente release. Cada vez que una skill se queda obsoleta o tiene mejor reemplazo, sale.

Cómo proponer una skill nueva: ver criterios y proceso en docs/skills-recommended.md → sección "Cómo proponer una skill al catálogo". El maintainer (Angel) revisa, y las que pasan entran en próxima release con crédito al autor.

Cadencia esperada: release menor cada 4-6 semanas con skills validadas por la comunidad.

Contribuir

iAmasters OS es código abierto bajo MIT. Las contribuciones bienvenidas:

• Nuevas skills (siguiendo el patrón en docs/skill-creation-guide.md)
• Templates de cliente para nuevos verticales
• Mejoras a la documentación
• Reportes de bugs en /doctor o instalación

Créditos

• Sinapsis: Luis Pitik — el engine de memoria persistente
• Patrón decisions-log: inspirado en Luispitik/claude-code-second-brain
• cognito skill: original de Luis Pitik, copiada con autorización
• arnes skill: adaptación de Angel Aparicio del concepto fs-scaffold de Fernando Montero (Café Camaleónico, 18-may-2026). Mantenida en iamasters-academy/arnes y vendoreada en vendor/arnes/
• find-skills, visual-explainer: de la suite Anthropic skills + comunidad
• Brand Voice patterns A/B/C: inspirado en el Brand Voice Manual de Fernando Montero
• 6 sombreros: método de Edward de Bono, dominio público

Sobre el proyecto

iAmasters OS es propiedad de Angel Aparicio y forma parte del ecosistema de productos de IA Masters Academy, la comunidad de operadores de IA en castellano.

Cómo citar

Si usas iAmasters OS en tu trabajo, proyecto o publicación, agradecemos la citación. Ver CITATION.cff para el formato estructurado. Referencia rápida:

Aparicio, A. (2025-2026). iAmasters OS [Software]. IA Masters Academy.
https://github.com/iamasters-academy/iamasters-os

Code ownership

Este repositorio sigue el modelo CODEOWNERS de GitHub. Cualquier PR requiere review del propietario. Ver .github/CODEOWNERS para el detalle.

Marca

"IA Masters Academy", "iAmasters OS" y el logo del camaleón son marcas registradas de AASC Associates · Angel Aparicio. El código fuente se publica bajo licencia MIT (libre uso/modificación), pero el uso de la marca y los logos requiere autorización explícita por escrito.

Para uso de marca, contactar: [email protected]

Licencia

Código fuente bajo MIT — ver LICENSE.
Componente vendored Sinapsis v4.5 conserva su licencia "Source Available" original de Luis Pitik en vendor/sinapsis/LICENSE.