Phase Commit

Phase Commit Skill

Proposito

Esta skill automatiza commits ao final de cada fase do SDLC, garantindo:

1. Rastreabilidade - Cada fase tem seu commit identificavel
2. Checkpoint - Facilita rollback para estado conhecido
3. Revisao - Artefatos separados por fase facilitam code review
4. Historico - Git history reflete o progresso do SDLC

Quando Usar

Esta skill deve ser chamada:

1. Ao passar um quality gate com sucesso
2. Ao finalizar uma fase manualmente
3. Quando o orchestrator detecta transicao de fase

Formato de Commit

<type>(phase-<N>): <descricao curta>

Fase: <nome da fase>
Projeto: <id do projeto>
Artefatos criados:
- <lista de arquivos>

Co-Authored-By: Claude <noreply@anthropic.com>

Tipos por Fase

Processo

phase_commit_process:
  1_identify_phase:
    - Usar path_resolver para obter PROJECT_DIR
    - Ler ${PROJECT_DIR}/projects/*/manifest.yml
    - Identificar fase atual
    - Identificar projeto

  2_collect_artifacts:
    - Listar arquivos criados/modificados na fase
    - Filtrar por patterns relevantes
    - Agrupar por tipo

  3_stage_files:
    - git add dos arquivos identificados
    - Verificar se ha algo para commitar

  4_create_commit:
    - Gerar mensagem seguindo formato
    - Incluir lista de artefatos
    - Executar commit

  5_update_state:
    - Atualizar timestamp no manifest
    - Registrar commit hash no contexto da fase
    - Notificar usuario

Artefatos por Fase

Fase 0 - Preparation

.agentic_sdlc/intake/**
.agentic_sdlc/projects/*/manifest.yml
.project/corpus/decisions/compliance-*.yml

Fase 1 - Discovery

.project/corpus/research/**
.project/corpus/docs/**
.project/references/**

Fase 2 - Requirements

.agentic_sdlc/projects/*/specs/**
.agentic_sdlc/projects/*/requirements/**
*.spec.md

Fase 3 - Architecture

.agentic_sdlc/projects/*/decisions/adr-*.yml
.agentic_sdlc/projects/*/security/threat-model*.yml
.project/corpus/decisions/**
docs/architecture/**

Fase 4 - Planning

.agentic_sdlc/projects/*/planning/**
.github/ISSUE_TEMPLATE/**

Fase 5 - Implementation

src/**
lib/**
app/**
tests/**

Fase 6 - Quality

.agentic_sdlc/projects/*/security/sast-*.yml
.agentic_sdlc/projects/*/security/sca-*.yml
tests/**

Fase 7 - Release

CHANGELOG.md
docs/**
.github/workflows/**

Fase 8 - Operations

.agentic_sdlc/projects/*/ops/**
docs/runbooks/**

Script de Commit

#!/bin/bash
# phase-commit.sh
# Commita artefatos da fase atual

set -e

PROJECT_ID="${1:-}"
PHASE="${2:-}"
MESSAGE="${3:-}"

# Obter fase atual se nao especificada
if [ -z "$PHASE" ]; then
  PROJECT_DIR=$(python3 .claude/lib/python/path_resolver.py --project-dir)
  MANIFEST="${PROJECT_DIR}/projects/${PROJECT_ID}/manifest.yml"
  if [ -f "$MANIFEST" ]; then
    PHASE=$(grep "current_phase:" "$MANIFEST" | awk '{print $2}')
  fi
fi

if [ -z "$PHASE" ]; then
  echo "Erro: Nao foi possivel determinar a fase atual"
  exit 1
fi

# Mapear tipo de commit
case $PHASE in
  0|1|4|8) TYPE="docs" ;;
  2|3|5)   TYPE="feat" ;;
  6)       TYPE="test" ;;
  7)       TYPE="chore" ;;
  *)       TYPE="chore" ;;
esac

# Nomes das fases
PHASE_NAMES=(
  "Preparation"
  "Discovery"
  "Requirements"
  "Architecture"
  "Planning"
  "Implementation"
  "Quality"
  "Release"
  "Operations"
)

PHASE_NAME="${PHASE_NAMES[$PHASE]}"

# Verificar se ha mudancas
if git diff --cached --quiet && git diff --quiet; then
  echo "Nenhuma mudanca para commitar na fase ${PHASE} (${PHASE_NAME})"
  exit 0
fi

# Adicionar arquivos nao rastreados
git add -A

# Gerar lista de arquivos
FILES=$(git diff --cached --name-only | head -20)
FILE_COUNT=$(git diff --cached --name-only | wc -l)

# Mensagem de commit
if [ -z "$MESSAGE" ]; then
  MESSAGE="artefatos da fase ${PHASE_NAME}"
fi

# Criar commit
git commit -m "$(cat <<EOF
${TYPE}(phase-${PHASE}): ${MESSAGE}

Fase: ${PHASE_NAME}
Projeto: ${PROJECT_ID}
Arquivos: ${FILE_COUNT}

Artefatos:
${FILES}

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

echo ""
echo "============================================"
echo "  Commit da Fase ${PHASE} Criado"
echo "============================================"
echo "Fase: ${PHASE_NAME}"
echo "Arquivos: ${FILE_COUNT}"
echo ""

Integracao com Orchestrator

O orchestrator deve chamar esta skill:

post_gate_actions:
  - condition: gate_passed == true
    action: call_skill("phase-commit")
    params:
      project_id: current_project.id
      phase: current_phase
      message: "completar fase ${phase_name}"

Integracao com Gate Evaluator

Adicionar ao gate-evaluator:

on_gate_pass:
  actions:
    - type: suggest_commit
      message: "Fase ${phase} completada. Sugerido commitar artefatos."
    - type: call_skill
      skill: phase-commit
      auto: false  # Pedir confirmacao primeiro

Checklist

Antes do Commit

• Verificar se ha arquivos para commitar
• Confirmar fase atual
• Revisar lista de artefatos

Apos o Commit

• Atualizar manifest com commit hash
• Notificar usuario
• Sugerir push se branch remota existe

Notas

• ✅ Esta skill FAZ COMMIT E PUSH automaticamente (v1.7.15+)
• ✅ Push detecta se branch tem upstream e configura automaticamente
• ✅ Logs estruturados com Loki (skill="phase-commit")
• ✅ Atualiza manifest.yml com commit hash e timestamp
• ⚠️ Se push falhar, o commit local é mantido e erro é reportado
• Commits podem ser agrupados se varias fases forem completadas rapidamente