🌱 Empieza aquí · Mica OS · tu sistema operativo personal con IA

Bienvenido. Acabas de abrir la pieza más importante de El Arsenal: la que convierte a tu asistente de IA en algo mucho más útil que un chat. En vez de arrancar de cero cada vez y preguntarte lo mismo una y otra vez, tu asistente va a recordar, trabajar con método, y cuidar tu información como un socio de verdad.

No necesitas saber programar. Vas a ver algunas palabras en inglés y algún comando raro; ni caso, tu asistente hace el trabajo pesado y te va guiando.

¿Qué es Mica OS? (la versión de un minuto)

El problema. Los asistentes de IA son brillantes, pero olvidadizos. Les explicas tu contexto, trabajas rico un rato, cierras el chat… y al día siguiente es como si nunca se hubieran conocido. Vuelves a explicar quién eres, en qué andabas, qué habías decidido. Se siente como tener un empleado nuevo cada mañana.

La idea. Mica OS le da a tu asistente lo que le falta para dejar de ser un chat y volverse un sistema: una identidad (con nombre y forma de trabajar), un método (principios que lo hacen confiable), una memoria (que sobrevive de una sesión a la otra), y una estructura (para tus proyectos y tu conocimiento). Es, literalmente, un sistema operativo para tu vida y tu trabajo con IA.

Cómo se siente al usarlo. Abres tu asistente y en vez de "¿en qué te ayudo?" te dice "buenos días, hoy el foco es X, ayer quedaste en Y, ¿arrancamos por aquí?". Trabajas, y al cerrar, él guarda lo importante solito. Al otro día retomas sin repetir nada. Eso es Mica OS.

¿Qué trae el kit?

Seis piezas que juntas forman el sistema. No tienes que entenderlas a fondo: tu asistente las instala por ti.

La plantilla del método (kernel/claude-md/) — el "manual de operación" de tu asistente: quién es, cómo te habla, y los principios que lo hacen confiable.
El arranque y cierre de sesión (kernel/skills/) — dos rutinas: una que carga tu contexto al empezar el día, y otra que guarda lo aprendido al terminar.
La memoria y la wiki (kernel/memoria-wiki/) — el "segundo cerebro": un archivo de memoria que tu asistente lee siempre, y carpetas para tus decisiones, aprendizajes y bitácoras.
El jardín de proyectos (kernel/proyectos/) — una forma simple de gestionar todo lo que traes en marcha, tratando cada proyecto como una planta que crece.
El agente administrador (kernel/agente-admin/) — un ayudante que mantiene tu sistema limpio y ordenado sin que tengas que pedírselo.
Esta guía (EMPIEZA-AQUI.md) — el onboarding que estás leyendo.

Para instalarlo

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente lee las instrucciones de abajo, te hace un par de preguntas para personalizar (cómo quieres que se llame, cómo te habla), instala todo, y al final te dice cómo comprobar que quedó.

¿Otras formas de pedírselo? "instala Mica OS", "monta mi sistema operativo personal", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esta sección es para el asistente que instala el kit. Si eres la persona, puedes saltártela.

Mica OS NO es un programa que se ejecuta: es un método + estructura de archivos. "Sembrarlo" es colocar cada pieza donde la plataforma la lee, y personalizar los datos de la persona. Trabaja con la persona: pregúntale cómo quiere llamar a su asistente y cómo quiere que le hable, para llenar los <PLACEHOLDERS> de la plantilla.

Instalación en Claude Code (macOS / Linux / Windows con Git Bash)

Elige con la persona dónde vivirá su sistema (una carpeta suya de trabajo; la llamaremos su "base"). Luego:

1. El método (la plantilla CLAUDE.md). Cópiala como el archivo de instrucciones maestro y personalízala con los datos de la persona (nombre del asistente, tono, quién es ella):

cp kernel/claude-md/CLAUDE.md.plantilla "$HOME/.claude/CLAUDE.md"
# luego edita ese archivo y reemplaza los <PLACEHOLDERS> con lo de la persona

Si la persona ya tiene un CLAUDE.md, NO lo sobrescribas: integra las secciones nuevas con cuidado y respeta lo que ya tenía.

2. Las rutinas de sesión (los dos skills). Cópialas a la carpeta de skills, que se cargan solas:

mkdir -p "$HOME/.claude/skills"
cp -R kernel/skills/arranca-sesion "$HOME/.claude/skills/"
cp -R kernel/skills/cierra-sesion "$HOME/.claude/skills/"

3. La memoria y la wiki. Coloca la memoria y las carpetas de conocimiento en la base de la persona (ajusta la ruta a la que eligieron):

mkdir -p "$HOME/.claude/memory"
cp kernel/memoria-wiki/MEMORY.md "$HOME/.claude/memory/MEMORY.md"   # o la ruta que use su plataforma
cp -R kernel/memoria-wiki/wiki "<BASE-DE-LA-PERSONA>/wiki"

