Memory Bank

Descripción General

AI Cockpit Reasoning trabaja de manera más eficiente con Memory Bank habilitado, comprendiendo instantáneamente el contexto del proyecto y las tecnologías.

El Problema: Pérdida de Memoria de la IA

Los asistentes de IA como AI Cockpit Reasoning enfrentan una limitación fundamental: se reinician completamente entre sesiones. Esta "pérdida de memoria" significa que cada vez que inicia una nueva conversación, necesita volver a explicar la arquitectura, los objetivos, las tecnologías y el estado actual de su proyecto. Esto crea un dilema crítico de eficiencia: los modelos de IA o bien realizan ediciones sin una comprensión adecuada del proyecto (lo que lleva a errores y soluciones desalineadas), o deben dedicar tiempo y recursos significativos a analizar toda su base de código en cada sesión (lo que es prohibitivamente costoso y lento para proyectos más grandes).

Sin una solución a este problema de memoria, los asistentes de IA siguen siendo herramientas poderosas pero sin estado que no pueden funcionar verdaderamente como socios de desarrollo persistentes.

La Solución: Memory Bank

Memory Bank es un sistema de documentación estructurada que permite a AI Cockpit Reasoning comprender mejor su proyecto y mantener el contexto entre sesiones de codificación. Transforma su asistente de IA de una herramienta sin estado en un socio de desarrollo persistente con recuerdo perfecto de los detalles de su proyecto. AI Cockpit Reasoning lee automáticamente sus archivos de Memory Bank para reconstruir su comprensión de su proyecto cada vez que inicia una nueva sesión.

Cuando Memory Bank está activo, AI Cockpit Reasoning comienza cada tarea con [Memory Bank: Active] y un breve resumen del contexto de su proyecto, garantizando una comprensión consistente sin explicaciones repetitivas.

Beneficios Clave

• Independiente del Lenguaje: Funciona con cualquier lenguaje de programación o framework
• Comprensión Eficiente del Proyecto: Ayuda a AI Cockpit Reasoning a comprender el propósito y la pila tecnológica de un proyecto
• Preservación del Contexto: Mantiene el conocimiento del proyecto entre sesiones sin necesidad de escanear archivos en cada nueva sesión
• Inicio Más Rápido: AI Cockpit Reasoning comprende inmediatamente el contexto de su proyecto cuando inicia una nueva sesión
• Proyectos Auto-documentados: Cree documentación valiosa como subproducto

Cómo Funciona el Memory Bank

Memory Bank se basa en la función de Reglas Personalizadas de AI Cockpit Reasoning, proporcionando un framework especializado para la documentación del proyecto. Los archivos de Memory Bank son archivos markdown estándar almacenados en la carpeta .AI Cockpitcode/rules/memory-bank dentro del repositorio de su proyecto. No están ocultos ni son propietarios: son archivos de documentación regulares a los que tanto usted como AI Cockpit Reasoning pueden acceder.

Al inicio de cada tarea, AI Cockpit Reasoning lee todos los archivos de Memory Bank para construir una comprensión completa de su proyecto. Esto ocurre automáticamente sin requerir ninguna acción de su parte. AI Cockpit Reasoning luego indica la activación exitosa del Memory Bank con [Memory Bank: Active] al comienzo de su respuesta, seguido de un breve resumen de su comprensión de su proyecto.

Los archivos están organizados en una estructura jerárquica que construye una imagen completa de su proyecto:

Archivos Principales del Memory Bank

brief.md

Este archivo es creado y mantenido manualmente por usted

• La base de su proyecto
• Descripción general de alto nivel de lo que está construyendo
• Requisitos y objetivos principales

Ejemplo: "Construyendo una aplicación web React para gestión de inventario con escaneo de códigos de barras. El sistema necesita admitir múltiples almacenes e integrarse con nuestro sistema ERP existente."

Nota: AI Cockpit Reasoning no editará este archivo directamente, pero puede sugerir mejoras si identifica formas de mejorar el resumen de su proyecto.

product.md

• Explica por qué existe el proyecto
• Describe los problemas que se están resolviendo
• Describe cómo debería funcionar el producto
• Objetivos de experiencia del usuario

Ejemplo: "El sistema de inventario necesita admitir múltiples almacenes y actualizaciones en tiempo real. Resuelve el problema de discrepancias de inventario al proporcionar escaneo de códigos de barras para conteos de stock precisos."

context.md

