prr

6 axes obrigatórios (pular um = aprovação inválida):

1. System Architecture — design, dependencies, blast radius, isolation
2. Instrumentation/Metrics/Monitoring — 4 golden signals, SLOs, alerting
3. Emergency Response — runbooks, on-call, rollback, communication
4. Capacity Planning — load testing, scaling, headroom
5. Change Management — canary, feature flags, rollback < 60s
6. Performance — latency budgets, throughput, optimization

Cria/Atualiza:

• .planning/prr/<service>.md (Modo A) OR .planning/prr/feature-<slug>.md (Modo B) — PRR-REPORT.md scored

Após: o user tem decisão Approved / Approved with conditions / Blocked + lista canônica de P0 items por axe + reviewer signature. Phase 40 INT-FW-V2-02 integra /concluir-marco com gate PRR opcional.

Modo A: --service <name> (audit de serviço existente)

Para serviços já em production OU prestes a entrar — agent lê schema (Supabase MCP), Edge Functions code, SLOs definidos (.planning/slos/), advisors. Output: .planning/prr/<service>.md.

Modo B: --feature <description> (audit pré-launch)

Para feature em design/dev — agent lê design docs, SLOs propostos, código WIP. Output: .planning/prr/feature-<slug>.md.

Engagement models (cap 32):

• simple — outage cost < $1k/min OR internal tool — 4-8h, 1 sessão
• early — outage cost $1k-100k/min OR customer-facing — semanas, SRE no design
• platform — outage cost > $100k/min OR built on Frameworks/SRE Platform — PRR é confirmação

Flags:

• --engagement <simple|early|platform> — engagement model (default: AskUserQuestion baseado em outage cost)
• --reviewer <@handle> — handle do reviewer SRE (default: AskUserQuestion — NUNCA pode ser team dev, anti-pattern auto-PRR)
• --outage-cost <usd> — custo de outage por minuto (default: AskUserQuestion para escolher engagement)
• --output <path> — caminho do output (override de default canônico)

Exemplos:

/prr --service orders-api                                          # Modo A — defaults
/prr --service orders-api --engagement early --reviewer @ops-lead  # Modo A com config
/prr --feature "RAG sobre documentos privados" --reviewer @sre     # Modo B
/prr --service edge-process-emails --engagement simple             # Edge Function simples

Pré-requisito (Full mode): projeto Supabase configurado, mcp__supabase__* disponível. Modo offline funciona com fallback graceful (filesystem only — itens MCP-dependentes ficam EVIDENCE_PENDING_MCP).

1. Parsear argumentos (2 modos)

SERVICE=$(echo "$ARGUMENTS" | grep -oE -- '--service [^ ]+' | awk '{print $2}')
FEATURE=$(echo "$ARGUMENTS" | grep -oE -- '--feature "[^"]+"' | sed 's/--feature //; s/^"//; s/"$//')
ENGAGEMENT=$(echo "$ARGUMENTS" | grep -oE -- '--engagement [^ ]+' | awk '{print $2}')
REVIEWER=$(echo "$ARGUMENTS" | grep -oE -- '--reviewer [^ ]+' | awk '{print $2}')
OUTAGE_COST=$(echo "$ARGUMENTS" | grep -oE -- '--outage-cost [^ ]+' | awk '{print $2}')
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')

# PT-BR: validar mutuamente exclusivos
if [ -n "$SERVICE" ] && [ -n "$FEATURE" ]; then
  echo "✗ Erro: --service e --feature são mutuamente exclusivos. Escolha um."
  exit 1
fi

# PT-BR: nenhum dos 2 → erro com sugestão
if [ -z "$SERVICE" ] && [ -z "$FEATURE" ]; then
  echo "✗ Forneça --service <name> OU --feature \"<descrição>\""
  echo "  Exemplos:"
  echo "    /prr --service orders-api"
  echo "    /prr --feature \"RAG sobre documentos privados\""
  exit 1
fi