@luanpdd/kit-mcp 1.10.0 → 1.12.0

package/kit/commands/refactor-seguro.md

@@ -0,0 +1,321 @@
+---
+name: refactor-seguro
+description: Orquestrador de refactor seguro — chain canônico encontrar-seams → caracterizar → auditar-refactor → executar. Suporta modos --mode=full|sprout|safe-extract|override. Substitui edit-and-pray por cover-and-modify.
+argument-hint: "<target_file> [--mode full|sprout|safe-extract|override] [--ticket REQ-N] [--reason \"...\"] [--skip-seams] [--skip-characterize]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Orquestrar fluxo canônico de refactor seguro em código legado: (1) identificar seams + quebrar deps; (2) caracterizar comportamento; (3) auditar safety net; (4) executar refactor com cover-and-modify. Substitui o pattern edit-and-pray (cap 1 Feathers) por cover-and-modify, baseado em characterization tests como oracle.
+
+**Chain padrão (`--mode=full`):**
+
+```
+seam-finder → legacy-characterizer → refactor-safety-auditor → executor
+   (se necessário)    (sempre)              (gate)               (refactor real)
+```
+
+**Modos alternativos** (atalhos quando mudança não justifica chain completo):
+- `--mode=sprout` — usa `legacy-sprout-wrap-techniques`; legado intocado, comportamento adicionado em sprout testado isoladamente
+- `--mode=safe-extract` — refactor mecânico (rename, IDE-extract bloco contíguo); checklist signed-off + sem characterization
+- `--mode=override` — bypass com audit trail (--ticket + --reason obrigatórios)
+
+**Cria/Atualiza:**
+- Em modo full: `.planning/SEAM-ANALYSIS.md`, `tests/characterization/<file_stem>/`, `.planning/REFACTOR-SAFETY.md`
+- Em modo sprout: novo módulo + tests
+- Em modo safe-extract: refactor commit + checklist em `.planning/SAFE-EXTRACT-<file>.md`
+- Em modo override: `.planning/REFACTOR-SAFETY.md` com audit trail
+
+**Após:** o user terminou refactor com confiança proporcional ao nível de safety net adotado.
+</objective>
+
+<context>
+**Argumentos:**
+- `<target_file>` — caminho do arquivo a refatorar — OBRIGATÓRIO
+- `--mode <full|sprout|safe-extract|override>` — modo do orquestrador (default: `full`)
+- `--ticket REQ-N` — ticket linkado (obrigatório com `--mode=override`)
+- `--reason "<texto>"` — justificativa (obrigatória com `--mode=override`)
+- `--skip-seams` — pular seam-finder (assume deps já controláveis)
+- `--skip-characterize` — pular caracterizar (assume safety net já existe)
+- `--symbol <name>` — escopo limitado a símbolo específico
+- `--feature-description "<texto>"` — em mode=sprout, descreve feature a adicionar
+
+**Modos detalhados:**
+
+```
+--mode=full (default)
+=====================
+1. /encontrar-seams <file>            (se necessário, deps externas presentes)
+2. Aplicar técnicas de break-deps     (commits 1-N, manual ou via executor)
+3. /caracterizar <file>                (gera safety net)
+4. /auditar-refactor <file>           (gate retorna GO)
+5. Refactor real                      (cover-and-modify, suite verde a cada commit)
+6. Re-rodar suite final                (regressão = 0)
+
+--mode=sprout
+=============
+1. AskUserQuestion para feature description
+2. Aplicar legacy-sprout-wrap-techniques
+3. Gerar sprout method/class testável
+4. Conectar ao legado em 1-2 linhas
+5. Tests do sprout (100% cobertura no novo)
+6. PR criado com TODO de débito técnico (legado ainda untested)
+
+--mode=safe-extract
+====================
+1. Validar checklist canônico:
+   - Bloco a extrair é CONTÍGUO?
+   - Sem control flow saindo do meio (return/throw/break)?
+   - Variáveis lidas/escritas mapeadas?
+   - Sem mover lógica entre escopos?
+2. Aplicar refactor IDE-assisted
+3. Compilação verde + smoke run
+4. PR com SAFE-EXTRACT-<file>.md como artefato
+
+--mode=override
+================
+1. Validar --ticket E --reason
+2. Auditoria do refactor-safety-auditor com flag override
+3. Audit trail registrado em REFACTOR-SAFETY.md
+4. Refactor pode prosseguir SEM characterization
+5. Débito técnico documentado no ticket
+```
+
+**Exemplos:**
+```
+/refactor-seguro src/orders/handler.ts                                # full chain (recomendado)
+/refactor-seguro src/orders/handler.ts --mode=sprout                  # adicionar feature sem tocar legado
+/refactor-seguro src/orders/handler.ts --mode=safe-extract            # rename/extract mecânico
+/refactor-seguro src/orders/handler.ts --mode=override \
+  --ticket REQ-2026-Q2-1234 --reason "hot fix SEV1, char em REQ-...1235"
+/refactor-seguro src/orders/handler.ts --skip-seams                   # deps já testáveis
+/refactor-seguro src/orders/handler.ts --symbol processOrder          # método específico
+```
+
+**Quando este comando é o caminho certo:**
+- Você vai modificar arquivo > 200 linhas com cobertura < 60%
+- Webhook/API/Edge Function precisa refactor (contrato externo)
+- Equipe quer disciplina cover-and-modify em vez de edit-and-pray
+- `/discutir-fase` ou `/planejar-fase` detectaram refactor intent
+
+**Quando NÃO é o caminho:**
+- Bug fix → use TDD direto (escrever test do comportamento correto, depois fix)
+- Feature nova em código novo → use `/discutir-fase` + `/planejar-fase` normais
+- Arquivo trivial → refactor inline sem ceremonial
+</context>
+
+<process>
+
+## 1. Parsear argumentos + validações
+
+```bash
+TARGET_FILE=$(echo "$ARGUMENTS" | awk '{print $1}')
+MODE=$(echo "$ARGUMENTS" | grep -oE -- '--mode[= ][^ ]+' | sed 's/--mode[= ]//')
+TICKET=$(echo "$ARGUMENTS" | grep -oE -- '--ticket [^ ]+' | awk '{print $2}')
+REASON=$(echo "$ARGUMENTS" | grep -oE -- '--reason "[^"]+"' | sed 's/--reason "\(.*\)"/\1/')
+SYMBOL=$(echo "$ARGUMENTS" | grep -oE -- '--symbol [^ ]+' | awk '{print $2}')
+FEATURE_DESC=$(echo "$ARGUMENTS" | grep -oE -- '--feature-description "[^"]+"' | sed 's/--feature-description "\(.*\)"/\1/')
+SKIP_SEAMS=false
+SKIP_CHAR=false
+
+echo "$ARGUMENTS" | grep -qE -- '--skip-seams'        && SKIP_SEAMS=true
+echo "$ARGUMENTS" | grep -qE -- '--skip-characterize' && SKIP_CHAR=true
+
+[ -z "$MODE" ] && MODE="full"
+
+if [ -z "$TARGET_FILE" ]; then
+  echo "ERROR: target_file é obrigatório."
+  echo "Uso: /refactor-seguro <target_file> [opções]"
+  exit 1
+fi
+
+if [ ! -f "$TARGET_FILE" ]; then
+  echo "ERROR: arquivo não encontrado: $TARGET_FILE"
+  exit 1
+fi
+
+# PT-BR: validações por mode
+case "$MODE" in
+  full|sprout|safe-extract|override) ;;
+  *)
+    echo "ERROR: --mode inválido: $MODE"
+    echo "Valores válidos: full, sprout, safe-extract, override"
+    exit 1
+    ;;
+esac
+
+if [ "$MODE" = "override" ]; then
+  if [ -z "$TICKET" ] || [ -z "$REASON" ]; then
+    echo "ERROR: --mode=override requer --ticket REQ-N E --reason \"<texto>\"."
+    exit 1
+  fi
+fi
+```
+
+## 2. Roteamento por mode
+
+### Mode=full (default chain)
+
+```text
+Step 1 — Seam analysis (skip se --skip-seams)
+  /encontrar-seams ${TARGET_FILE} ${SYMBOL:+--symbol $SYMBOL}
+  → produz .planning/SEAM-ANALYSIS.md
+  → user aplica técnicas (commits 1-N)
+
+Step 2 — Verificar suite verde após break-deps
+  Run test suite, abort se vermelho
+
+Step 3 — Characterization (skip se --skip-characterize)
+  /caracterizar ${TARGET_FILE} ${SYMBOL:+--symbol $SYMBOL}
+  → produz tests/characterization/<file_stem>/
+  → user revisa snapshots manualmente
+  → user commita como `chore: characterize <file_stem>`
+
+Step 4 — Audit do safety net
+  /auditar-refactor ${TARGET_FILE} --change-kind=refactor
+  → produz .planning/REFACTOR-SAFETY.md com veredito GO/WARN/BLOCK
+  → SE BLOCK ainda → loop de volta para step 3 (com --gap-fill)
+  → SE GO → prossegue
+
+Step 5 — Refactor real
+  Delegar para executor OR prompt user para refactor manual
+  Após cada commit: rodar suite (verde)
+  Após cada commit: characterization tests (verdes — comportamento preservado)
+
+Step 6 — Verificação final
+  Suite verde
+  Characterization VERDE (regressão = 0)
+  Mutation kill ≥ 70% (validar safety net)
+  PR pode ser aberto
+```
+
+### Mode=sprout
+
+```text
+Step 1 — Coletar feature description
+  Se $FEATURE_DESC vazio → AskUserQuestion:
+    "Descreva a feature a ser adicionada (será encapsulada em sprout):"
+
+Step 2 — Aplicar legacy-sprout-wrap-techniques
+  Decision: sprout method vs sprout class vs wrap method vs wrap class
+    - feature ≤ 30 linhas, 1 responsabilidade → sprout method
+    - feature > 30 linhas OR multi-responsibility → sprout class
+    - feature transforma input/output do legado inteiro → wrap method
+    - feature atravessa N métodos da classe → wrap class
+
+Step 3 — Gerar sprout
+  Criar arquivo novo (sprout module) com lógica testável
+  DI explícita para qualquer dep
+
+Step 4 — Conectar ao legado em 1-2 linhas
+  Inserir chamada ao sprout no legado
+  Comment canônico: [legacy-debt #issue-N] sprout — <descrição>
+
+Step 5 — Tests do sprout (100% cobertura)
+  Escrever 5+ tests cobrindo grupos de equivalência
+  Mutation testing no sprout (não no legado)
+
+Step 6 — PR
+  Diff esperado: arquivo novo + 1-2 linhas no legado
+  README/CHANGELOG atualizado se aplicável
+  Ticket de débito técnico criado se ainda não existia
+```
+
+### Mode=safe-extract
+
+```text
+Step 1 — Validar checklist canônico
+  AskUserQuestion ou inline-confirm:
+    □ Bloco a extrair é CONTÍGUO?           (não pode ter return/throw/break/continue saindo)
+    □ Variáveis lidas dentro mas declaradas fora → parâmetros (in)?
+    □ Variáveis escritas dentro mas usadas fora → return values (out)?
+    □ NÃO move lógica entre escopos? (sem move method)
+    □ NÃO muda control flow? (sem inverter ifs, sem early return novo)
+    □ NÃO modifica sintaxe além de extract/rename?
+  Qualquer NÃO → veto, voltar para mode=full
+
+Step 2 — Identificar refactor IDE-assisted
+  Se Cursor/VS Code/IntelliJ disponível → usar Refactor → Extract Function/Method/Variable
+  Caso contrário → manual mas mecânico
+
+Step 3 — Aplicar refactor (commits single-goal)
+  Após cada commit: compilação verde
+  Após cada commit: smoke run (qualquer comando que rodava antes)
+
+Step 4 — Output checklist signed-off
+  Escrever .planning/SAFE-EXTRACT-<file_stem>.md com:
+    - Checklist canônico (todos os itens marcados)
+    - Lista de commits (cada um single-goal)
+    - Validação de comportamento (smoke verde)
+```
+
+### Mode=override
+
+```text
+Step 1 — Validar --ticket E --reason (já feito acima)
+
+Step 2 — Auditar com flag override
+  /auditar-refactor ${TARGET_FILE} \
+    --change-kind=override \
+    --ticket ${TICKET} \
+    --reason "${REASON}"
+  → audit trail registrado em REFACTOR-SAFETY.md
+
+Step 3 — Refactor pode prosseguir
+  Output:
+    ⚠ MODE=OVERRIDE — refactor sem characterization
+    Ticket: ${TICKET}
+    Reason: ${REASON}
+    Audit trail: .planning/REFACTOR-SAFETY.md
+    
+    Você aceitou o débito técnico. Refactor pode iniciar AGORA.
+    Lembre-se: regressão silenciosa em prod é responsabilidade do owner do ticket.
+```
+
+## 3. Output canônico
+
+```
+═══════════════════════════════════════════════════════════
+ framework ► REFACTOR-SEGURO ▸ ${TARGET_FILE} (mode: ${MODE})
+═══════════════════════════════════════════════════════════
+
+[output específico do mode escolhido]
+
+## Sumário do que foi feito
+
+| Step | Ação | Output |
+|---|---|---|
+| 1 | Seam analysis | .planning/SEAM-ANALYSIS.md |
+| 2 | Characterization | tests/characterization/<file_stem>/ |
+| 3 | Safety audit | .planning/REFACTOR-SAFETY.md (veredito: GO) |
+| 4 | Refactor | <commits sequenciais> |
+| 5 | Verificação final | suite verde, mutation kill ≥ 70% |
+
+## Cross-suite
+
+- **/instrumentar-fase** (v1.9) — adicionar instrumentação para detectar regressão precoce em prod via golden signals
+- **/burn-rate-status** (v1.9) — monitor SLO budget pós-deploy do refactor
+- **/prr** (v1.10) — PRR Axe 5 (Change Management) — invoque após refactor para validar production-readiness
+- **/postmortem** (v1.10) — pronto para usar se algo regredir em prod (audit trail completo via REFACTOR-SAFETY.md)
+- **/concluir-marco** — gate `legacy-refactor-safety` (opt-in) bloqueia close se há refactors com mode=override sem ticket close
+```
+
+</process>
+
+<success_criteria>
+- [ ] $ARGUMENTS parseados (target_file obrigatório, --mode opcional com 4 valores)
+- [ ] Validações por mode aplicadas (override → ticket + reason; safe-extract → checklist)
+- [ ] Mode=full executa chain canônico (seam-finder → characterizer → safety-auditor → refactor)
+- [ ] Mode=sprout aplica legacy-sprout-wrap-techniques + AskUserQuestion para feature
+- [ ] Mode=safe-extract valida checklist + commits single-goal
+- [ ] Mode=override registra audit trail completo via refactor-safety-auditor
+- [ ] Steps 1-5 e cross-suite documentados no output
+- [ ] Each sub-comando invocado via syntax canônica (`/encontrar-seams`, `/caracterizar`, `/auditar-refactor`)
+</success_criteria>