• El archivo actualizado con más frecuencia
• Contiene el enfoque de trabajo actual y los cambios recientes
• Rastrea las decisiones activas y las consideraciones
• Próximos pasos para el desarrollo

Ejemplo: "Actualmente implementando el componente del escáner de códigos de barras; la última sesión completó la integración de la API. Los próximos pasos incluyen agregar manejo de errores para fallos de red."

architecture.md

• Documenta la arquitectura del sistema
• Registra las decisiones técnicas clave
• Lista los patrones de diseño en uso
• Explica las relaciones entre componentes
• Rutas de implementación críticas

Ejemplo: "Usando Redux para la gestión de estado con una estructura de almacenamiento normalizada. La aplicación sigue una arquitectura modular con servicios separados para comunicación de API, gestión de estado y componentes de UI."

tech.md

• Lista las tecnologías y frameworks utilizados
• Describe la configuración de desarrollo
• Anota las restricciones técnicas
• Registra las dependencias y configuraciones de herramientas
• Patrones de uso de herramientas

Ejemplo: "React 18, TypeScript, Firebase, Jest para pruebas. El desarrollo requiere Node.js 16+ y usa Vite como herramienta de compilación."

Archivos de Contexto Adicionales

Cree archivos adicionales según sea necesario para organizar:

• Documentación de funciones complejas
• Especificaciones de integración
• Documentación de API
• Estrategias de pruebas
• Procedimientos de despliegue

Estos archivos adicionales ayudan a organizar información más detallada que no encaja perfectamente en los archivos principales.

tasks.md

Archivo opcional para documentar tareas repetitivas

• Almacena flujos de trabajo para tareas que siguen patrones similares
• Documenta qué archivos necesitan modificarse
• Captura procedimientos paso a paso
• Registra consideraciones importantes y advertencias

Ejemplo: Agregar soporte para nuevos modelos de IA, implementar endpoints de API, o cualquier tarea que requiera hacer trabajos similares repetidamente.

Primeros Pasos con Memory Bank

Configuración Inicial

1. Cree una carpeta .AI Cockpitcode/rules/memory-bank/ en su proyecto
2. Escriba un resumen básico del proyecto en .AI Cockpitcode/rules/memory-bank/brief.md
3. Cree un archivo .AI Cockpitcode/rules/memory-bank-instructions.md y pegue allí este documento
4. Cambie al modo Architect
5. Verifique que esté seleccionado el mejor modelo de IA disponible, no use modelos "ligeros"
6. Pida a AI Cockpit Reasoning que "inicialice el memory bank"
7. Espere a que AI Cockpit Reasoning analice su proyecto e inicialice los archivos del Memory Bank
8. Verifique el contenido de los archivos para ver si el proyecto está descrito correctamente. Actualice los archivos si es necesario.

Consejos para el Resumen del Proyecto

• Comience de manera simple: puede ser tan detallado o de alto nivel como desee
• Enfóquese en lo que más le importa
• AI Cockpit Reasoning ayudará a llenar los vacíos y hacer preguntas
• Puede actualizarlo a medida que evoluciona su proyecto

Prompt de muestra que produce un resumen razonablemente bueno:

Proporcione una descripción concisa y completa de este proyecto, destacando sus principales objetivos, características clave, tecnologías utilizadas y significado. Luego, escriba esta descripción en un archivo de texto con un nombre apropiado que refleje el contenido del proyecto, asegurando claridad y profesionalismo en la redacción. Sea breve y conciso.

Trabajar con Memory Bank

Flujos de Trabajo Principales

Inicialización del Memory Bank

El paso de inicialización es de vital importancia ya que establece la base para todas las interacciones futuras con su proyecto. Cuando solicita la inicialización con el comando initialize memory bank, AI Cockpit Reasoning:

1. Realizará un análisis exhaustivo de su proyecto, incluyendo:
   • Todos los archivos de código fuente y sus relaciones
   • Archivos de configuración y configuración del sistema de compilación
   • Estructura del proyecto y patrones de organización
   • Documentación y comentarios
   • Dependencias e integraciones externas
   • Frameworks y patrones de pruebas
2. Creará archivos completos del memory bank en la carpeta .AI Cockpitcode/rules/memory-bank
3. Proporcionará un resumen detallado de lo que ha comprendido sobre su proyecto
4. Le pedirá que verifique la precisión de los archivos generados

Importante

