joao.goncalves
/
minions-ai-agents
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
minions-ai-agents/antigravity_brain_export/processes/git-commit-protocol.md

2.1 KiB
Raw Blame History

description
Protocolo de Finalização e Commit Seguro (Gitkeeper)

🔐 Git Commit Protocol: The Seal

Este workflow é o ato final. Ele transforma o trabalho aprovado em histórico imutável. Só deve ser executado quando o sistema estiver estável e auditado (DONE).

Fase 1: Staging (Preparation)

  1. Status Check:

    • [Terminal] Executar git status.
    • Verificação: Se não houver mudanças ("clean working tree"), abortar. Nada a commitar.

  2. Staging Tático:

    • [Terminal] Executar git add ..
    • Obs: Adicionamos tudo pois o workflow codebase-audit-sync.md já garantiu que só arquivos corretos estão no mapa e pastas indesejadas foram limpas pelo technical-debt-cleanup.md.

Fase 2: The Message (Conventional Commits)

  1. Redação da Mensagem:
    • [Instruction] Analisar o trabalho realizado nas etapas anteriores (Features, Fixes, Docs).
    • [Instruction] Criar uma mensagem de commit seguindo o padrão Conventional Commits (Títulos em Português-BR):
      • feat: [Título em Português] para novas funcionalidades.
      • fix: [Título em Português] para correções de bugs.
      • docs: ... para documentação.
      • refactor: ... para limpeza de código.
      • chore: ... para tarefas do sistema (updates de workflow, etc).
    • Corpo: Adicionar uma lista bullet-point curta do que mudou.

Fase 3: The Preview (Human Gatekeeper)

  1. Solicitação de Aprovação:
    • [Notify] AÇÃO BLOQUEANTE.
    • Exibir a mensagem de commit proposta para o usuário.
    • Perguntar: "Confirma o commit com esta mensagem?"
    • BlockedOnUser: true.

Fase 4: The Seal (Execution)

  1. Commit:
    • Se aprovado (YES):
      • [Tool] Executar: python .agent/tools/auto_commit.py <TYPE> "<Title>" "<Description body>"
      • Dica: O script anexará automaticamente o implementation_plan.md e walkthrough.md caso existam.
      • "O código foi selado com relatório completo."
    • Se rejeitado (NO):
      • [Instruction] Solicitar nova mensagem ou abortar operação.