Estructura de la bóveda y depuración

Organiza una bóveda de markdown como una segunda memoria buscable. Clasifica los cuatro modos de falla cuando Claude hace algo inesperado.

STATE.md y MEMORY.md contienen lo que cada sesión necesita. Una bóveda de markdown (Obsidian o cualquier carpeta) contiene todo lo demás: notas de estrategia, transcripciones de reuniones, diarios de proyectos, investigación, análisis competitivo.

La bóveda se convierte en memoria institucional: decisiones que tomaste hace seis meses y por qué, materiales de referencia que informan el trabajo actual, patrones que abarcan proyectos. Conéctala a través de un MCP de Obsidian o del sistema de archivos y Claude puede buscar todo a pedido. Sin la bóveda, este conocimiento existe solo en tu cabeza o enterrado en documentos antiguos.

Por qué markdown es mejor que una base de datos: los archivos planos son buscables con grep, se versionan con git, se abren en cualquier editor y sobreviven a cada cambio de herramienta. Una estructura de trabajo:

~/notes/

├── STATE.md # Siempre cargado

├── MEMORY.md # Índice, siempre cargado

├── STRATEGY-DIGEST.md # Resúmenes de documentos de estrategia

├── strategy/ # Documentos completos, leídos bajo demanda

├── projects/ # Notas de proyectos fechadas

├── resources/

└── reference/La clave de escalado es el patrón de resumen: cuando escribas un documento de estrategia de 1,000 palabras, escribe un resumen de 3 oraciones junto a él e indexa el resumen en MEMORY.md. Claude lee aproximadamente 50 tokens al inicio de la sesión en lugar de los aproximadamente 1,500 del documento completo. Con 25 documentos de estrategia, eso son 1,250 tokens versus 37,500, y las sesiones se mantienen rápidas.

Cuando Claude hace algo inesperado, verifica cuatro modos de falla en orden, de más a menos común:

Memoria obsoleta: STATE.md dice una cosa, la realidad dice otra. Claude siguió tus instrucciones perfectamente; las instrucciones eran incorrectas. Pregunta "Muéstrame tu STATE.md" primero, siempre.

Contexto faltante: el archivo relevante nunca se cargó, por lo que Claude hizo una suposición razonable. Carga el archivo explícitamente y vuelve a preguntar.

Herramienta no disponible: un MCP está caído o un hook bloqueó un comando, y Claude lo solucionó mal. Verifica la disponibilidad de la herramienta antes de culpar al razonamiento.

Alucinación: la causa más rara. Verifica primero: busca la función con grep, verifica que el endpoint exista. La mayoría de las "alucinaciones" resultan ser una de las tres primeras.

Una pregunta de diagnóstico por cada modo de falla:

Memoria obsoleta: "¿Qué dice tu STATE.md sobre [tema]?" Contenido de hace tres sesiones significa estado obsoleto.

Contexto faltante: "¿Qué archivos tienes cargados sobre [tema]?" Ningún archivo relevante significa cargar el correcto.

Herramienta no disponible: "¿Qué herramientas tienes disponibles ahora mismo?"

Alucinación: "Busca con grep [función/endpoint] y muéstrame lo que encuentres."

La secuencia toma dos minutos y encuentra la causa casi siempre. Saltar directamente a "Claude alucinó" generalmente retrasa la solución real al reescribir código que no necesitaba ser reescrito.

La prevención es mejor que la depuración. Los hábitos:

Actualización de STATE.md al final de la sesión. Elimina el 80% de los problemas de memoria obsoleta.

Archiva proyectos enviados en archivos project_* fechados.

Auditoría mensual de MEMORY.md: confirma que cada puntero aún apunta a un archivo existente.

Resume cada documento de más de 500 palabras.

Escribe las decisiones en el momento de la decisión, no al final de la semana. La captura retroactiva pierde el razonamiento.

Antes de archivar las notas del proyecto, extrae las lecciones duraderas en entradas feedback_*. El proyecto se convierte en historia; las lecciones permanecen activas.

Una bóveda con 10 documentos bien mantenidos es mejor que una con 200 obsoletos. La calidad y la actualidad son mejores que el volumen.

Con un MCP de Obsidian o del sistema de archivos, la bóveda se convierte en una base de conocimiento viva:

Arqueología de decisiones: "Busca en la bóveda por qué elegimos Postgres sobre MySQL." Una búsqueda manual de 10 minutos se convierte en 15 segundos.

Detección de patrones: "Encuentra todas las menciones de problemas de limitación de tasa o errores 429 en todos los proyectos." Claude saca a la luz una causa raíz común distribuida en cinco archivos de proyecto.

Búsqueda de referencias: "Encuentra la información de contacto en las notas del proveedor." Recuperación instantánea de archivos no indexados.

La calidad de la búsqueda depende de la consistencia de los nombres: project_[nombre]_[fecha].md y feedback_[regla].md son mejores que lo que parecía natural en ese momento. Las convenciones de nombres son el índice que construyes antes de necesitarlo.

¿Los cuatro modos están limpios y la salida sigue siendo incorrecta? Dos causas que parecen alucinación pero no lo son.

Orden del contexto: cuando los archivos cargados entran en conflicto, el contenido cargado más tarde tiende a ganar. Si las notas antiguas del proyecto contradicen STATE.md, asigna autoridad explícitamente: "STATE.md es la verdad fundamental actual. Anula cualquier cosa en las notas del proyecto."

Colisiones de restricciones: CLAUDE.md dice "parametriza todo el SQL", por lo que Claude reescribe SQL durante lo que tú pretendías como una refactorización solo de estilo. No es un error; delimítalo explícitamente: "Solo estilo, no cambies los patrones SQL."

El diagnóstico para ambos: "¿Qué instrucciones estás siguiendo que rigen [esta decisión]? Enumera las reglas en orden de prioridad." Encontrarás una fuente obsoleta, una regla conflictiva o una brecha en CLAUDE.md. Todo solucionable.

Una bóveda de markdown con archivos de resumen escala tu segunda memoria; los resúmenes mantienen las sesiones rápidas, los documentos completos se cargan bajo demanda. Cuando Claude se comporta mal, clasifica en orden: memoria obsoleta, contexto faltante, herramienta no disponible, alucinación, y siempre comienza con "muéstrame tu STATE.md." Alimenta la bóveda en el momento de la decisión y su valor se multiplica cada semana.