Aislamiento de Memoria

Cómo se organiza la memoria across orgs y repos.

Dos niveles de memoria

Memoria de org (compartida)
└── .achords/.engram/
    └── Todos los repos la ven

Memoria de repo (aislada)
└── .engram/
    └── Solo este repo la ve

Memoria de org

Vive en .achords/.engram/. Compartida across todos los repos de la org.

Contiene:

• Convenciones de org
• Decisiones de arquitectura
• Descubrimientos compartidos
• Patrones cross-repo

Memoria de repo

Vive en .engram/. Específica de cada repo.

Contiene:

• Bugs específicos del repo
• Patrones locales
• Decisiones de features
• Descubrimientos de testing

Cómo se sincroniza

.achords/.engram/ vive dentro del submodule .achords. Esto significa que:

1. achords obase --org my-company crea .achords/.engram/config.json en el repo de la org
2. Se commitea y pushea al repo .achords (ej. github.com/my-company/.achords)
3. Cada achords obase --repo my-app agrega .achords como submodule
4. git submodule update --remote .achords en cada repo miembro trae la org memory actualizada

No hay sync manual — la org memory viaja con el submodule.

Protocolo de memoria

Los agentes siguen este protocolo:

1. Inicio de sesión — Llamar mem_context para recuperar
2. Lectura obligatoria — .achords/.engram/config.json para contexto de org
3. Durante el trabajo — Llamar mem_save después de decisiones/fixes
4. Fin de sesión — Llamar mem_session_summary

Ver también

• engram — Integración con Engram
• memory-protocol — Protocolo detallado