instrumentar-fase

Cria/Atualiza:

• .planning/phases/<N>/<padded>-PLAN-<NN>-INSTRUMENTATION.md por plano

Após: o user tem o contrato de instrumentação que o executor (e o observability-instrumenter) devem cumprir durante /executar-fase.

Pré-requisito: /planejar-fase <N> já rodou. Existem <padded>-PLAN-<NN>-*.md em .planning/phases/<N>/.

Skill consultada: observability-driven-development — 4 perguntas pré-PR canônicas.

1. Parsear argumentos

PHASE_NUM=$(echo "$ARGUMENTS" | awk '{print $1}')
PLAN_NUM=$(echo "$ARGUMENTS" | awk '{print $2}')

if [ -z "$PHASE_NUM" ]; then
  echo "Uso: /instrumentar-fase <N> [<NN>]"
  echo "Ex.: /instrumentar-fase 30        # todos os planos da Phase 30"
  echo "Ex.: /instrumentar-fase 30 01     # só Plano 01 da Phase 30"
  exit 1
fi

2. Detectar phase_dir + planos

PHASE_STATE=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$PHASE_NUM")
PHASE_DIR=$(echo "$PHASE_STATE" | jq -r .phase_dir)

if [ "$PHASE_DIR" = "null" ] || [ ! -d "$PHASE_DIR" ]; then
  echo "Fase $PHASE_NUM ainda não foi planejada. Rode /planejar-fase $PHASE_NUM primeiro."
  exit 1
fi

# PT-BR: descobrir PLAN.md(s) — exclui já-instrumentados
if [ -n "$PLAN_NUM" ]; then
  PLANS=("$PHASE_DIR"/*-PLAN-${PLAN_NUM}-*.md)
else
  PLANS=("$PHASE_DIR"/*-PLAN-*.md)
fi

3. Para cada plano, gerar INSTRUMENTATION.md

Para cada PLAN_FILE:

PADDED=$(basename "$PLAN_FILE" | grep -oE '^[0-9]+')
NN=$(basename "$PLAN_FILE" | grep -oE 'PLAN-[0-9]+' | grep -oE '[0-9]+')
OUT_FILE="$PHASE_DIR/${PADDED}-PLAN-${NN}-INSTRUMENTATION.md"

# PT-BR: não sobrescrever se já existe
if [ -f "$OUT_FILE" ]; then
  echo "Já existe: $OUT_FILE — pulando"
  continue
fi