jlholm/noodle

Cerebro

Memoria persistente entre sesiones. Bóveda de Obsidian en brain/.

El cerebro es la base de todo el flujo de trabajo: cada agente, habilidad y sesión lo lee. El contenido de baja calidad o especulativo degrada todo lo que depende de él. Antes de añadir algo, pregúntate: "¿Esto mejora genuinamente cómo opera el sistema?" Si la respuesta no es un "sí" claro, no lo escribas.

Antes de Escribir

Primero lee brain/index.md. Luego lee el punto de entrada relevante para tu tema:

• brain/principles.md para actualizaciones de principios
• brain/plans/index.md para notas relacionadas con planes

Para directorios que aún no tienen un archivo índice dedicado (brain/codebase/, brain/audits/), escanea los archivos cercanos directamente y edita una nota existente cuando sea posible.

Estructura

brain/
├── index.md              ← punto de entrada raíz, enlaza a todo
├── principles.md         ← índice para principles/
├── todos.md              ← backlog del producto
├── vision.md             ← elevator pitch + enlace a arquitectura
├── architecture.md       ← referencia técnica completa
├── principles/           ← principios de ingeniería y diseño
├── codebase/             ← conocimiento específico del proyecto y trucos
├── plans/                ← planes de características numerados (02-arrow-bindings/, etc.)
└── audits/               ← auditorías de diseño y calidad (nombres con prefijo de fecha, ej. 2026-02-20-quality-audit.md)

Reglas:

• Un tema por archivo. brain/codebase/noodle-spawn-gotchas.md, no un archivo monolítico.
• Mantén los puntos de entrada índice existentes: brain/index.md, brain/principles.md, brain/plans/index.md.
• Si introduces una nueva categoría de alto nivel, agrega un punto de entrada tipo índice para ella (solo enlaces, sin contenido en línea).
• brain/index.md es la raíz. Cada archivo del cerebro debe ser alcanzable desde él.
• Nombres de archivo: minúsculas, con guiones. worktree-gotchas.md.
• Directorios de planes: prefijados con el ID de la tarea pendiente de brain/todos.md. 02-arrow-bindings/ con overview.md y phase-N-*.md dentro.

Wikienlaces

Formato: [[sección/nombre-archivo]]. Orden de resolución: mismo directorio, luego ruta relativa, luego raíz de la bóveda. Los anclajes de encabezado ([[archivo#encabezado]]) se eliminan durante la resolución.

Estilo de Escritura

• Viñetas sobre prosa. Sin preámbulo.
• Markdown plano con # Título. Sin frontmatter de Obsidian.
• Mantén las notas por debajo de ~50 líneas. Divide si es más largo.

Después de Escribir

Actualiza brain/index.md para cualquier archivo que hayas añadido o eliminado. También actualiza el punto de entrada relevante (brain/principles.md, brain/delegation.md o brain/plans/index.md) cuando corresponda. Mantén los índices solo con enlaces y escaneables.

Prueba de Durabilidad

Pregúntate: "¿Incluiría esto en un prompt para una tarea diferente?"

• Sí → escribe en brain/. Es conocimiento duradero.
• No, es específico de un plan → actualiza el documento de fase del plan.
• No, es un problema de habilidad → actualiza el archivo de la habilidad directamente.
• No, necesita trabajo de seguimiento → registra una tarea pendiente con la habilidad todo.

Mantenimiento

• Elimina notas obsoletas o subsumidas.
• Elimina archivos con nombres aleatorios en brain/plans/ — artefactos de modo de plan obsoletos.
• Fusiona notas superpuestas antes de añadir nuevas.