@luanpdd/kit-mcp 1.34.0 → 1.36.0

package/gates/obs-skills-frontmatter.md

@@ -1,76 +1,76 @@
----
-id: obs-skills-frontmatter
-stage: pre-verify
-blocking: true
-description: Valida que skills observability têm frontmatter completo (name + description ≤ 200 chars) e seções obrigatórias do template.
----
-
-# Observability skills frontmatter gate
-
-**When to run:** pre-verify.
-
-## Check
-
-```bash
-#!/usr/bin/env bash
-# PT-BR: validar que cada skill em kit/skills/{structured-events,distributed-tracing,opentelemetry-standard,core-analysis-loop,observability-driven-development,event-based-slos,burn-rate-alerting,telemetry-sampling,telemetry-pipelines,observability-maturity-model}/SKILL.md
-# tem frontmatter completo + seções obrigatórias.
-# Portable bash 3.2+ (macOS default).
-set -e
-
-VIOLATIONS=0
-SKILLS="structured-events distributed-tracing opentelemetry-standard core-analysis-loop observability-driven-development event-based-slos burn-rate-alerting telemetry-sampling telemetry-pipelines observability-maturity-model"
-
-for skill in $SKILLS; do
-  file="kit/skills/$skill/SKILL.md"
-  if [ ! -f "$file" ]; then
-    echo "FAIL: $file — skill ausente"
-    VIOLATIONS=$((VIOLATIONS + 1))
-    continue
-  fi
-
-  # PT-BR: frontmatter name presente
-  if ! grep -qE '^name:' "$file"; then
-    echo "FAIL: $file — frontmatter 'name:' ausente"
-    VIOLATIONS=$((VIOLATIONS + 1))
-  fi
-
-  # PT-BR: frontmatter description presente
-  if ! grep -qE '^description:' "$file"; then
-    echo "FAIL: $file — frontmatter 'description:' ausente"
-    VIOLATIONS=$((VIOLATIONS + 1))
-  else
-    desc=$(grep -E '^description:' "$file" | head -1 | sed 's/description: //')
-    len=${#desc}
-    if [ "$len" -gt 200 ]; then
-      echo "FAIL: $file — description=$len chars (limite 200, anti-pitfall A2)"
-      VIOLATIONS=$((VIOLATIONS + 1))
-    fi
-  fi
-
-  # PT-BR: 4+ seções H2 (Quando usar, Regras absolutas, Patterns canônicos, Anti-patterns OU Verificação)
-  h2_count=$(grep -cE '^## ' "$file")
-  if [ "$h2_count" -lt 4 ]; then
-    echo "FAIL: $file — só $h2_count seções H2 (mínimo 4 — Quando usar, Regras absolutas, Patterns canônicos, Anti-patterns/Verificação)"
-    VIOLATIONS=$((VIOLATIONS + 1))
-  fi
-done
-
-if [ "$VIOLATIONS" -eq 0 ]; then
-  echo "PASS: 10 skills observability com frontmatter completo + 4+ seções H2"
-  exit 0
-else
-  echo "FAIL: $VIOLATIONS violação(ões)"
-  exit 1
-fi
-```
-
-## Why
-
-- Skills sem `description` não aparecem em `listKit` (LLM não acha o trigger)
-- `description > 200 chars` infla CLAUDE.md desnecessariamente (anti-pitfall A2)
-- Skills sem template fixo geram outputs inconsistentes — gate força padrão.
-
-## REQ
-
-QA-01.
+---
+id: obs-skills-frontmatter
+stage: pre-verify
+blocking: true
+description: Valida que skills observability têm frontmatter completo (name + description ≤ 200 chars) e seções obrigatórias do template.
+---
+
+# Observability skills frontmatter gate
+
+**When to run:** pre-verify.
+
+## Check
+
+```bash
+#!/usr/bin/env bash
+# PT-BR: validar que cada skill em kit/skills/{structured-events,distributed-tracing,opentelemetry-standard,core-analysis-loop,observability-driven-development,event-based-slos,burn-rate-alerting,telemetry-sampling,telemetry-pipelines,observability-maturity-model}/SKILL.md
+# tem frontmatter completo + seções obrigatórias.
+# Portable bash 3.2+ (macOS default).
+set -e
+
+VIOLATIONS=0
+SKILLS="structured-events distributed-tracing opentelemetry-standard core-analysis-loop observability-driven-development event-based-slos burn-rate-alerting telemetry-sampling telemetry-pipelines observability-maturity-model"
+
+for skill in $SKILLS; do
+  file="kit/skills/$skill/SKILL.md"
+  if [ ! -f "$file" ]; then
+    echo "FAIL: $file — skill ausente"
+    VIOLATIONS=$((VIOLATIONS + 1))
+    continue
+  fi
+
+  # PT-BR: frontmatter name presente
+  if ! grep -qE '^name:' "$file"; then
+    echo "FAIL: $file — frontmatter 'name:' ausente"
+    VIOLATIONS=$((VIOLATIONS + 1))
+  fi
+
+  # PT-BR: frontmatter description presente
+  if ! grep -qE '^description:' "$file"; then
+    echo "FAIL: $file — frontmatter 'description:' ausente"
+    VIOLATIONS=$((VIOLATIONS + 1))
+  else
+    desc=$(grep -E '^description:' "$file" | head -1 | sed 's/description: //')
+    len=${#desc}
+    if [ "$len" -gt 200 ]; then
+      echo "FAIL: $file — description=$len chars (limite 200, anti-pitfall A2)"
+      VIOLATIONS=$((VIOLATIONS + 1))
+    fi
+  fi
+
+  # PT-BR: 4+ seções H2 (Quando usar, Regras absolutas, Patterns canônicos, Anti-patterns OU Verificação)
+  h2_count=$(grep -cE '^## ' "$file")
+  if [ "$h2_count" -lt 4 ]; then
+    echo "FAIL: $file — só $h2_count seções H2 (mínimo 4 — Quando usar, Regras absolutas, Patterns canônicos, Anti-patterns/Verificação)"
+    VIOLATIONS=$((VIOLATIONS + 1))
+  fi
+done
+
+if [ "$VIOLATIONS" -eq 0 ]; then
+  echo "PASS: 10 skills observability com frontmatter completo + 4+ seções H2"
+  exit 0
+else
+  echo "FAIL: $VIOLATIONS violação(ões)"
+  exit 1
+fi
+```
+
+## Why
+
+- Skills sem `description` não aparecem em `listKit` (LLM não acha o trigger)
+- `description > 200 chars` infla CLAUDE.md desnecessariamente (anti-pitfall A2)
+- Skills sem template fixo geram outputs inconsistentes — gate força padrão.
+
+## REQ
+
+QA-01.

