OS personal

OS personal con Claude Code

Esta skill te ayuda a construir un «brain»: una carpeta de archivos de texto (en formato Markdown, legible en cualquier editor) donde Claude Code guarda lo que le confías, recupera lo que se ha decidido y prepara tus próximos pasos. Te guía paso a paso, con preguntas sencillas al principio y plantillas que puedes copiar después.

Principio de lectura: sigue los pasos en orden la primera vez. Los archivos de references/ contienen el detalle y las plantillas. Puedes consultarlos según sea necesario.

0. Para qué sirve y qué obtienes

Sin memoria, cada conversación con Claude empieza de cero. Con un brain, la conversación se vuelve desechable y la carpeta se convierte en la memoria: lo importante se escribe en un archivo, y Claude relee los archivos antes de responder.

Lo que obtienes al final de la configuración:

• Una bandeja de entrada (inbox/) donde puedes depositar cualquier material en bruto: transcripciones de reuniones, notas, correos copiados, capturas.
• Un procesamiento en cuatro categorías: las decisiones (con su razón), las acciones (con su responsable), los hechos nuevos, las preguntas abiertas.
• Un diario, un registro de decisiones y una cronología que nunca se reescriben: solo se añade, no se modifica.
• Fichas de temas (un archivo por proyecto) y tablas de resumen regeneradas por un pequeño script.
• Agentes especializados (ingesta, revisión del tablero, verificación de coherencia, redacción, preparación de 1:1, asesoramiento sobre decisiones) y comandos cortos (/inbox, /journal...).
• Un archivo de seguimiento de cambios (CHANGELOG.md) que indica qué informar en una herramienta externa (wiki, sistema de tickets, presentación).

Nada se escribe sin tu consentimiento: Claude propone, tú validas, luego él escribe.

1. Requisitos previos

• Claude Code instalado y funcionando en tu máquina (comando claude disponible en una terminal).
• Una carpeta vacía, por ejemplo ~/brain. Será la única zona donde Claude tiene permiso para escribir en este proyecto.
• Python 3 para el script de vistas (opcional, no necesita instalar nada más).
• Un editor de texto que abra Markdown. Se recomienda un repositorio Git, ya que permite deshacer cambios, pero no es obligatorio.

Abre una terminal en la carpeta vacía y ejecuta claude.

2. La entrevista inicial

Claude te hace estas siete preguntas, una por una, esperando tu respuesta a cada una. Bastan respuestas breves. Esto es lo que Claude hace con cada respuesta.

Pregunta	Qué hace Claude con ella
1. ¿Cuál es tu rol y tu equipo, en una frase?	Completa la sección «Quién soy» de CLAUDE.md para que Claude se dirija a ti al nivel adecuado.
2. ¿Cuáles son tus tres a cinco proyectos en curso?	Crea una ficha de tema por proyecto en 05_scope/sheets/.
3. ¿Con qué personas trabajas más (nombre, rol)?	Completa 03_team/directory.md y prepara la lista de nombres a reconfirmar.
4. ¿Qué tipo de materiales recibes (transcripciones, correos, notas, capturas)?	Configura la clasificación de inbox/ y la lista de formatos que Claude sabe leer.
5. ¿Dónde debe informarse lo que produces (wiki, sistema de tickets, presentaciones)?	Adapta CHANGELOG.md: una línea por página a actualizar, con «añadir» o «reemplazar».
6. ¿En qué idioma escribes y qué reglas de escritura quieres?	Completa la sección «Estilo» de CLAUDE.md.
7. ¿Con qué frecuencia quieres revisiones (día, semana, antes de un 1:1)?	Selecciona los comandos y agentes a instalar primero (paso 5).

Antes de continuar, Claude resume lo que ha entendido en diez líneas y espera tu aprobación.

3. Crear la estructura

Claude propone la estructura de carpetas descrita en references/structure.md, y luego la crea después de tu aprobación. Las carpetas básicas son:

• inbox/ y archive/: el depósito de materiales en bruto y su archivo una vez procesados.
• 00_journal/: diario y cronología (solo añadir).
• 01_steering/: dirección, con el tablero de tareas.
• 02_product/: hechos duraderos sobre los productos.
• 03_team/: directorio de personas, notas de colaboración.
• 04_decisions/: registro de decisiones (solo añadir).
• 05_scope/: fichas de temas y vistas generadas.
• 06_resources/: glosario, documentos de referencia.
• scripts/: el script de vistas.
• .claude/: agentes y comandos.

Regla de oro: un archivo, un tema, un nombre neutral. Ningún archivo lleva el nombre de una persona. Lo que concierne a una persona va en el directorio.

Luego copia las plantillas de references/templates/ reemplazando los campos entre corchetes con tus respuestas del paso 2.

4. Escribir el archivo de instrucciones CLAUDE.md

CLAUDE.md es leído automáticamente por Claude Code en cada sesión. Contiene las reglas del juego. Parte de la plantilla references/templates/CLAUDE.md y verifica que incluya al menos:

1. Quién eres y cómo debe dirigirse Claude a ti.
2. Qué hace Claude cuando llega información nueva (el protocolo de ingesta, ver references/ingestion-rules.md).
3. La regla de actualidad, los archivos de solo añadir, la regla «un hecho, un solo archivo».
4. Las reglas de seguridad del paso 9.
5. El estilo de escritura que elegiste en la pregunta 6.
6. La lista de nombres propios que suelen ser deformados por las herramientas de transcripción, para completar con el tiempo.

Mantén este archivo breve: una o dos páginas. El detalle vive en los archivos de references/, que Claude lee cuando es necesario.

5. Añadir los agentes y los comandos