package/kit/commands/sre.md

@@ -51,6 +51,9 @@ Agents disponíveis (Phase 37):
 | `postmortem` | `pm`, `post-mortem` | `postmortem-writer` | 15 |
 | `prr` | `production-readiness`, `readiness-review` | `prr-conductor` | 32 |
 | `risk-budget` | `budget`, `risk`, `continuum` | (comando direto — `/risk-budget`) | 3 |
+| `cascading` | `cascade`, `cascading-failures`, `auditar-cascading` | `cascading-failures-auditor` | 22 (v1.11) |
+| `load-shedding` | `shed`, `load-shed`, `loadshedding` | `load-shedding-instrumenter` | 22 (v1.11) |
+| `release` | `auditar-release`, `release-audit`, `pipeline` | `release-pipeline-auditor` | 8 (v1.11) |
 | `help` | `ajuda`, `?` | exibe esta tabela inline | — |
 
 **Roteamento de flags por subcomando:**

package/kit/commands/storytelling.md

@@ -0,0 +1,179 @@
+---
+name: storytelling
+description: Invoca storytelling-analyst — IA gera mental model de codebase desconhecido (story 5 frases + inventário + naked CRC + responsibility hot spots + extract candidates). Modernização cap 16-17 Feathers para era IA.
+argument-hint: "<target_dir_or_file> [--depth deep|shallow] [--include-tests] [--output PATH]"
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - Task
+  - Write
+---
+
+<objective>
+Gerar **mental model de codebase desconhecido** via IA — story em 5 frases + inventário de classes/funções + naked CRC sketch + responsibility hot spots + extract candidates priorizados. Invoca o agente [`storytelling-analyst`](../agents/storytelling-analyst.md) que aplica a skill [`legacy-storytelling-naked-crc`](../skills/legacy-storytelling-naked-crc/SKILL.md) — caps 16-17 do livro Feathers + modernização IA primeiro draft.
+
+**Cria/Atualiza:**
+- `.planning/storytelling/<module-slug>.md` — relatório com story + inventário + CRC + hot spots
+
+**Após:** o user reduz tempo de comprehension de codebase desconhecido de 4-8h (leitura cega manual) para 30 min (revisão informada de IA primeiro draft). Pré-requisito recomendado para `/encontrar-seams` ou `/refactor-seguro` em código novo.
+</objective>
+
+<context>
+**Argumentos:**
+- `<target_dir_or_file>` — diretório ou arquivo a analisar — OBRIGATÓRIO
+- `--depth deep|shallow` — `shallow` = só story + inventário; `deep` = + CRC + hot spots + extract candidates (default: deep)
+- `--include-tests` — incluir tests no scope (default: false; distinção comportamento prod vs harness)
+- `--max-lines N` — limite de leitura (default: 1500; agent quebra em chunks se maior)
+- `--output PATH` — caminho do output (default: `.planning/storytelling/<slug>.md`)
+
+**Exemplos:**
+```
+/storytelling src/orders/                                       # diretório completo
+/storytelling src/orders/OrderService.ts                        # arquivo específico
+/storytelling src/orders/ --depth=shallow                       # rápido — só story + inventário
+/storytelling src/orders/ --include-tests                       # incluir tests no scope
+/storytelling supabase/functions/process-payments/              # Edge Function module
+```
+
+**Quando este comando é o caminho:**
+- Você herdou módulo desconhecido (onboarding, transferência, post-acquisition)
+- Vai modificar código que não conhece
+- Pré-requisito de `/encontrar-seams` ou `/refactor-seguro`
+- Precisa identificar candidates de extract class antes de planejar refactor
+- Code review onde reviewer não conhece o módulo
+
+**Quando NÃO é o caminho:**
+- Codebase < 200 linhas — leitura direta é mais rápida
+- Você já trabalhou no módulo nas últimas 2 semanas — mental model fresco
+- Mudança trivial (typo, comment) — overhead > valor
+</context>
+
+<process>
+
+## 1. Parsear argumentos
+
+```bash
+TARGET=$(echo "$ARGUMENTS" | awk '{print $1}')
+DEPTH=$(echo "$ARGUMENTS" | grep -oE -- '--depth[= ][^ ]+' | sed 's/--depth[= ]//')
+MAX_LINES=$(echo "$ARGUMENTS" | grep -oE -- '--max-lines [0-9]+' | awk '{print $2}')
+OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')
+INCLUDE_TESTS=false
+echo "$ARGUMENTS" | grep -qE -- '--include-tests' && INCLUDE_TESTS=true
+
+[ -z "$DEPTH" ]     && DEPTH="deep"
+[ -z "$MAX_LINES" ] && MAX_LINES=1500
+
+if [ -z "$TARGET" ]; then
+  echo "ERROR: target obrigatório (arquivo ou diretório)"
+  exit 1
+fi
+
+if [ ! -e "$TARGET" ]; then
+  echo "ERROR: target não encontrado: $TARGET"
+  exit 1
+fi
+
+# auto-output path
+if [ -z "$OUTPUT_PATH" ]; then
+  SLUG=$(basename "$(realpath "$TARGET")" | sed 's/[^a-zA-Z0-9]/-/g')
+  OUTPUT_PATH=".planning/storytelling/${SLUG}.md"
+fi
+
+mkdir -p "$(dirname "$OUTPUT_PATH")"
+```
+
+## 2. Detectar tamanho
+
+```bash
+if [ -f "$TARGET" ]; then
+  TOTAL_LINES=$(wc -l < "$TARGET")
+elif [ -d "$TARGET" ]; then
+  TOTAL_LINES=$(find "$TARGET" -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.py" -o -name "*.java" -o -name "*.go" \) ! -path "*node_modules*" -exec cat {} + 2>/dev/null | wc -l)
+fi
+
+if [ "$TOTAL_LINES" -gt "$MAX_LINES" ]; then
+  echo "ℹ Target tem $TOTAL_LINES linhas (> $MAX_LINES). Agent vai chunkar análise."
+fi
+```
+
+## 3. Dispatch para `storytelling-analyst`
+
+```text
+Task(
+  subagent_type="storytelling-analyst",
+  prompt="
+target: ${TARGET}
+depth: ${DEPTH}
+output_path: ${OUTPUT_PATH}
+max_lines: ${MAX_LINES}
+include_tests: ${INCLUDE_TESTS}
+
+Aplicar skill legacy-storytelling-naked-crc. Etapas:
+1. Inventário inicial (listar files + classes/funções top-level)
+2. Leitura + síntese — produzir story em ≤ 5 frases
+3. Inventário canônico (tabela com responsabilidade primária + cluster)
+4. (depth=deep) Naked CRC sketch ASCII
+5. (depth=deep) Responsibility hot spots — classes fazendo > 3 coisas distintas
+6. (depth=deep) Abstrações ausentes (sugestões)
+7. (depth=deep) Extract class candidates priorizados
+8. Gotchas / surpresas
+9. Próximas ações sugeridas (effect sketch, /caracterizar, /refactor-seguro)
+10. Output: .planning/storytelling/<slug>.md
+
+PRINCÍPIO: você É a IA primeiro draft. Não busque perfeição — busque utilidade. Seja honesto sobre incertezas.
+"
+)
+```
+
+## 4. Pós-output
+
+```
+═══════════════════════════════════════════════════════════
+ framework ► STORYTELLING ▸ ${OUTPUT_PATH}
+═══════════════════════════════════════════════════════════
+
+[output do storytelling-analyst]
+
+## ⚠ Validação obrigatória
+
+Esta análise é PRIMEIRA PASSADA por IA. Erros possíveis:
+- Relações alucinadas (LLM "viu" colaborador que não existe)
+- Hot spots inflated (cluster coeso marcado como hot spot)
+- Sugestões fora de escopo (extract candidate com 2-week effort marcado como 3h)
+
+Cross-check OBRIGATÓRIO antes de basear decisões:
+1. **Spot-check 3-5 funções aleatórias** contra inventário (existem? responsabilidade descrita está correta?)
+2. **Confirmar colaboradores** existem (grep no codebase pelos nomes mencionados)
+3. **Validar hot spots** contra leitura humana (são realmente "fazendo demais"?)
+4. **Refinar story** se necessário; versão final em ${OUTPUT_PATH} é HUMANA, IA é primeiro draft
+
+## Próximos passos
+
+1. Validar story (5-15 min)
+2. Se vai modificar: `/encontrar-seams ${TARGET}` (se arquivo) ou `/storytelling <sub-target>` (refinar para sub-módulo)
+3. Se vai refactorar: `/refactor-seguro ${TARGET}` (chain canônico)
+4. Se vai extrair: revisar extract candidates — `/legacy refactor` por candidate
+5. Se há shotgun surgery em outros módulos relacionados: `/detectar-duplicacao src/`
+
+## Cross-suite
+
+- **/encontrar-seams** (v1.12) — story informa onde existem deps externas
+- **/caracterizar** (v1.12) — story prioriza qual hot spot caracterizar primeiro
+- **/refactor-seguro** (v1.12) — chain canônico após storytelling
+- **/detectar-duplicacao** (v1.12) — shotgun across módulos relacionados
+- **/mapear-codebase** (framework v1.7+) — comando análogo mais geral; storytelling complementa com narrativa
+```
+
+</process>
+
+<success_criteria>
+- [ ] $ARGUMENTS parseados (target obrigatório)
+- [ ] Tamanho detectado e chunking ativado se necessário
+- [ ] `storytelling-analyst` invocado via Task com depth resolvido
+- [ ] Output forwarded transparentemente
+- [ ] Warning de validação manual obrigatória emitido
+- [ ] Próximos passos sugerem encontrar-seams, caracterizar, refactor-seguro
+- [ ] Cross-references com /detectar-duplicacao, /mapear-codebase, /caracterizar
+</success_criteria>