Tómese el tiempo para revisar y corregir cuidadosamente los archivos generados después de la inicialización. Cualquier malentendido o información faltante en esta etapa afectará todas las interacciones futuras. Una inicialización exhaustiva mejora dramáticamente la efectividad de AI Cockpit Reasoning, mientras que una inicialización apresurada o incompleta limitará permanentemente su capacidad para asistirle de manera efectiva.

Actualizaciones del Memory Bank

Las actualizaciones del Memory Bank ocurren cuando:

1. AI Cockpit Reasoning descubre nuevos patrones del proyecto
2. Después de implementar cambios significativos
3. Cuando lo solicita explícitamente con update memory bank
4. Cuando el contexto necesita aclaración

Para ejecutar una actualización del Memory Bank, AI Cockpit Reasoning:

1. Revisará TODOS los archivos del proyecto
2. Documentará el estado actual
3. Documentará perspectivas y patrones
4. Actualizará todos los archivos del memory bank según sea necesario

Puede dirigir a AI Cockpit Reasoning para que se enfoque en fuentes de información específicas usando comandos como update memory bank using information from @/Makefile.

Ejecución Regular de Tareas

Al comienzo de cada tarea, AI Cockpit Reasoning:

1. Lee TODOS los archivos del memory bank
2. Incluye [Memory Bank: Active] al comienzo de su respuesta
3. Proporciona un breve resumen de su comprensión de su proyecto
4. Procede con la tarea solicitada

Al final de una tarea, AI Cockpit Reasoning puede sugerir actualizar el memory bank si se realizaron cambios significativos, usando la frase: "¿Le gustaría que actualizara el memory bank para reflejar estos cambios?"

Flujo de Trabajo para Agregar Tareas

Cuando completa una tarea repetitiva que sigue un patrón similar cada vez, puede documentarla para referencia futura. Esto es particularmente útil para tareas como agregar funciones que siguen patrones existentes.

Para documentar una tarea, use el comando add task o store this as a task. AI Cockpit Reasoning:

1. Creará o actualizará el archivo tasks.md en la carpeta del memory bank
2. Documentará la tarea usando el contexto actual:
   • Nombre y descripción de la tarea
   • Lista de archivos que necesitan modificarse
   • Flujo de trabajo paso a paso
   • Consideraciones importantes
   • Ejemplo de implementación

Cuando inicia una nueva tarea, AI Cockpit Reasoning verificará si coincide con alguna tarea documentada y seguirá el flujo de trabajo establecido para garantizar que no se omita ningún paso.

Comandos Clave

• initialize memory bank - Úselo cuando inicie un nuevo proyecto
• update memory bank - Inicia un reanálisis completo de la documentación contextual para la tarea actual. Precaución: Esto consume muchos recursos y no se recomienda para modelos "ligeros" debido a una efectividad potencialmente reducida. Se puede usar varias veces, combinable con instrucciones específicas, por ejemplo update memory bank using information from @/Makefile
• add task o store this as a task - Documenta una tarea repetitiva para referencia futura

Indicadores de Estado

AI Cockpit Reasoning usa indicadores de estado para comunicar claramente el estado del Memory Bank:

• [Memory Bank: Active] - Indica que los archivos del Memory Bank se leyeron correctamente y están siendo utilizados
• [Memory Bank: Missing] - Indica que los archivos del Memory Bank no se pudieron encontrar o están vacíos

Estos indicadores aparecen al comienzo de las respuestas de AI Cockpit Reasoning, proporcionando confirmación inmediata del estado del Memory Bank.

Actualizaciones de Documentación

Las actualizaciones del Memory Bank deben ocurrir automáticamente cuando:

• Descubre nuevos patrones en su proyecto
• Después de implementar cambios significativos
• Cuando lo solicita explícitamente con update memory bank
• Cuando siente que el contexto necesita aclaración

Gestión de la Ventana de Contexto

A medida que trabaja con AI Cockpit Reasoning, su ventana de contexto eventualmente se llenará. Cuando note que las respuestas se ralentizan o las referencias se vuelven menos precisas:

1. Pida a AI Cockpit Reasoning que "actualice el memory bank" para documentar el estado actual
2. Inicie una nueva conversación/tarea
3. AI Cockpit Reasoning accederá automáticamente a su Memory Bank en la nueva conversación

Este proceso garantiza la continuidad entre múltiples sesiones sin perder contexto importante.

Manejo de Inconsistencias

Si AI Cockpit Reasoning detecta inconsistencias entre los archivos del memory bank:

