{"id":49895037,"url":"https://github.com/iamasters-academy/iamasters-os","last_synced_at":"2026-05-15T23:05:59.293Z","repository":{"id":358071145,"uuid":"1231894603","full_name":"iamasters-academy/iamasters-os","owner":"iamasters-academy","description":"Sistema operativo agéntico para operadores de IA. Sinapsis v4.5 (engine de memoria) + capa OS (brand context, agent context, skills curadas, multi-cliente). En castellano. Por Angel Aparicio · IA Masters Academy.","archived":false,"fork":false,"pushed_at":"2026-05-15T14:51:18.000Z","size":3143,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T16:35:25.218Z","etag":null,"topics":["agentic-os","ai-operator","castellano","claude-code","iamasters","sinapsis","skills-on-demand"],"latest_commit_sha":null,"homepage":"https://www.skool.com/ia-masters-automations","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamasters-academy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-07T11:45:03.000Z","updated_at":"2026-05-15T15:15:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iamasters-academy/iamasters-os","commit_stats":null,"previous_names":["iamasters-academy/iamasters-os"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/iamasters-academy/iamasters-os","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamasters-academy%2Fiamasters-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamasters-academy%2Fiamasters-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamasters-academy%2Fiamasters-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamasters-academy%2Fiamasters-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamasters-academy","download_url":"https://codeload.github.com/iamasters-academy/iamasters-os/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamasters-academy%2Fiamasters-os/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33082807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-os","ai-operator","castellano","claude-code","iamasters","sinapsis","skills-on-demand"],"created_at":"2026-05-15T23:05:58.762Z","updated_at":"2026-05-15T23:05:59.286Z","avatar_url":"https://github.com/iamasters-academy.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.png\" alt=\"IA Masters Academy\" width=\"320\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eiAmasters OS\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eEl sistema operativo agéntico para operadores de IA.\u003cbr\u003e\n  Castellano. Multi-cliente. Con memoria que evoluciona.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/iamasters-academy/iamasters-os/releases\"\u003e\u003cimg src=\"https://img.shields.io/badge/version-v0.6.0-orange.svg\" alt=\"Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"vendor/sinapsis/\"\u003e\u003cimg src=\"https://img.shields.io/badge/engine-Sinapsis%20v4.5-purple.svg\" alt=\"Powered by Sinapsis\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://angelaparicio.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/maintained%20by-Angel%20Aparicio-ff8c42.svg\" alt=\"Maintained by Angel Aparicio\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.skool.com/ia-masters-automations\"\u003e\u003cimg src=\"https://img.shields.io/badge/by-IA%20Masters%20Academy-b794f4.svg\" alt=\"IA Masters Academy\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 🚀 Instalación (v0.6 — con install gate)\n\n**Camino corto (recomendado)** — desde terminal:\n\n```bash\ngit clone https://github.com/iamasters-academy/iamasters-os.git ~/iamasters-os\ncd ~/iamasters-os\nbash scripts/install.sh\n```\n\nEsto 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:\n\n1. El hook **SessionStart** detecta que faltan fases (onboarding + welcome) y guía al agente.\n2. El agente invoca el comando `/install` que orquesta las 4 fases conversacionales restantes.\n3. 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.\n4. Tras el wizard se genera tu primer entregable (`welcome-quick-win`, ~5 min).\n\nTotal realista: 15-20 minutos.\n\n**¿Algo falla?** Ejecuta:\n```bash\nbash scripts/install.sh --resume        # continúa desde la última fase exitosa\nbash scripts/install.sh --force-reinstall  # backup del state actual y arranca limpio\n```\n\nY desde dentro de Claude Code: `/install-status` te muestra el dashboard sin tocar nada.\n\n\u003e 💡 **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`](docs/install-state-schema.md).\n\n¿No tienes Claude Desktop todavía? [Descárgalo aquí](https://claude.com/download). ¿No sabes qué plan necesitas? Ver [💰 Coste real](#-coste-real) abajo.\n\n---\n\n## Qué es\n\n**iAmasters OS** es un repositorio Claude Code que convierte una sesión vanilla en un sistema operativo profesional para operadores de IA. Tres capas:\n\n1. **Sinapsis v4.5 (engine)** — memoria persistente, instintos auto-aprendidos, skills on-demand. Vendoreado intacto del [repo de Luis Pitik](https://github.com/Luispitik/sinapsis).\n2. **Capa OS** — brand context (voice, positioning, ICP), agent context sectorizado (me, work, team, priorities, goals), proyectos estructurados, multi-cliente con templates por vertical.\n3. **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`.\n\n\u003e 🌱 **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`](docs/skills-recommended.md) para proponer una.\n\n## Para quién\n\n- Operador IA freelancer que sirve a varios clientes\n- Empresario que automatiza su negocio con Claude Code\n- Agencia pequeña que quiere estandarizar su stack agéntico\n- Formador que enseña Claude Code y necesita un repo de referencia\n- Cualquier miembro de [IA Masters Academy](https://www.skool.com/ia-masters-automations) (es la audiencia principal)\n\nNo requiere conocimientos de programación. Sí requiere paciencia para configurarlo la primera vez (~15-20 min de onboarding guiado).\n\n## Qué te da el primer día\n\n- ✅ Memoria que persiste entre sesiones (no más \"explícame tu stack otra vez\")\n- ✅ Tu primer entregable real generado por el sistema en los primeros 20 min (welcome-quick-win)\n- ✅ 23 skills curadas, instaladas, listas para activarse cuando hablas con Claude\n- ✅ Brand context (voz, posicionamiento, ICP) generable en 30 minutos extra\n- ✅ Multi-cliente listo para escalar (4 templates de vertical incluidos)\n- ✅ Sistema de aprendizaje continuo: lo que repites se gradúa a regla\n- ✅ Decisions log append-only que mantiene a Claude coherente entre sesiones\n- ✅ `/doctor` para diagnosticar y arreglar cualquier desviación\n\n## 💰 Coste real\n\n**Importante leerlo antes de instalar.** iAmasters OS es gratis y open source, pero requiere Claude (de Anthropic), que NO es gratis.\n\n| Concepto | Coste | Cuándo se paga |\n|---|---|---|\n| iAmasters OS (este repo) | **Gratis** (MIT) | Nunca |\n| Membresía iAmasters Academy | (ver web) | Si quieres la comunidad y formación. **No** es necesaria para usar el OS |\n| Claude Desktop app | Gratis (descarga) | Nunca |\n| **Anthropic Pro** | **$20/mes** | Mínimo necesario para que el OS funcione bien |\n| **Anthropic Max** | $100-200/mes | Si vas a usar mucho Cowork o sesiones largas de Code |\n| Firecrawl API (opcional) | Gratis 500 créditos | Si quieres que el OS scrapee tu web/LinkedIn auto |\n\n**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.\n\n\u003e Si vienes de iAmasters Academy: tu membresía NO incluye Anthropic. Son cuentas separadas. Lo decimos claro porque otros productos lo esconden.\n\n## Instalación alternativa (vía Claude Code)\n\nSi prefieres lanzar todo desde Claude Code (no recomendado para v0.6 — el script técnico se ejecuta mejor desde terminal):\n\n```\nInstala iAmasters OS desde\nhttps://github.com/iamasters-academy/iamasters-os\ny guíame en el setup\n```\n\nClaude 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.\n\nDetalle completo en [`docs/installation.md`](docs/installation.md) y schema del state machine en [`docs/install-state-schema.md`](docs/install-state-schema.md).\n\n## Después de instalar\n\nLo más útil para arrancar:\n\n| Comando / acción | Qué hace |\n|---|---|\n| `/install` | Orquesta la instalación por fases. Reentrante con `--resume` (v0.6) |\n| `/install-status` | Dashboard read-only del state machine (v0.6) |\n| Onboarding wizard (auto) | Te entrevista por sub-fases con commits incrementales |\n| `/welcome` | Genera tu primer entregable HTML compartible (5 min) |\n| `/doctor` | Diagnostica el OS con validación profunda, detecta drift, propone fixes |\n| `/start-here` | Ritual diario de inicio: resumen ayer + propuesta hoy |\n| `/wrap-up` | Ritual de cierre: registra deliverables, decisiones, lecciones |\n\n## Skills incluidas (Capa 1 — preinstaladas)\n\n```\n_meta/                            Sistema y rituales del OS\n├── meta-skill-creator            Crea skills nuevas siguiendo el patrón canónico\n├── meta-onboarding-wizard        Entrevista express adaptativa (8 dimensiones críticas)\n├── meta-deep-dive                🆕 Entrevista profunda adaptativa (22-25 dimensiones)\n├── meta-start-here               Ritual diario de inicio\n├── meta-wrap-up                  Ritual diario de cierre\n├── welcome-quick-win             Tu primer entregable garantizado en 5 min\n├── six-hats                      Método 6 sombreros de De Bono\n├── decisions-log                 Diario append-only inspirado en second-brain\n├── health-check                  Diagnóstico (vía `/doctor`)\n└── find-skills                   Descoverabilidad por intent en lenguaje natural\n\nmarketing/                        Voz, contenido y conversión\n├── marketing-brand-voice         Voice profile + 3 registros A/B/C\n├── marketing-positioning         Análisis de posicionamiento\n├── marketing-icp                 Cliente ideal: dolores, lenguaje, triggers\n├── marketing-copywriting         Copy con humanizer gate obligatorio\n├── marketing-content-repurposing Distribución multiplataforma\n└── marketing-email-sequence      🆕 Secuencias de email (welcome, nurture, win-back)\n\nautomation/                       🆕 Automatización y migración\n├── automation-n8n-to-claude      Migra workflows n8n al ecosistema Claude\n└── automation-n8n-builder        Crea workflows n8n desde Claude (vía MCP n8n-mcp)\n\nstrategy/                         🆕 Investigación y estrategia\n└── strategy-web-research         Research profundo multi-fuente (LangChain)\n\ntools/                            Utilidades transversales\n├── tool-firecrawl-scraper        Wrapper Firecrawl con fallback manual\n├── tool-humanizer                Quita patrones AI-tell del output\n└── tool-output-verifier          Gate de calidad (humanizer + voice + length)\n\nvisualization/                    Outputs compartibles\n└── tool-visual-explainer         Genera HTML autocontenido compartible\n\n_meta/_optional/                  Activables con `/install-skill \u003cnombre\u003e`\n└── cognito                       Sistema Operativo de Pensamiento (Luis Pitik)\n```\n\n\u003e 📦 **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.\n\n¿Quieres más? Ver [`docs/skills-recommended.md`](docs/skills-recommended.md) — catálogo de Capa 2 instalable on-demand con `/install-skill`.\n\n## Estructura del repo\n\n```\niamasters-os/\n├── .claude/\n│   ├── settings.json           # Hooks Sinapsis + permisos seguros por defecto\n│   ├── commands/               # Slash commands del OS\n│   └── skills/                 # 22 skills curadas por categoría\n│\n├── brand-context/              # Tu marca: voice, positioning, ICP, assets\n├── context/                    # Contexto sectorizado: me, work, team, priorities, goals\n│   ├── me.md                   # Identidad\n│   ├── work.md                 # Negocio y revenue\n│   ├── team.md                 # Equipo\n│   ├── current-priorities.md   # Foco actual (cambia mensualmente)\n│   ├── goals.md                # Objetivos 12 meses\n│   ├── decisions-log.md        # Decisiones append-only\n│   ├── learnings.md            # Feedback de skills\n│   └── soul.md                 # Personalidad agente\n│\n├── projects/                   # Outputs por skill o por brief\n│   └── welcome/                # Tu primer entregable vive aquí\n│\n├── clients/                    # Multi-cliente\n│   └── _templates/             # 4 verticales: freelance-ia, agencia-marketing,\n│                               #               formador-online, consultoria-b2b\n│\n├── docs/                       # Guías de instalación, multi-cliente, skills curadas\n├── scripts/                    # install, update, add-client, validate-skill\n└── vendor/\n    └── sinapsis/               # Sinapsis v4.5 vendored (engine de memoria)\n```\n\n## Diferencial vs vanilla Claude Code\n\n| Sin OS | Con iAmasters OS |\n|---|---|\n| Cada sesión empieza explicando tu stack | Sinapsis recuerda y carga skills relevantes |\n| Skills sueltas sin curar | 18 skills validadas para tu avatar |\n| Brand voice cada vez que escribes | Voice profile permanente con 3 registros A/B/C |\n| Outputs sin gate de calidad | `tool-output-verifier` antes de entregar |\n| 1 cliente o se mezcla todo | Multi-cliente con templates por vertical |\n| Sin aprendizaje | Lo que repites 3+ sesiones → regla automática |\n| Sin coherencia entre sesiones | `decisions-log.md` mantiene track record |\n| Si algo se rompe, abandono | `/doctor` diagnostica y propone fixes |\n\n## Compatibilidad\n\n- **Anthropic Plan**: Pro o Max (Free no llega)\n- **OS**: macOS, Linux, Windows (Git Bash o WSL)\n- **Requiere**: Claude Code (incluido en Claude Desktop), Node.js 18+, Python 3.9+, Git\n- **Opcional**: Firecrawl API key (para auto-extraer voice profile y brand assets)\n\n## Roadmap\n\nVer [`CHANGELOG.md`](CHANGELOG.md) para historial detallado.\n\n- **v0.1.0** ✅ esqueleto + Sinapsis vendored + meta-skills + brand-context flow\n- **v0.2.0** ✅ skills marketing core + output-verifier + skill marketplace local\n- **v0.3.0** ✅ multi-cliente + 4 templates verticales + update.sh con conflict resolution\n- **v0.4.0** ✅ MCPs curated + atribución (6 capas)\n- **v0.4.3** ✅ Plug-and-play (URL conversacional, /doctor, welcome quick-win, six-hats, decisions-log, sectorización context)\n- **v0.5.0** ✅ Sistema vivo + skills automation/email/strategy + comando `/aprende` (tour de 5 días) + showcase pre-poblado + plugins Anthropic vía marketplace\n- **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\n- **v0.7.0** — Skills nativas en español (meeting-notes, proposal-writer, youtube-transcript, linkedin-posts) reescritas con voice profile del operador\n- **v1.0.0** — release pública estable + vídeos Loom integrados + landing en iamastersacademy.com/os\n\n## 🌱 Sistema vivo\n\niAmasters OS **no es un producto cerrado**. Es un repositorio que crece con la comunidad de IA Masters Academy.\n\nCada 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.\n\n**Cómo proponer una skill nueva**: ver criterios y proceso en [`docs/skills-recommended.md`](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.\n\n**Cadencia esperada**: release menor cada 4-6 semanas con skills validadas por la comunidad.\n\n## Contribuir\n\niAmasters OS es código abierto bajo MIT. Las contribuciones bienvenidas:\n\n- Nuevas skills (siguiendo el patrón en [`docs/skill-creation-guide.md`](docs/skill-creation-guide.md))\n- Templates de cliente para nuevos verticales\n- Mejoras a la documentación\n- Reportes de bugs en `/doctor` o instalación\n\n## Créditos\n\n- **Sinapsis**: [Luis Pitik](https://github.com/Luispitik/sinapsis) — el engine de memoria persistente\n- **Patrón decisions-log**: inspirado en [`Luispitik/claude-code-second-brain`](https://github.com/Luispitik/claude-code-second-brain)\n- **cognito skill**: original de Luis Pitik, copiada con autorización\n- **find-skills, visual-explainer**: de la suite Anthropic skills + comunidad\n- **Brand Voice patterns A/B/C**: inspirado en el Brand Voice Manual de Fernando Montero\n- **6 sombreros**: método de Edward de Bono, dominio público\n\n## Sobre el proyecto\n\n**iAmasters OS** es propiedad de **Angel Aparicio** y forma parte del ecosistema de productos de **[IA Masters Academy](https://www.skool.com/ia-masters-automations)**, la comunidad de operadores de IA en castellano.\n\n| | |\n|---|---|\n| **Autor y mantenedor** | Angel Aparicio |\n| **Marca** | IA Masters Academy |\n| **Empresa legal** | AASC Associates |\n| **Web personal** | [angelaparicio.com](https://angelaparicio.com) |\n| **LinkedIn** | [angel-aparicio92](https://www.linkedin.com/in/angel-aparicio92/) |\n| **GitHub** | [@angelapaia](https://github.com/angelapaia) |\n| **GitHub Org** | [@iamasters-academy](https://github.com/iamasters-academy) |\n| **Comunidad** | [skool.com/ia-masters-automations](https://www.skool.com/ia-masters-automations) |\n| **Email** | aaparicio@iamastersacademy.com |\n| **Año** | 2025-2026 |\n\n### Cómo citar\n\nSi usas iAmasters OS en tu trabajo, proyecto o publicación, agradecemos la citación. Ver [`CITATION.cff`](CITATION.cff) para el formato estructurado. Referencia rápida:\n\n\u003e Aparicio, A. (2025-2026). *iAmasters OS* [Software]. IA Masters Academy.\n\u003e https://github.com/iamasters-academy/iamasters-os\n\n### Code ownership\n\nEste repositorio sigue el modelo CODEOWNERS de GitHub. Cualquier PR requiere review del propietario. Ver [`.github/CODEOWNERS`](.github/CODEOWNERS) para el detalle.\n\n### Marca\n\n\"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.\n\nPara uso de marca, contactar: aaparicio@iamastersacademy.com\n\n## Licencia\n\nCódigo fuente bajo MIT — ver [LICENSE](LICENSE).\nComponente vendored Sinapsis v4.5 conserva su licencia \"Source Available\" original de Luis Pitik en [`vendor/sinapsis/LICENSE`](vendor/sinapsis/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamasters-academy%2Fiamasters-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamasters-academy%2Fiamasters-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamasters-academy%2Fiamasters-os/lists"}