49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
---
|
|
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.
|