Personaliza el MEMORY.md: reemplaza los <PLACEHOLDERS> con las rutas reales de la persona. En particular, en su sección "Índice de temas", cambia los punteros a la wiki y a los proyectos por las rutas donde de verdad quedaron (memoria y wiki suelen vivir en carpetas distintas, así que un puntero relativo no basta).

4. El jardín de proyectos. Copia la carpeta de proyectos a su base:

cp -R kernel/proyectos "<BASE-DE-LA-PERSONA>/proyectos"

5. El agente administrador. Cópialo a la carpeta de agentes:

mkdir -p "$HOME/.claude/agents"
cp kernel/agente-admin/administrador.md "$HOME/.claude/agents/"

Instalación en Cowork

Cowork usa el mismo concepto de archivo de instrucciones del proyecto (CLAUDE.md) y, si tu proyecto lo soporta, una carpeta de reglas y de skills. Coloca la plantilla del método como el CLAUDE.md del proyecto, y las demás piezas dentro del proyecto en carpetas equivalentes (skills/, agents/, wiki/, proyectos/). Si tu proyecto no soporta skills o agentes como archivos, el método sigue funcionando: las reglas de arranque y cierre viven como texto dentro del CLAUDE.md y el asistente las aplica igual.

Instalación en Codex (compatibilidad parcial)

Codex lee su archivo de instrucciones AGENTS.md. El método (la plantilla del CLAUDE.md, los principios, la estructura de memoria/wiki/proyectos) se porta bien: copia su contenido dentro de AGENTS.md. Lo que no tiene equivalente nativo en Codex son los skills instalables ni el agente administrador como archivos autónomos; ahí, las rutinas de arranque y cierre se aplican como instrucciones dentro de AGENTS.md, no como piezas separadas. Por eso su compatibilidad es parcial: el cerebro del sistema sí, la automatización de piezas no del todo.

Verificación post-siembra (obligatoria)

a) Los archivos quedaron colocados (ejemplo Claude Code):

ls -la "$HOME/.claude/CLAUDE.md" "$HOME/.claude/skills/arranca-sesion" "$HOME/.claude/agents/administrador.md"; echo "exit=$?"

Salida esperada: los archivos listados y exit=0. Si algo sale como "No such file or directory", repite ese paso.

b) El sistema responde (prueba de comportamiento, en una conversación nueva): pídele a la persona que abra una sesión y salude con un "buenos días" o "¿en qué quedamos?". La conducta correcta es que el asistente ancle la fecha, cargue el contexto y presente un foco del día, en vez de responder en frío. Si lo hace, Mica OS está vivo.

Cuando ambas partes pasen, dile a la persona en una línea qué acaba de ganar.

Tu primer día con Mica OS

Para estrenarlo bien, haz esto en tu primera sesión (tu asistente te acompaña):

Preséntate. Cuéntale a tu asistente quién eres y en qué andas. Él lo va a guardar en tu memoria para no volver a preguntártelo.
Siembra tu primer proyecto. Dile "quiero registrar un proyecto: [lo que traes en mente]". Va a crear su archivo en el jardín, en etapa 🌱 semilla.
Trabaja un rato normal. Pídele ayuda con algo real de ese proyecto.
Cierra la sesión. Dile "vamos cerrando". Vas a ver la magia: guarda lo que hicieron, actualiza tu proyecto y deja una nota de en qué quedaron.
Al día siguiente, saluda. Nota cómo retoma exactamente donde se quedaron. Ese es el momento en que Mica OS deja de ser una promesa y se vuelve tu forma de trabajar.

Si algo no sale bien (troubleshooting)

"Mi asistente no carga el contexto al saludar." Revisa que la plantilla del método quedó como su archivo de instrucciones (CLAUDE.md) y que la rutina arranca-sesion está en la carpeta de skills. Empieza una conversación nueva para que recargue.
"No encuentra mi memoria o mis proyectos." Las rutas en el CLAUDE.md y en el MEMORY.md todavía tienen <PLACEHOLDERS>. Pídele a tu asistente que los reemplace con las rutas reales de tu sistema.
"Me pregunta cosas que ya le había dicho." Asegúrate de que esté guardando en la memoria al cerrar (paso 4 del primer día). El sistema solo recuerda lo que alcanzó a escribir.
"Se siente genérico, no como yo quiero." Abre el CLAUDE.md y afina la sección 0 (quién es tu asistente) y la 1 (quién eres tú). Entre más lo personalices, más tuyo se siente.
"Mi memoria creció mucho." Llama al agente administrador: "revisa la salud de mi sistema". Él la poda y la deja bajo su límite.

✅ En resumen

Instálalo una vez, personalízalo un poco, y a partir de ahí trabaja normal. Vas a notar tres cosas: te pregunta menos, recuerda lo importante, y cuida tu información sin que se lo pidas. Dejaste de tener un chat. Ahora tienes un sistema. 🌱