Flujo de trabajo en equipo con Git

Git lleva la memoria entre máquinas y proporciona un historial de revisión. Engram es nativo de Git: la memoria es Markdown simple, por lo que se aplica el flujo de trabajo normal de Git.

Memoria del espacio de trabajo como submódulo

Si el humano desea que .agents/.engram sea rastreado como un repositorio separado:

engram inject --submodule
engram inject --submodule-remote <git-url>

Engram valida la URL, inicializa el submódulo en main y crea la primera confirmación (commit) del submódulo como Initialize engram.

Origen Git global compartido

Si engram entry no muestra global_git_detected.remote_url, pregunte al humano si la memoria global debe compartirse a través de Git. Cuando proporcionen una URL:

engram inject --global-remote <git-url>

Configure el comportamiento de sincronización con los campos global_git.*:

• global_git.enabled — habilita el comportamiento de Git para la memoria global
• global_git.remote — nombre del control remoto (por defecto origin)
• global_git.remote_url — URL remota de memoria global compartida
• global_git.branch — rama de destino (por defecto main)
• global_git.auto_sync — comportamiento automático de pull/push
• global_git.auto_resolve — manejo automático de conflictos

aviso

El manejo automático de conflictos puede ocultar los diffs de memoria. Revise los diffs de memoria antes de confiar en global_git.auto_resolve.

Flujo de trabajo de revisión

1. El agente propone candidatos de memoria.
2. El humano aprueba a través de la puerta A/B/C (terminal) o yes/audit/cancel (chat).
3. Engram escribe el Markdown aprobado y actualiza los hashes, el índice, el grafo y el historial de cambios.
4. Confirme (commit) y envíe (push) el cambio de memoria a través de Git.
5. Los compañeros de equipo realizan pull y ejecutan engram upgrade para conciliar.

Siguientes pasos

• Proceso de publicación y actualización
• Conceptos: ruta de escritura y aprobación

Identidad de autor de Git

Engram puede almacenar un autor global y una anulación opcional por workspace. La resolución es workspace, global y, por último, un respaldo de Git de solo lectura. Los ajustes afectan solo a memorias futuras; una anulación de workspace nunca cambia la configuración global de Git. Use plan y confirmación explícitos para la sincronización con Git global o la migración de memorias heredadas.

engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm

Lea la guía completa de ajustes del autor de Git.