@luanpdd/kit-mcp 1.34.0 → 1.36.0

package/gates/postmortem-template-required.md

@@ -1,127 +1,127 @@
----
-id: postmortem-template-required
-stage: pre-conclude
-blocking: true
-description: Bloqueia /concluir-marco se há investigação em .planning/investigations/ sem postmortem correspondente em .planning/postmortems/. "No postmortem left unreviewed" (cap 15).
----
-
-# Postmortem template required gate
-
-**When to run:** pre-conclude (blocking — milestone NÃO arquiva até cada incident ter postmortem blameless).
-
-## Check
-
-```bash
-#!/usr/bin/env bash
-# PT-BR: validar que cada investigação em .planning/investigations/ tem postmortem em .planning/postmortems/.
-# Match por basename (sem extensão .md). Investigations com Status: INCONCLUSIVE são exceção.
-# Bash 3.2-portable (macOS default).
-set -e
-
-INV_DIR=".planning/investigations"
-PM_DIR=".planning/postmortems"
-
-# PT-BR: se não há investigations, gate passa com INFO
-if [ ! -d "$INV_DIR" ]; then
-  echo "INFO: $INV_DIR não existe — projeto sem incidents registrados. Gate skipped."
-  exit 0
-fi
-
-# PT-BR: listar investigations (single-file *.md OR subdir com STATE.md)
-INVESTIGATIONS=""
-
-# PT-BR: pattern A — .planning/investigations/<id>.md (single file)
-SINGLE_FILES=$(find "$INV_DIR" -maxdepth 1 -type f -name "*.md" 2>/dev/null || true)
-if [ -n "$SINGLE_FILES" ]; then
-  INVESTIGATIONS="$INVESTIGATIONS
-$SINGLE_FILES"
-fi
-
-# PT-BR: pattern B — .planning/investigations/<id>/STATE.md (subdir state)
-SUBDIR_STATES=$(find "$INV_DIR" -mindepth 2 -maxdepth 2 -type f -name "STATE.md" 2>/dev/null || true)
-if [ -n "$SUBDIR_STATES" ]; then
-  INVESTIGATIONS="$INVESTIGATIONS
-$SUBDIR_STATES"
-fi
-
-# PT-BR: filtrar linhas vazias
-INVESTIGATIONS=$(echo "$INVESTIGATIONS" | grep -v "^$" || true)
-
-if [ -z "$INVESTIGATIONS" ]; then
-  echo "INFO: $INV_DIR vazio — sem incidents registrados. Gate skipped."
-  exit 0
-fi
-
-# PT-BR: para cada investigation, extrair <id> e checar postmortem correspondente
-MISSING=0
-MISSING_LIST=""
-OLDIFS="$IFS"
-IFS='
-'
-for inv_path in $INVESTIGATIONS; do
-  [ -z "$inv_path" ] && continue
-  [ ! -f "$inv_path" ] && continue
-
-  # PT-BR: extrair <id> — basename sem .md OU dirname se for STATE.md em subdir
-  base=$(basename "$inv_path")
-  if [ "$base" = "STATE.md" ]; then
-    # pattern B — id é o nome do subdir parent
-    id=$(basename "$(dirname "$inv_path")")
-  else
-    # pattern A — id é basename sem .md
-    id="${base%.md}"
-  fi
-
-  # PT-BR: se investigation tem Status: INCONCLUSIVE (sem root cause), pular
-  if grep -qiE "^Status:.*INCONCLUSIVE|^.*Status.*INCONCLUSIVE" "$inv_path" 2>/dev/null; then
-    echo "INFO: investigation '$id' marcada INCONCLUSIVE — sem root cause, postmortem não exigido."
-    continue
-  fi
-
-  # PT-BR: postmortem esperado em .planning/postmortems/<id>.md
-  pm_path="$PM_DIR/$id.md"
-  if [ ! -f "$pm_path" ]; then
-    MISSING=$((MISSING + 1))
-    MISSING_LIST="$MISSING_LIST $id"
-  fi
-done
-IFS="$OLDIFS"
-
-if [ "$MISSING" -eq 0 ]; then
-  echo "PASS: todas as investigações têm postmortem correspondente em $PM_DIR/"
-  exit 0
-else
-  echo "FAIL: $MISSING investigação(ões) sem postmortem em $PM_DIR/:$MISSING_LIST"
-  echo "Sugestão: rodar /postmortem --from-investigation <id> para cada item ausente."
-  echo "Cross-ref: kit/skills/blameless-postmortems/SKILL.md + kit/agents/postmortem-writer.md"
-  echo "Princípio canônico: 'No postmortem left unreviewed' (cap 15 livro Google SRE)."
-  exit 1
-fi
-```
-
-## Verdict
-
-- **passed** — todas investigations têm postmortem correspondente OR investigations marcadas INCONCLUSIVE OR diretório `.planning/investigations/` ausente
-- **block** — pelo menos 1 investigation sem postmortem em `.planning/postmortems/`
-
-## Why
-
-O livro Google SRE (cap 15 — *Postmortem Culture: Learning from Failure*) define como princípio canônico **"no postmortem left unreviewed"**: cada incident significativo (registrado como investigação via `/forense` + `incident-investigator` v1.9) deve gerar postmortem blameless documentando *o que aprendemos* e *o que mudaremos*.
-
-Sem este gate, milestones arquivam com investigations órfãs — root cause foi diagnosticado mas aprendizado organizacional perdeu-se (anti-pattern hero culture: "fixei o bug, vamos seguir"). Gate força a chain canônica entre v1.9 (Core Analysis Loop diagnostica) e v1.10 (postmortem documenta).
-
-Cross-ref agent canônico: [`postmortem-writer`](../kit/agents/postmortem-writer.md) (Phase 37 / AGCORE-SRE-03). Skill: [`blameless-postmortems`](../kit/skills/blameless-postmortems/SKILL.md) (Phase 36 / SKFD-SRE-04). Comando: `/postmortem --from-investigation <id>` (Phase 38 / CMD-SRE-03). Chain documentado em `kit/commands/forense.md` bloco `<sre_integration>` (Plan 40-01 / INT-FW-V2-01).
-
-## REQ
-
-QA-SRE-02.
-
-## Configuração
-
-Gate é **blocking** por default (cultura SRE blameless é não-negociável uma vez instituída). Para tornar warn-only durante adoption inicial:
-
-```bash
-node ./.claude/framework/bin/tools.cjs config-set workflow.postmortem_required_warn true
-```
-
-(Nota: implementação do toggle warn-only é deferida — gate atual lê apenas presença/ausência de pares investigation↔postmortem, não consulta config.)
+---
+id: postmortem-template-required
+stage: pre-conclude
+blocking: true
+description: Bloqueia /concluir-marco se há investigação em .planning/investigations/ sem postmortem correspondente em .planning/postmortems/. "No postmortem left unreviewed" (cap 15).
+---
+
+# Postmortem template required gate
+
+**When to run:** pre-conclude (blocking — milestone NÃO arquiva até cada incident ter postmortem blameless).
+
+## Check
+
+```bash
+#!/usr/bin/env bash
+# PT-BR: validar que cada investigação em .planning/investigations/ tem postmortem em .planning/postmortems/.
+# Match por basename (sem extensão .md). Investigations com Status: INCONCLUSIVE são exceção.
+# Bash 3.2-portable (macOS default).
+set -e
+
+INV_DIR=".planning/investigations"
+PM_DIR=".planning/postmortems"
+
+# PT-BR: se não há investigations, gate passa com INFO
+if [ ! -d "$INV_DIR" ]; then
+  echo "INFO: $INV_DIR não existe — projeto sem incidents registrados. Gate skipped."
+  exit 0
+fi
+
+# PT-BR: listar investigations (single-file *.md OR subdir com STATE.md)
+INVESTIGATIONS=""
+
+# PT-BR: pattern A — .planning/investigations/<id>.md (single file)
+SINGLE_FILES=$(find "$INV_DIR" -maxdepth 1 -type f -name "*.md" 2>/dev/null || true)
+if [ -n "$SINGLE_FILES" ]; then
+  INVESTIGATIONS="$INVESTIGATIONS
+$SINGLE_FILES"
+fi
+
+# PT-BR: pattern B — .planning/investigations/<id>/STATE.md (subdir state)
+SUBDIR_STATES=$(find "$INV_DIR" -mindepth 2 -maxdepth 2 -type f -name "STATE.md" 2>/dev/null || true)
+if [ -n "$SUBDIR_STATES" ]; then
+  INVESTIGATIONS="$INVESTIGATIONS
+$SUBDIR_STATES"
+fi
+
+# PT-BR: filtrar linhas vazias
+INVESTIGATIONS=$(echo "$INVESTIGATIONS" | grep -v "^$" || true)
+
+if [ -z "$INVESTIGATIONS" ]; then
+  echo "INFO: $INV_DIR vazio — sem incidents registrados. Gate skipped."
+  exit 0
+fi
+
+# PT-BR: para cada investigation, extrair <id> e checar postmortem correspondente
+MISSING=0
+MISSING_LIST=""
+OLDIFS="$IFS"
+IFS='
+'
+for inv_path in $INVESTIGATIONS; do
+  [ -z "$inv_path" ] && continue
+  [ ! -f "$inv_path" ] && continue
+
+  # PT-BR: extrair <id> — basename sem .md OU dirname se for STATE.md em subdir
+  base=$(basename "$inv_path")
+  if [ "$base" = "STATE.md" ]; then
+    # pattern B — id é o nome do subdir parent
+    id=$(basename "$(dirname "$inv_path")")
+  else
+    # pattern A — id é basename sem .md
+    id="${base%.md}"
+  fi
+
+  # PT-BR: se investigation tem Status: INCONCLUSIVE (sem root cause), pular
+  if grep -qiE "^Status:.*INCONCLUSIVE|^.*Status.*INCONCLUSIVE" "$inv_path" 2>/dev/null; then
+    echo "INFO: investigation '$id' marcada INCONCLUSIVE — sem root cause, postmortem não exigido."
+    continue
+  fi
+
+  # PT-BR: postmortem esperado em .planning/postmortems/<id>.md
+  pm_path="$PM_DIR/$id.md"
+  if [ ! -f "$pm_path" ]; then
+    MISSING=$((MISSING + 1))
+    MISSING_LIST="$MISSING_LIST $id"
+  fi
+done
+IFS="$OLDIFS"
+
+if [ "$MISSING" -eq 0 ]; then
+  echo "PASS: todas as investigações têm postmortem correspondente em $PM_DIR/"
+  exit 0
+else
+  echo "FAIL: $MISSING investigação(ões) sem postmortem em $PM_DIR/:$MISSING_LIST"
+  echo "Sugestão: rodar /postmortem --from-investigation <id> para cada item ausente."
+  echo "Cross-ref: kit/skills/blameless-postmortems/SKILL.md + kit/agents/postmortem-writer.md"
+  echo "Princípio canônico: 'No postmortem left unreviewed' (cap 15 livro Google SRE)."
+  exit 1
+fi
+```
+
+## Verdict
+
+- **passed** — todas investigations têm postmortem correspondente OR investigations marcadas INCONCLUSIVE OR diretório `.planning/investigations/` ausente
+- **block** — pelo menos 1 investigation sem postmortem em `.planning/postmortems/`
+
+## Why
+
+O livro Google SRE (cap 15 — *Postmortem Culture: Learning from Failure*) define como princípio canônico **"no postmortem left unreviewed"**: cada incident significativo (registrado como investigação via `/forense` + `incident-investigator` v1.9) deve gerar postmortem blameless documentando *o que aprendemos* e *o que mudaremos*.
+
+Sem este gate, milestones arquivam com investigations órfãs — root cause foi diagnosticado mas aprendizado organizacional perdeu-se (anti-pattern hero culture: "fixei o bug, vamos seguir"). Gate força a chain canônica entre v1.9 (Core Analysis Loop diagnostica) e v1.10 (postmortem documenta).
+
+Cross-ref agent canônico: [`postmortem-writer`](../kit/agents/postmortem-writer.md) (Phase 37 / AGCORE-SRE-03). Skill: [`blameless-postmortems`](../kit/skills/blameless-postmortems/SKILL.md) (Phase 36 / SKFD-SRE-04). Comando: `/postmortem --from-investigation <id>` (Phase 38 / CMD-SRE-03). Chain documentado em `kit/commands/forense.md` bloco `<sre_integration>` (Plan 40-01 / INT-FW-V2-01).
+
+## REQ
+
+QA-SRE-02.
+
+## Configuração
+
+Gate é **blocking** por default (cultura SRE blameless é não-negociável uma vez instituída). Para tornar warn-only durante adoption inicial:
+
+```bash
+node ./.claude/framework/bin/tools.cjs config-set workflow.postmortem_required_warn true
+```
+
+(Nota: implementação do toggle warn-only é deferida — gate atual lê apenas presença/ausência de pares investigation↔postmortem, não consulta config.)

