---
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)

3.  **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)

4.  **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)

5.  **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.