1. Priorizará la información de brief.md como fuente de verdad
2. Le notificará cualquier discrepancia
3. Continuará trabajando con la información más confiable disponible

Esto garantiza que incluso con documentación imperfecta, AI Cockpit Reasoning pueda seguir funcionando de manera efectiva.

Preguntas Frecuentes

¿Dónde se almacenan los archivos del memory bank?

Los archivos del Memory Bank son archivos markdown regulares almacenados en el repositorio de su proyecto, típicamente en una carpeta .AI Cockpitcode/rules/memory-bank/. No son archivos de sistema ocultos: están diseñados para ser parte de la documentación de su proyecto.

¿Con qué frecuencia debo actualizar el memory bank?

Actualice el Memory Bank después de hitos significativos o cambios de dirección. Para el desarrollo activo, las actualizaciones cada pocas sesiones pueden ser útiles. Use el comando "update memory bank" cuando quiera asegurarse de que todo el contexto esté preservado.

¿Puedo editar los archivos del memory bank manualmente?

¡Sí! Si bien AI Cockpit Reasoning gestiona la mayoría de los archivos, puede editar cualquiera de ellos manualmente. El archivo brief.md está específicamente diseñado para ser mantenido por usted. AI Cockpit Reasoning respetará las ediciones manuales de otros archivos.

¿Qué sucede si faltan los archivos del memory bank?

Si faltan los archivos del memory bank, AI Cockpit Reasoning indicará esto con [Memory Bank: Missing] al comienzo de su respuesta y sugerirá inicializar el memory bank.

¿Funciona Memory Bank con todos los modelos de IA?

Memory Bank funciona con todos los modelos de IA, pero los modelos más potentes crearán archivos del memory bank más completos y precisos. Los modelos ligeros pueden tener dificultades con el proceso intensivo en recursos de analizar y actualizar los archivos del memory bank.

¿Puedo usar Memory Bank con múltiples proyectos?

¡Sí! Cada proyecto tiene su propio Memory Bank en su carpeta .AI Cockpitcode/rules/memory-bank/. AI Cockpit Reasoning usará automáticamente el Memory Bank correcto para cada proyecto.

¿El Memory Bank consume mi ventana de contexto?

Sí, Memory Bank consume parte de su ventana de contexto al comienzo de cada sesión mientras carga todos los archivos del memory bank. Sin embargo, esta es una compensación estratégica que mejora significativamente la eficiencia general. Al cargar el contexto del proyecto al inicio:

• Elimina las explicaciones repetitivas que consumirían aún más contexto con el tiempo
• Alcanza resultados productivos con menos intercambios de ida y vuelta
• Mantiene una comprensión consistente durante toda su sesión

Las pruebas muestran que si bien Memory Bank usa más tokens inicialmente, reduce dramáticamente el número total de interacciones necesarias para lograr resultados. Esto significa menos tiempo explicando y más tiempo construyendo.

Mejores Prácticas

Primeros Pasos

• Comience con un resumen básico del proyecto y deje que la estructura evolucione
• Deje que AI Cockpit Reasoning ayude a crear la estructura inicial
• Revise y ajuste los archivos según sea necesario para adaptarse a su flujo de trabajo
• Verifique la precisión de los archivos generados después de la inicialización

Trabajo Continuo

• Deje que los patrones emerjan naturalmente mientras trabaja
• No fuerce las actualizaciones de documentación: deben ocurrir orgánicamente
• Confíe en el proceso: el valor se acumula con el tiempo
• Observe la confirmación del contexto al inicio de las sesiones
• Use los indicadores de estado para confirmar que Memory Bank está activo

Flujo de Documentación

• brief.md es su base
• context.md cambia con más frecuencia
• Todos los archivos colectivamente mantienen la inteligencia del proyecto
• Actualice después de hitos significativos o cambios de dirección

Optimización del Rendimiento del Memory Bank

• Mantenga los archivos del memory bank concisos y enfocados
• Use archivos adicionales para documentación detallada
• Actualice regularmente pero no en exceso
• Use comandos de actualización específicos cuando se enfoque en aspectos particulares

Recuerde

El Memory Bank es el único vínculo de AI Cockpit Reasoning con el trabajo anterior. Su efectividad depende completamente de mantener una documentación clara y precisa y confirmar la preservación del contexto en cada interacción. Cuando vea [Memory Bank: Active] al comienzo de una respuesta, puede estar seguro de que AI Cockpit Reasoning tiene una comprensión completa de su proyecto.