package/gates/prr-checklist-coverage.md

@@ -1,128 +1,128 @@
----
-id: prr-checklist-coverage
-stage: pre-verify
-blocking: true
-description: Valida que cada PRR-REPORT.md em .planning/prr/ cobre os 6 axes canonicos (System Architecture/Instrumentation/Emergency/Capacity/Change/Performance — cap 32 livro Google SRE).
----
-
-# PRR checklist coverage gate
-
-**When to run:** pre-verify (blocking — PRR sem 6 axes = aprovação inválida).
-
-## Check
-
-```bash
-#!/usr/bin/env bash
-# PT-BR: validar que cada PRR-REPORT.md em .planning/prr/**/*.md cobre os 6 axes do PRR.
-# Match por palavra-chave em heading H2 (case-insensitive). Pular um axe = aprovação inválida.
-# Bash 3.2-portable (macOS default).
-set -e
-
-PRR_DIR=".planning/prr"
-
-# PT-BR: se não há PRR reports, gate passa com INFO
-if [ ! -d "$PRR_DIR" ]; then
-  echo "INFO: $PRR_DIR não existe — projeto sem PRR reports. Gate skipped."
-  exit 0
-fi
-
-# PT-BR: listar todos os *.md em .planning/prr/ recursivamente
-PRR_FILES=$(find "$PRR_DIR" -type f -name "*.md" 2>/dev/null || true)
-PRR_FILES=$(echo "$PRR_FILES" | grep -v "^$" || true)
-
-if [ -z "$PRR_FILES" ]; then
-  echo "INFO: $PRR_DIR vazio — sem PRR reports. Gate skipped."
-  exit 0
-fi
-
-# PT-BR: para cada PRR report, validar que cobre os 6 axes
-VIOLATIONS=0
-OLDIFS="$IFS"
-IFS='
-'
-for prr_file in $PRR_FILES; do
-  [ -z "$prr_file" ] && continue
-  [ ! -f "$prr_file" ] && continue
-
-  # PT-BR: extrair headings H2 (case-insensitive)
-  H2=$(grep -E "^## " "$prr_file" 2>/dev/null || true)
-
-  # PT-BR: 6 axes — match em palavras-chave (qualquer variante aceitável)
-  AXE_MISSING=""
-
-  # Axe 1: System Architecture
-  if ! echo "$H2" | grep -qiE "system.*architecture|architecture"; then
-    AXE_MISSING="$AXE_MISSING Axe1(SystemArchitecture)"
-  fi
-
-  # Axe 2: Instrumentation / Metrics / Monitoring
-  if ! echo "$H2" | grep -qiE "instrumentation|metrics|monitoring"; then
-    AXE_MISSING="$AXE_MISSING Axe2(Instrumentation)"
-  fi
-
-  # Axe 3: Emergency Response
-  if ! echo "$H2" | grep -qiE "emergency.*response|emergency"; then
-    AXE_MISSING="$AXE_MISSING Axe3(EmergencyResponse)"
-  fi
-
-  # Axe 4: Capacity Planning
-  if ! echo "$H2" | grep -qiE "capacity.*planning|capacity"; then
-    AXE_MISSING="$AXE_MISSING Axe4(CapacityPlanning)"
-  fi
-
-  # Axe 5: Change Management
-  if ! echo "$H2" | grep -qiE "change.*management|change"; then
-    AXE_MISSING="$AXE_MISSING Axe5(ChangeManagement)"
-  fi
-
-  # Axe 6: Performance
-  if ! echo "$H2" | grep -qiE "performance"; then
-    AXE_MISSING="$AXE_MISSING Axe6(Performance)"
-  fi
-
-  if [ -n "$AXE_MISSING" ]; then
-    echo "FAIL: $prr_file — axes ausentes:$AXE_MISSING"
-    VIOLATIONS=$((VIOLATIONS + 1))
-  fi
-done
-IFS="$OLDIFS"
-
-if [ "$VIOLATIONS" -eq 0 ]; then
-  total=$(echo "$PRR_FILES" | wc -l | tr -d ' ')
-  echo "PASS: $total PRR-REPORT(s) cobrem os 6 axes canônicos"
-  exit 0
-else
-  echo "FAIL: $VIOLATIONS PRR-REPORT(s) com axes ausentes"
-  echo "Sugestão: rodar /sre prr <service> ou /prr para regenerar com template canônico (6 axes obrigatórios)."
-  echo "Cross-ref: kit/skills/production-readiness-review/SKILL.md + kit/agents/prr-conductor.md"
-  echo "Princípio canônico: 'Pular um axe = aprovação inválida' (cap 32 livro Google SRE)."
-  exit 1
-fi
-```
-
-## Verdict
-
-- **passed** — cada PRR-REPORT.md em `.planning/prr/**/*.md` tem H2 cobrindo os 6 axes (System Architecture / Instrumentation / Emergency Response / Capacity Planning / Change Management / Performance) OR diretório `.planning/prr/` ausente
-- **block** — pelo menos 1 PRR-REPORT.md com axe(s) ausente(s)
-
-## Why
-
-O livro Google SRE (cap 32 — *Evolving SRE Engagement Model*) define **6 axes canônicos** do Production Readiness Review. A skill `production-readiness-review` (Phase 36 / SKFD-SRE-05) declara como regra absoluta: *"Pular um axe = aprovação inválida (lacuna oculta vira incident em 6 meses)"*.
-
-Sem este gate, PRRs apressados podem omitir axes "menos relevantes" (anti-pattern documentado na skill); gaps em Change Management ou Capacity Planning não detectados em PRR viram incidents em produção meses depois. Gate força padrão canônico — cada `PRR-REPORT.md` cobrindo os 6 axes integralmente, mesmo que items dentro de um axe sejam N/A para o serviço (justificativa explícita no item, não no axe).
-
-Cross-ref agent canônico: [`prr-conductor`](../kit/agents/prr-conductor.md) (Phase 37 / AGCORE-SRE-04). Skill: [`production-readiness-review`](../kit/skills/production-readiness-review/SKILL.md) (Phase 36 / SKFD-SRE-05). Comando: `/prr --service <name>` ou `/prr --feature <description>` (Phase 38 / CMD-SRE-04).
-
-## REQ
-
-QA-SRE-03.
-
-## Configuração
-
-Gate é **blocking** por default. Para tornar warn-only durante adoption inicial:
-
-```bash
-node ./.claude/framework/bin/tools.cjs config-set workflow.prr_checklist_coverage_warn true
-```
-
-(Nota: implementação do toggle warn-only é deferida — gate atual não consulta config.)
+---
+id: prr-checklist-coverage
+stage: pre-verify
+blocking: true
+description: Valida que cada PRR-REPORT.md em .planning/prr/ cobre os 6 axes canonicos (System Architecture/Instrumentation/Emergency/Capacity/Change/Performance — cap 32 livro Google SRE).
+---
+
+# PRR checklist coverage gate
+
+**When to run:** pre-verify (blocking — PRR sem 6 axes = aprovação inválida).
+
+## Check
+
+```bash
+#!/usr/bin/env bash
+# PT-BR: validar que cada PRR-REPORT.md em .planning/prr/**/*.md cobre os 6 axes do PRR.
+# Match por palavra-chave em heading H2 (case-insensitive). Pular um axe = aprovação inválida.
+# Bash 3.2-portable (macOS default).
+set -e
+
+PRR_DIR=".planning/prr"
+
+# PT-BR: se não há PRR reports, gate passa com INFO
+if [ ! -d "$PRR_DIR" ]; then
+  echo "INFO: $PRR_DIR não existe — projeto sem PRR reports. Gate skipped."
+  exit 0
+fi
+
+# PT-BR: listar todos os *.md em .planning/prr/ recursivamente
+PRR_FILES=$(find "$PRR_DIR" -type f -name "*.md" 2>/dev/null || true)
+PRR_FILES=$(echo "$PRR_FILES" | grep -v "^$" || true)
+
+if [ -z "$PRR_FILES" ]; then
+  echo "INFO: $PRR_DIR vazio — sem PRR reports. Gate skipped."
+  exit 0
+fi
+
+# PT-BR: para cada PRR report, validar que cobre os 6 axes
+VIOLATIONS=0
+OLDIFS="$IFS"
+IFS='
+'
+for prr_file in $PRR_FILES; do
+  [ -z "$prr_file" ] && continue
+  [ ! -f "$prr_file" ] && continue
+
+  # PT-BR: extrair headings H2 (case-insensitive)
+  H2=$(grep -E "^## " "$prr_file" 2>/dev/null || true)
+
+  # PT-BR: 6 axes — match em palavras-chave (qualquer variante aceitável)
+  AXE_MISSING=""
+
+  # Axe 1: System Architecture
+  if ! echo "$H2" | grep -qiE "system.*architecture|architecture"; then
+    AXE_MISSING="$AXE_MISSING Axe1(SystemArchitecture)"
+  fi
+
+  # Axe 2: Instrumentation / Metrics / Monitoring
+  if ! echo "$H2" | grep -qiE "instrumentation|metrics|monitoring"; then
+    AXE_MISSING="$AXE_MISSING Axe2(Instrumentation)"
+  fi
+
+  # Axe 3: Emergency Response
+  if ! echo "$H2" | grep -qiE "emergency.*response|emergency"; then
+    AXE_MISSING="$AXE_MISSING Axe3(EmergencyResponse)"
+  fi
+
+  # Axe 4: Capacity Planning
+  if ! echo "$H2" | grep -qiE "capacity.*planning|capacity"; then
+    AXE_MISSING="$AXE_MISSING Axe4(CapacityPlanning)"
+  fi
+
+  # Axe 5: Change Management
+  if ! echo "$H2" | grep -qiE "change.*management|change"; then
+    AXE_MISSING="$AXE_MISSING Axe5(ChangeManagement)"
+  fi
+
+  # Axe 6: Performance
+  if ! echo "$H2" | grep -qiE "performance"; then
+    AXE_MISSING="$AXE_MISSING Axe6(Performance)"
+  fi
+
+  if [ -n "$AXE_MISSING" ]; then
+    echo "FAIL: $prr_file — axes ausentes:$AXE_MISSING"
+    VIOLATIONS=$((VIOLATIONS + 1))
+  fi
+done
+IFS="$OLDIFS"
+
+if [ "$VIOLATIONS" -eq 0 ]; then
+  total=$(echo "$PRR_FILES" | wc -l | tr -d ' ')
+  echo "PASS: $total PRR-REPORT(s) cobrem os 6 axes canônicos"
+  exit 0
+else
+  echo "FAIL: $VIOLATIONS PRR-REPORT(s) com axes ausentes"
+  echo "Sugestão: rodar /sre prr <service> ou /prr para regenerar com template canônico (6 axes obrigatórios)."
+  echo "Cross-ref: kit/skills/production-readiness-review/SKILL.md + kit/agents/prr-conductor.md"
+  echo "Princípio canônico: 'Pular um axe = aprovação inválida' (cap 32 livro Google SRE)."
+  exit 1
+fi
+```
+
+## Verdict
+
+- **passed** — cada PRR-REPORT.md em `.planning/prr/**/*.md` tem H2 cobrindo os 6 axes (System Architecture / Instrumentation / Emergency Response / Capacity Planning / Change Management / Performance) OR diretório `.planning/prr/` ausente
+- **block** — pelo menos 1 PRR-REPORT.md com axe(s) ausente(s)
+
+## Why
+
+O livro Google SRE (cap 32 — *Evolving SRE Engagement Model*) define **6 axes canônicos** do Production Readiness Review. A skill `production-readiness-review` (Phase 36 / SKFD-SRE-05) declara como regra absoluta: *"Pular um axe = aprovação inválida (lacuna oculta vira incident em 6 meses)"*.
+
+Sem este gate, PRRs apressados podem omitir axes "menos relevantes" (anti-pattern documentado na skill); gaps em Change Management ou Capacity Planning não detectados em PRR viram incidents em produção meses depois. Gate força padrão canônico — cada `PRR-REPORT.md` cobrindo os 6 axes integralmente, mesmo que items dentro de um axe sejam N/A para o serviço (justificativa explícita no item, não no axe).
+
+Cross-ref agent canônico: [`prr-conductor`](../kit/agents/prr-conductor.md) (Phase 37 / AGCORE-SRE-04). Skill: [`production-readiness-review`](../kit/skills/production-readiness-review/SKILL.md) (Phase 36 / SKFD-SRE-05). Comando: `/prr --service <name>` ou `/prr --feature <description>` (Phase 38 / CMD-SRE-04).
+
+## REQ
+
+QA-SRE-03.
+
+## Configuração
+
+Gate é **blocking** por default. Para tornar warn-only durante adoption inicial:
+
+```bash
+node ./.claude/framework/bin/tools.cjs config-set workflow.prr_checklist_coverage_warn true
+```
+
+(Nota: implementação do toggle warn-only é deferida — gate atual não consulta config.)

