Project Guardian - Delegación de código barato

Project Guardian

Usa esta habilidad en los límites del proyecto:

• Al iniciar un proyecto.
• Al reanudar después de pérdida de contexto o un nuevo hilo.
• Antes de ediciones importantes.
• Después de modificaciones de archivos.
• Después de que un trabajador barato haya generado un parche.
• Al finalizar una sesión de trabajo.
• Más de 30 minutos después del último punto de control de memoria.

Responsabilidades principales

• Mantener la memoria del proyecto en .ai/memory/.
• Mantener el estado legible por máquina en .ai/state.json.
• Hacer cumplir la disciplina de git: inicializar, preparar y confirmar automáticamente. No solo mencionar git, sino ejecutarlo.
• Preservar la seguridad de las ramas.
• Resumir los archivos modificados.
• Nunca hacer push, reset, clean, deploy ni ejecutar comandos destructivos automáticamente.

Iniciar o reanudar

1. Verificar si existe .ai/state.json.
2. Leer los archivos de .ai/memory/ si existen.
3. Verificar git status --short --branch.
4. Si no es un repositorio git, ejecutar git init automáticamente.
5. Si está en main o master, sugerir al usuario una rama ai/<tarea>, pero no crearla sin confirmación.
6. Producir un resumen conciso de reanudación antes de realizar nuevo trabajo.

Ayudante:

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh resume

Inicializar memoria

Usa el ayudante cuando un proyecto no tenga memoria:

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh init --task "..."

El ayudante crea:

• .ai/state.json
• .ai/memory/PROJECT_MEMORY.md
• .ai/memory/SESSION_LOG.md
• .ai/memory/CHECKPOINTS.md
• .ai/memory/DECISIONS.md
• .ai/memory/TODO.md
• .ai/memory/PAPER_CONTEXT.md

También ejecuta git init si el directorio no es ya un repositorio git.

Después de ediciones

1. Ejecutar git status y un resumen de diff.
2. Resumir los archivos modificados.
3. Si es útil, usar cheap-code-delegate para un borrador de punto de control de bajo costo.
4. Escribir un punto de control de memoria automáticamente.
5. Ejecutar git add -A y git commit -m "checkpoint: <resumen>" automáticamente.
6. No hacer push a menos que el usuario lo pida explícitamente o pases --push.

Ayudante:

# Auto-confirmar localmente
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..."

# Auto-confirmar y hacer push (requiere intención explícita)
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

Proyectos de tipo paper

Si el proyecto es un paper o tesis:

• Mantener .ai/memory/PAPER_CONTEXT.md.
• Rastrear resumen, introducción, trabajo relacionado, método, experimentos, limitaciones, conclusión, referencias, figuras, tablas y ecuaciones.
• Después de ediciones, recordar al usuario verificar la consistencia entre secciones, citas y numeración.

Acciones automáticas

Ejecutar automáticamente:

• git init cuando el directorio no sea un repositorio git.
• git add -A al hacer punto de control.
• git commit al hacer punto de control.
• Escribir puntos de control en .ai/memory.

Requieren confirmación explícita del usuario

No ejecutar automáticamente:

• git push
• git reset
• git clean
• checkout destructivo
• rm -rf
• despliegue
• comandos de producción
• crear ramas distintas a la sugerida automáticamente ai/<tarea>

Referencias

Cargar solo cuando sea necesario:

• references/memory-schema.md: responsabilidades del archivo .ai/.
• references/git-safety.md: flujo de trabajo seguro con git.
• references/paper-projects.md: guía de memoria para papers.