package/gates/observability-coverage.md

@@ -1,151 +1,151 @@
----
-id: observability-coverage
-stage: pre-milestone-close
-blocking: false
-description: Valida que ≥ X% das Edge Functions têm 4 golden signals + SLO + burn alert + characterization. Default threshold 70%. Opt-in via workflow.observability_coverage_threshold.
----
-
-# Observability coverage gate (cross-suite)
-
-**When to run:** pre-milestone-close (consultive default; blocking se `workflow.observability_coverage_threshold > 0`).
-
-**Skills canônicas:** [`four-golden-signals`](../kit/skills/four-golden-signals/SKILL.md), [`event-based-slos`](../kit/skills/event-based-slos/SKILL.md), [`burn-rate-alerting`](../kit/skills/burn-rate-alerting/SKILL.md), [`legacy-characterization-tests`](../kit/skills/legacy-characterization-tests/SKILL.md)
-
-**Agent invocado:** [`observability-coverage-auditor`](../kit/agents/observability-coverage-auditor.md)
-
-## Check
-
-```bash
-#!/usr/bin/env bash
-# PT-BR: validar cobertura cross-suite de Edge Functions
-set -e
-
-# threshold do gate
-THRESHOLD=70
-if [ -f ".planning/config.json" ] && command -v jq >/dev/null; then
-  CFG=$(jq -r '.workflow.observability_coverage_threshold // empty' .planning/config.json 2>/dev/null)
-  [ -n "$CFG" ] && [ "$CFG" != "null" ] && THRESHOLD=$CFG
-fi
-
-# se threshold = 0, gate skip (opt-in)
-if [ "$THRESHOLD" -eq 0 ]; then
-  echo "INFO: workflow.observability_coverage_threshold=0 — gate skip (opt-in não habilitado)."
-  exit 0
-fi
-
-# enumerar Edge Functions
-NUM_EDGE_FNS=$(find supabase/functions -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l)
-if [ "$NUM_EDGE_FNS" -eq 0 ]; then
-  echo "INFO: nenhuma Edge Function detectada — gate skip."
-  exit 0
-fi
-
-# contar Edge Functions cobertas em cada dimensão
-COVERED_SIGNALS=0
-COVERED_SLO=0
-COVERED_BURN=0
-COVERED_CHAR=0
-
-for fn_dir in $(find supabase/functions -mindepth 1 -maxdepth 1 -type d 2>/dev/null); do
-  FN_NAME=$(basename "$fn_dir")
-  FN_FILE="$fn_dir/index.ts"
-  [ ! -f "$FN_FILE" ] && continue
-
-  # 4 golden signals
-  HAS_LATENCY=$(grep -qE "createHistogram|histogram.*ms|latency_histogram" "$FN_FILE" && echo true || echo false)
-  HAS_TRAFFIC=$(grep -qE "createCounter.*requests|http_requests_total|trafficCounter" "$FN_FILE" && echo true || echo false)
-  HAS_ERRORS=$(grep -qE "createCounter.*errors|http_errors_total|error_type" "$FN_FILE" && echo true || echo false)
-  HAS_SAT=$(grep -qE "createObservableGauge|connection_pool|queue_depth" "$FN_FILE" && echo true || echo false)
-  if [ "$HAS_LATENCY" = "true" ] && [ "$HAS_TRAFFIC" = "true" ] && [ "$HAS_ERRORS" = "true" ] && [ "$HAS_SAT" = "true" ]; then
-    COVERED_SIGNALS=$((COVERED_SIGNALS + 1))
-  fi
-
-  # SLO
-  if [ -f ".planning/slos/$FN_NAME.md" ] || ([ -f ".planning/SLO.md" ] && grep -q "$FN_NAME" ".planning/SLO.md"); then
-    COVERED_SLO=$((COVERED_SLO + 1))
-  fi
-
-  # Burn alert
-  if grep -rq "$FN_NAME" .planning/burn-rate-alerts.md .planning/SLO.md 2>/dev/null; then
-    COVERED_BURN=$((COVERED_BURN + 1))
-  fi
-
-  # Characterization
-  for chardir in tests/characterization test/characterization __tests__/characterization; do
-    if find "$chardir" -path "*$FN_NAME*" 2>/dev/null | head -1 | grep -q .; then
-      COVERED_CHAR=$((COVERED_CHAR + 1))
-      break
-    fi
-  done
-done
-
-# computar percentages
-PCT_SIGNALS=$((COVERED_SIGNALS * 100 / NUM_EDGE_FNS))
-PCT_SLO=$((COVERED_SLO * 100 / NUM_EDGE_FNS))
-PCT_BURN=$((COVERED_BURN * 100 / NUM_EDGE_FNS))
-PCT_CHAR=$((COVERED_CHAR * 100 / NUM_EDGE_FNS))
-
-# avg
-PCT_AVG=$(( (PCT_SIGNALS + PCT_SLO + PCT_BURN + PCT_CHAR) / 4 ))
-
-echo ""
-echo "observability-coverage gate — threshold: ${THRESHOLD}%"
-echo ""
-echo "  4 Golden Signals:        ${COVERED_SIGNALS}/${NUM_EDGE_FNS} (${PCT_SIGNALS}%)"
-echo "  SLO definido:            ${COVERED_SLO}/${NUM_EDGE_FNS} (${PCT_SLO}%)"
-echo "  Burn rate alert:         ${COVERED_BURN}/${NUM_EDGE_FNS} (${PCT_BURN}%)"
-echo "  Characterization tests:  ${COVERED_CHAR}/${NUM_EDGE_FNS} (${PCT_CHAR}%)"
-echo ""
-echo "  Avg coverage: ${PCT_AVG}%"
-echo ""
-
-# decisão
-if [ "$PCT_AVG" -ge "$THRESHOLD" ]; then
-  echo "✓ Avg ≥ threshold (${PCT_AVG}% ≥ ${THRESHOLD}%). Gate aprovado."
-  exit 0
-fi
-
-echo "⚠ Avg < threshold (${PCT_AVG}% < ${THRESHOLD}%)."
-echo ""
-echo "Próximas ações:"
-echo "  /auditar-observabilidade-cobertura      (vê detalhes + top 5 críticas)"
-echo "  /golden-signals <fn>                    (instrumentar 4 signals)"
-echo "  /definir-slo <fn>                       (define SLO event-based)"
-echo "  /caracterizar <fn>                      (characterization tests)"
-echo ""
-
-# blocking se threshold > 0 e não atingido
-if [ "$THRESHOLD" -gt 0 ]; then
-  exit 1
-fi
-
-exit 0
-```
-
-## Configuração
-
-```json
-{
-  "workflow": {
-    "observability_coverage_threshold": 70
-  }
-}
-```
-
-**Default:** `0` (skip — opt-in). Recomendação:
-- Projetos < 6 meses: 50 (consultive)
-- Projetos 6-12 meses: 70
-- Projetos > 12 meses ou tier-1 production: 80+
-
-## Quando NÃO rodar
-
-- Projeto sem Edge Functions (puro frontend/backend stateless)
-- Projeto recém-criado (< 1 mês) — distribuição de Edge Functions ainda imatura
-- Greenfield onde Edge Functions estão sendo escritas em paralelo a milestones
-
-## Ver também
-
-- [`observability-coverage-auditor`](../kit/agents/observability-coverage-auditor.md) — agent canônico
-- [`/auditar-observabilidade-cobertura`](../kit/commands/auditar-observabilidade-cobertura.md) — comando dedicado
-- [`omm-no-regression`](./omm-no-regression.md) — gate análogo da Suíte Observabilidade
-- [`golden-signals-coverage`](./golden-signals-coverage.md) — gate específico apenas para golden signals
+---
+id: observability-coverage
+stage: pre-milestone-close
+blocking: false
+description: Valida que ≥ X% das Edge Functions têm 4 golden signals + SLO + burn alert + characterization. Default threshold 70%. Opt-in via workflow.observability_coverage_threshold.
+---
+
+# Observability coverage gate (cross-suite)
+
+**When to run:** pre-milestone-close (consultive default; blocking se `workflow.observability_coverage_threshold > 0`).
+
+**Skills canônicas:** [`four-golden-signals`](../kit/skills/four-golden-signals/SKILL.md), [`event-based-slos`](../kit/skills/event-based-slos/SKILL.md), [`burn-rate-alerting`](../kit/skills/burn-rate-alerting/SKILL.md), [`legacy-characterization-tests`](../kit/skills/legacy-characterization-tests/SKILL.md)
+
+**Agent invocado:** [`observability-coverage-auditor`](../kit/agents/observability-coverage-auditor.md)
+
+## Check
+
+```bash
+#!/usr/bin/env bash
+# PT-BR: validar cobertura cross-suite de Edge Functions
+set -e
+
+# threshold do gate
+THRESHOLD=70
+if [ -f ".planning/config.json" ] && command -v jq >/dev/null; then
+  CFG=$(jq -r '.workflow.observability_coverage_threshold // empty' .planning/config.json 2>/dev/null)
+  [ -n "$CFG" ] && [ "$CFG" != "null" ] && THRESHOLD=$CFG
+fi
+
+# se threshold = 0, gate skip (opt-in)
+if [ "$THRESHOLD" -eq 0 ]; then
+  echo "INFO: workflow.observability_coverage_threshold=0 — gate skip (opt-in não habilitado)."
+  exit 0
+fi
+
+# enumerar Edge Functions
+NUM_EDGE_FNS=$(find supabase/functions -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l)
+if [ "$NUM_EDGE_FNS" -eq 0 ]; then
+  echo "INFO: nenhuma Edge Function detectada — gate skip."
+  exit 0
+fi
+
+# contar Edge Functions cobertas em cada dimensão
+COVERED_SIGNALS=0
+COVERED_SLO=0
+COVERED_BURN=0
+COVERED_CHAR=0
+
+for fn_dir in $(find supabase/functions -mindepth 1 -maxdepth 1 -type d 2>/dev/null); do
+  FN_NAME=$(basename "$fn_dir")
+  FN_FILE="$fn_dir/index.ts"
+  [ ! -f "$FN_FILE" ] && continue
+
+  # 4 golden signals
+  HAS_LATENCY=$(grep -qE "createHistogram|histogram.*ms|latency_histogram" "$FN_FILE" && echo true || echo false)
+  HAS_TRAFFIC=$(grep -qE "createCounter.*requests|http_requests_total|trafficCounter" "$FN_FILE" && echo true || echo false)
+  HAS_ERRORS=$(grep -qE "createCounter.*errors|http_errors_total|error_type" "$FN_FILE" && echo true || echo false)
+  HAS_SAT=$(grep -qE "createObservableGauge|connection_pool|queue_depth" "$FN_FILE" && echo true || echo false)
+  if [ "$HAS_LATENCY" = "true" ] && [ "$HAS_TRAFFIC" = "true" ] && [ "$HAS_ERRORS" = "true" ] && [ "$HAS_SAT" = "true" ]; then
+    COVERED_SIGNALS=$((COVERED_SIGNALS + 1))
+  fi
+
+  # SLO
+  if [ -f ".planning/slos/$FN_NAME.md" ] || ([ -f ".planning/SLO.md" ] && grep -q "$FN_NAME" ".planning/SLO.md"); then
+    COVERED_SLO=$((COVERED_SLO + 1))
+  fi
+
+  # Burn alert
+  if grep -rq "$FN_NAME" .planning/burn-rate-alerts.md .planning/SLO.md 2>/dev/null; then
+    COVERED_BURN=$((COVERED_BURN + 1))
+  fi
+
+  # Characterization
+  for chardir in tests/characterization test/characterization __tests__/characterization; do
+    if find "$chardir" -path "*$FN_NAME*" 2>/dev/null | head -1 | grep -q .; then
+      COVERED_CHAR=$((COVERED_CHAR + 1))
+      break
+    fi
+  done
+done
+
+# computar percentages
+PCT_SIGNALS=$((COVERED_SIGNALS * 100 / NUM_EDGE_FNS))
+PCT_SLO=$((COVERED_SLO * 100 / NUM_EDGE_FNS))
+PCT_BURN=$((COVERED_BURN * 100 / NUM_EDGE_FNS))
+PCT_CHAR=$((COVERED_CHAR * 100 / NUM_EDGE_FNS))
+
+# avg
+PCT_AVG=$(( (PCT_SIGNALS + PCT_SLO + PCT_BURN + PCT_CHAR) / 4 ))
+
+echo ""
+echo "observability-coverage gate — threshold: ${THRESHOLD}%"
+echo ""
+echo "  4 Golden Signals:        ${COVERED_SIGNALS}/${NUM_EDGE_FNS} (${PCT_SIGNALS}%)"
+echo "  SLO definido:            ${COVERED_SLO}/${NUM_EDGE_FNS} (${PCT_SLO}%)"
+echo "  Burn rate alert:         ${COVERED_BURN}/${NUM_EDGE_FNS} (${PCT_BURN}%)"
+echo "  Characterization tests:  ${COVERED_CHAR}/${NUM_EDGE_FNS} (${PCT_CHAR}%)"
+echo ""
+echo "  Avg coverage: ${PCT_AVG}%"
+echo ""
+
+# decisão
+if [ "$PCT_AVG" -ge "$THRESHOLD" ]; then
+  echo "✓ Avg ≥ threshold (${PCT_AVG}% ≥ ${THRESHOLD}%). Gate aprovado."
+  exit 0
+fi
+
+echo "⚠ Avg < threshold (${PCT_AVG}% < ${THRESHOLD}%)."
+echo ""
+echo "Próximas ações:"
+echo "  /auditar-observabilidade-cobertura      (vê detalhes + top 5 críticas)"
+echo "  /golden-signals <fn>                    (instrumentar 4 signals)"
+echo "  /definir-slo <fn>                       (define SLO event-based)"
+echo "  /caracterizar <fn>                      (characterization tests)"
+echo ""
+
+# blocking se threshold > 0 e não atingido
+if [ "$THRESHOLD" -gt 0 ]; then
+  exit 1
+fi
+
+exit 0
+```
+
+## Configuração
+
+```json
+{
+  "workflow": {
+    "observability_coverage_threshold": 70
+  }
+}
+```
+
+**Default:** `0` (skip — opt-in). Recomendação:
+- Projetos < 6 meses: 50 (consultive)
+- Projetos 6-12 meses: 70
+- Projetos > 12 meses ou tier-1 production: 80+
+
+## Quando NÃO rodar
+
+- Projeto sem Edge Functions (puro frontend/backend stateless)
+- Projeto recém-criado (< 1 mês) — distribuição de Edge Functions ainda imatura
+- Greenfield onde Edge Functions estão sendo escritas em paralelo a milestones
+
+## Ver também
+
+- [`observability-coverage-auditor`](../kit/agents/observability-coverage-auditor.md) — agent canônico
+- [`/auditar-observabilidade-cobertura`](../kit/commands/auditar-observabilidade-cobertura.md) — comando dedicado
+- [`omm-no-regression`](./omm-no-regression.md) — gate análogo da Suíte Observabilidade
+- [`golden-signals-coverage`](./golden-signals-coverage.md) — gate específico apenas para golden signals