package/gates/regression.md

@@ -1,32 +1,32 @@
----
-id: regression
-stage: pre-verify
-blocking: true
-description: Run prior-phase test suites to detect cross-phase regressions before verifying the current phase.
----
-
-# Regression gate
-
-**When to run:** before `verify_phase_goal` of any phase that is not the first.
-
-## Inputs
-
-- `PHASE_NUMBER` — current phase
-- All `*-VERIFICATION.md` files of prior phases in the current milestone
-
-## Check
-
-1. Discover prior verification files: `find .planning/phases/ -name "*-VERIFICATION.md" ! -path "*${PHASE_NUMBER}*"`
-2. Extract test file paths from each (paths under `test/`, `spec/`, `__tests__/`, or files matching `*.test.*` / `*.spec.*` referenced in `key-files.created`)
-3. Detect runner from project root (`package.json` → jest/vitest, `Cargo.toml` → cargo, `pyproject.toml` → pytest)
-4. Run only the prior-phase test files
-
-## Verdict
-
-- **passed** — every test green → proceed to verify
-- **block**  — any failure → present diff and ask `fix | continue | abort`
-
-## Notes
-
-This is a **cross-phase** regression check. It is intentionally narrower than a full
-test run — it answers "did this phase break what previous phases shipped?".
+---
+id: regression
+stage: pre-verify
+blocking: true
+description: Run prior-phase test suites to detect cross-phase regressions before verifying the current phase.
+---
+
+# Regression gate
+
+**When to run:** before `verify_phase_goal` of any phase that is not the first.
+
+## Inputs
+
+- `PHASE_NUMBER` — current phase
+- All `*-VERIFICATION.md` files of prior phases in the current milestone
+
+## Check
+
+1. Discover prior verification files: `find .planning/phases/ -name "*-VERIFICATION.md" ! -path "*${PHASE_NUMBER}*"`
+2. Extract test file paths from each (paths under `test/`, `spec/`, `__tests__/`, or files matching `*.test.*` / `*.spec.*` referenced in `key-files.created`)
+3. Detect runner from project root (`package.json` → jest/vitest, `Cargo.toml` → cargo, `pyproject.toml` → pytest)
+4. Run only the prior-phase test files
+
+## Verdict
+
+- **passed** — every test green → proceed to verify
+- **block**  — any failure → present diff and ask `fix | continue | abort`
+
+## Notes
+
+This is a **cross-phase** regression check. It is intentionally narrower than a full
+test run — it answers "did this phase break what previous phases shipped?".