Un agente es un asistente especializado que tiene sus propias instrucciones y sus propios permisos. Un comando es un atajo que escribes en Claude Code (por ejemplo /inbox). Ambos son simples archivos Markdown en .claude/.

Empieza poco a poco. Instala primero:

• el agente inbox-ingestion y el comando /inbox (para procesar lo que depositas);
• el comando /journal (para registrar una nota rápida).

Añade después, cuando surja la necesidad: board-review, consistency-check, deliverables-writer, meeting-prep, decision-advisor, y los comandos /review-board, /prep-1to1, /propagate. El rol de cada uno está en references/agents.md, las plantillas para copiar en references/templates/.claude/.

Después de cada añadido, pide a Claude que verifique que el archivo se lee: escribe /agents para ver la lista.

6. Primera prueba: depositar una nota y hacerla procesar

1. Escribe o pega una nota real (aunque sea corta) en inbox/, por ejemplo inbox/2026-01-15_reunion-equipo.txt.
2. Escribe /inbox.
3. Claude lee el archivo, detecta pasajes dudosos, cruza con lo existente y te devuelve una lista numerada de modificaciones propuestas, con cada una: el archivo, el antes, el después y la fuente.
4. Responde «valida 1, 2, 4» o «valida todo». Sin una respuesta clara, no se escribe nada.
5. Claude escribe, mueve el original a archive/, anota lo hecho en CHANGELOG.md y vuelve a ejecutar el script de vistas.

El protocolo completo está en references/inbox-processing.md. Un ejemplo de principio a fin, con la nota en bruto y el resultado, está en references/example-acme/.

7. Las rutinas

Cuatro ritmos son suficientes para empezar.

• Cada día (5 minutos). Deposita lo que ha llegado en inbox/, escribe /inbox, valida. Al final del día, escribe /journal para una nota libre.
• Después de una reunión. Deposita la transcripción o tus notas, escribe /inbox. Verifica primero las decisiones y su razón, luego las acciones y su responsable.
• Cada semana. Escribe /review-board, luego pide al agente consistency-check que controle fechas, estados y nombres. Vuelve a ejecutar el script de vistas.
• Antes de un 1:1. Escribe /prep-1to1 [nombre]. El agente meeting-prep reúne lo que se ha dicho, lo que está pendiente y las preguntas abiertas, con la fuente de cada línea.

8. Hacer evolucionar

• Añadir un tema. Copia references/templates/scope-sheet.md en 05_scope/sheets/, completa los campos, luego ejecuta el script de vistas.
• Añadir un agente. Copia una plantilla de references/templates/.claude/agents/, cambia su nombre, descripción e instrucciones. Pruébalo en un caso real antes de adoptarlo.
• Añadir una vista. Escribe o haz que se escriba un pequeño script que lea las fichas y produzca una tabla. Lee, nunca modifica las fichas. El script references/scripts/build_views.py sirve como punto de partida.
• Un cambio afecta varios contenidos. Usa /propagate (ver el caso de uso en references/use-cases.md).

Antes de añadir cualquier cosa, pregúntate cuatro cosas. ¿Esto me evita perder una decisión y su razón? ¿Esto me dice la próxima acción y su responsable en cada proyecto? ¿Esto reduce el esfuerzo para pasar de un tema a otro? ¿Esto deja un rastro útil para mi equipo? Si la respuesta es no en todos los casos, no lo añadas.

9. Reglas de seguridad

1. Propón, valida, escribe. Claude presenta primero lo que planea modificar. Solo escribe después de tu aprobación explícita.
2. Nunca inventar. Una decisión o acción que no está en el texto no se crea. Si falta la razón de una decisión, se escribe «razón no documentada».
3. Señalar la duda. Cuando un pasaje es ambiguo o un nombre parece una deformación de transcripción, Claude lo dice y pregunta en lugar de decidir.
4. No eliminar nada sin acuerdo. Ningún archivo se elimina ni se mueve fuera del flujo previsto (inbox a archive) sin que tú lo hayas solicitado.
5. Distinguir el hecho, el compromiso y la idea. Lo que está hecho, lo que has prometido a alguien y lo que estás considerando son tres estados diferentes. Una sugerencia de Claude nunca se presenta como un compromiso.
6. Mantener la procedencia. Cada línea importante remite a su fuente (archivo, fecha).

Lista de verificación

• claude se inicia en la carpeta del brain y lee CLAUDE.md.
• Las siete preguntas del paso 2 han recibido respuesta y un resumen validado.
• Las carpetas del paso 3 existen, sin archivos con nombre de persona.
• El diario, el registro de decisiones y la cronología están declarados «solo añadir» en CLAUDE.md.
• La regla de actualidad y la regla «un hecho, un solo archivo» figuran en CLAUDE.md.
• El agente inbox-ingestion y el comando /inbox aparecen en /agents y en la lista de comandos.
• Se ha realizado una primera prueba completa: propuesta, validación, escritura, archivado, línea en CHANGELOG.md.
• python3 scripts/build_views.py se ejecuta sin errores y produce las vistas.
• Las cuatro rutinas del paso 7 están anotadas en algún lugar que consultes.
• Las reglas de seguridad del paso 9 están copiadas en CLAUDE.md.

Archivos de la skill

Archivo	Contenido
references/structure.md	Estructura de carpetas recomendada y función de cada una
references/ingestion-rules.md	Reglas de ingesta, con ejemplos antes y después
references/inbox-processing.md	Protocolo de procesamiento de un archivo de bandeja de entrada, ejemplo completo
references/agents.md	Catálogo de los seis agentes
references/use-cases.md	Siete escenarios de uso
references/templates/	Plantillas para copiar (instrucciones, tablero, registro, diario, fichas, agentes, comandos)
references/scripts/build_views.py	Script de generación de vistas
references/example-acme/	Brain de ejemplo completo y ficticio