package/gates/omm-no-regression.md

@@ -1,83 +1,83 @@
----
-id: omm-no-regression
-stage: pre-conclude
-blocking: false
-description: Valida que nenhuma das 5 capacidades OMM regrediu vs marco anterior. Rodável em /concluir-marco. Não-bloqueante (warn) por default; configurável via workflow.omm_no_regression.
----
-
-# OMM no-regression gate
-
-**When to run:** pre-conclude (antes de `/concluir-marco` arquivar marco).
-
-## Check
-
-```bash
-#!/usr/bin/env bash
-# PT-BR: validar que OMM-REPORT.md atual não tem capacidade regredida vs marco anterior.
-# Estratégia: comparar scores no OMM-REPORT.md atual vs último arquivado.
-set -e
-
-CURRENT=".planning/OMM-REPORT.md"
-
-if [ ! -f "$CURRENT" ]; then
-  echo "WARN: $CURRENT ausente — rodar /auditar-observabilidade primeiro. Pulando gate."
-  exit 0
-fi
-
-# PT-BR: encontrar OMM-REPORT.md anterior em milestones arquivados
-PREVIOUS=$(find .planning/milestones -name "OMM-REPORT.md" -type f 2>/dev/null | sort -r | head -1)
-
-if [ -z "$PREVIOUS" ] || [ ! -f "$PREVIOUS" ]; then
-  echo "INFO: sem OMM-REPORT anterior arquivado (primeiro marco com OMM). Pulando regression check."
-  exit 0
-fi
-
-# PT-BR: extrair scores do OMM-REPORT.md atual e anterior
-# Formato esperado: "| 1 | Resiliência | 3 | ... |"
-
-REGRESSIONS=0
-for cap in 1 2 3 4 5; do
-  current_score=$(grep -E "^\| $cap \| " "$CURRENT" 2>/dev/null | awk -F'|' '{print $4}' | tr -d ' ' | head -1)
-  previous_score=$(grep -E "^\| $cap \| " "$PREVIOUS" 2>/dev/null | awk -F'|' '{print $4}' | tr -d ' ' | head -1)
-
-  if [ -z "$current_score" ] || [ -z "$previous_score" ]; then
-    continue
-  fi
-
-  if [ "$current_score" -lt "$previous_score" ]; then
-    cap_name=$(grep -E "^\| $cap \| " "$CURRENT" | awk -F'|' '{print $3}' | xargs)
-    echo "REGRESSION: Capacidade $cap ($cap_name) regrediu de $previous_score → $current_score"
-    REGRESSIONS=$((REGRESSIONS + 1))
-  fi
-done
-
-if [ "$REGRESSIONS" -eq 0 ]; then
-  echo "PASS: nenhuma das 5 capacidades OMM regrediu vs $PREVIOUS"
-  exit 0
-else
-  echo "WARN: $REGRESSIONS capacidade(s) regredida(s)"
-  # PT-BR: blocking=false por default. Para tornar bloqueante:
-  #   workflow.omm_no_regression=true
-  if [ "$(node ./.claude/framework/bin/tools.cjs config-get workflow.omm_no_regression 2>/dev/null || echo false)" = "true" ]; then
-    exit 1
-  fi
-  exit 0
-fi
-```
-
-## Why
-
-OMM regression alerta o time que algo deteriorou apesar do esforço do marco. Sem este gate, regressions silenciam e accumulate como tech debt invisível.
-
-Default não-bloqueante para evitar ruído inicial; flag `workflow.omm_no_regression=true` opt-in quando time confiante.
-
-## REQ
-
-QA-03 + INT-FW-04 + INT-FW-05.
-
-## Configuração
-
-```bash
-# PT-BR: tornar bloqueante (recomendado depois de 2-3 marcos consecutivos sem regression)
-node ./.claude/framework/bin/tools.cjs config-set workflow.omm_no_regression true
-```
+---
+id: omm-no-regression
+stage: pre-conclude
+blocking: false
+description: Valida que nenhuma das 5 capacidades OMM regrediu vs marco anterior. Rodável em /concluir-marco. Não-bloqueante (warn) por default; configurável via workflow.omm_no_regression.
+---
+
+# OMM no-regression gate
+
+**When to run:** pre-conclude (antes de `/concluir-marco` arquivar marco).
+
+## Check
+
+```bash
+#!/usr/bin/env bash
+# PT-BR: validar que OMM-REPORT.md atual não tem capacidade regredida vs marco anterior.
+# Estratégia: comparar scores no OMM-REPORT.md atual vs último arquivado.
+set -e
+
+CURRENT=".planning/OMM-REPORT.md"
+
+if [ ! -f "$CURRENT" ]; then
+  echo "WARN: $CURRENT ausente — rodar /auditar-observabilidade primeiro. Pulando gate."
+  exit 0
+fi
+
+# PT-BR: encontrar OMM-REPORT.md anterior em milestones arquivados
+PREVIOUS=$(find .planning/milestones -name "OMM-REPORT.md" -type f 2>/dev/null | sort -r | head -1)
+
+if [ -z "$PREVIOUS" ] || [ ! -f "$PREVIOUS" ]; then
+  echo "INFO: sem OMM-REPORT anterior arquivado (primeiro marco com OMM). Pulando regression check."
+  exit 0
+fi
+
+# PT-BR: extrair scores do OMM-REPORT.md atual e anterior
+# Formato esperado: "| 1 | Resiliência | 3 | ... |"
+
+REGRESSIONS=0
+for cap in 1 2 3 4 5; do
+  current_score=$(grep -E "^\| $cap \| " "$CURRENT" 2>/dev/null | awk -F'|' '{print $4}' | tr -d ' ' | head -1)
+  previous_score=$(grep -E "^\| $cap \| " "$PREVIOUS" 2>/dev/null | awk -F'|' '{print $4}' | tr -d ' ' | head -1)
+
+  if [ -z "$current_score" ] || [ -z "$previous_score" ]; then
+    continue
+  fi
+
+  if [ "$current_score" -lt "$previous_score" ]; then
+    cap_name=$(grep -E "^\| $cap \| " "$CURRENT" | awk -F'|' '{print $3}' | xargs)
+    echo "REGRESSION: Capacidade $cap ($cap_name) regrediu de $previous_score → $current_score"
+    REGRESSIONS=$((REGRESSIONS + 1))
+  fi
+done
+
+if [ "$REGRESSIONS" -eq 0 ]; then
+  echo "PASS: nenhuma das 5 capacidades OMM regrediu vs $PREVIOUS"
+  exit 0
+else
+  echo "WARN: $REGRESSIONS capacidade(s) regredida(s)"
+  # PT-BR: blocking=false por default. Para tornar bloqueante:
+  #   workflow.omm_no_regression=true
+  if [ "$(node ./.claude/framework/bin/tools.cjs config-get workflow.omm_no_regression 2>/dev/null || echo false)" = "true" ]; then
+    exit 1
+  fi
+  exit 0
+fi
+```
+
+## Why
+
+OMM regression alerta o time que algo deteriorou apesar do esforço do marco. Sem este gate, regressions silenciam e accumulate como tech debt invisível.
+
+Default não-bloqueante para evitar ruído inicial; flag `workflow.omm_no_regression=true` opt-in quando time confiante.
+
+## REQ
+
+QA-03 + INT-FW-04 + INT-FW-05.
+
+## Configuração
+
+```bash
+# PT-BR: tornar bloqueante (recomendado depois de 2-3 marcos consecutivos sem regression)
+node ./.claude/framework/bin/tools.cjs config-set workflow.omm_no_regression true
+```