Project Guardian – Delegado de Código Barato e Econômico

Project Guardian

Use esta habilidade nos limites do projeto:

• Iniciando um projeto.
• Retomando após perda de contexto ou uma nova thread.
• Antes de edições importantes.
• Após modificações de arquivos.
• Depois que um trabalhador barato produziu um patch.
• Finalizando uma sessão de trabalho.
• Mais de 30 minutos desde o último checkpoint de memória.

Responsabilidades Principais

• Manter a memória do projeto em .ai/memory/.
• Manter o estado legível por máquina em .ai/state.json.
• Impor disciplina git: inicializar, stage e commit automaticamente. Não apenas mencione o git — execute-o.
• Preservar a segurança de branches.
• Resumir arquivos alterados.
• Nunca fazer push, reset, clean, deploy ou executar comandos destrutivos automaticamente.

Iniciar ou Retomar

1. Verificar se .ai/state.json existe.
2. Ler arquivos de .ai/memory/ se existirem.
3. Verificar git status --short --branch.
4. Se não for um repositório git, executar git init automaticamente.
5. Se estiver em main ou master, sugerir ao usuário um branch ai/<task>, mas não criá-lo sem confirmação.
6. Produzir um resumo conciso antes de realizar novo trabalho.

Auxiliar:

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

Inicializar Memória

Use o auxiliar quando o projeto não tiver memória:

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

O auxiliar cria:

• .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

Ele também executa git init se o diretório ainda não for um repositório git.

Após Edições

1. Executar git status e um resumo de diff.
2. Resumir arquivos alterados.
3. Se útil, usar cheap-code-delegate para um rascunho de checkpoint de baixo custo.
4. Escrever um checkpoint de memória automaticamente.
5. Executar git add -A e git commit -m "checkpoint: <summary>" automaticamente.
6. Não fazer push a menos que o usuário peça explicitamente ou você passe --push.

Auxiliar:

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

# Auto-commit e push (requer intenção explícita)
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

Projetos de Artigo

Se o projeto for um artigo ou tese:

• Manter .ai/memory/PAPER_CONTEXT.md.
• Rastrear resumo, introdução, trabalho relacionado, método, experimentos, limitações, conclusão, referências, figuras, tabelas e equações.
• Após edições, lembrar o usuário de verificar consistência entre seções, citações e numeração.

Ações Automáticas

Executar automaticamente:

• git init quando o diretório não for um repositório git.
• git add -A ao fazer checkpoint.
• git commit ao fazer checkpoint.
• Escrever checkpoints em .ai/memory.

Exigir Confirmação Explícita do Usuário

Não executar automaticamente:

• git push
• git reset
• git clean
• checkout destrutivo
• rm -rf
• deploy
• comandos de produção
• criar branches diferentes do branch ai/<task> sugerido automaticamente

Referências

Carregar apenas quando necessário:

• references/memory-schema.md: responsabilidades do arquivo .ai/.
• references/git-safety.md: fluxo de trabalho git seguro.
• references/paper-projects.md: orientação de memória para artigos.