docs(pt-BR): add commands translation

docs/pt-BR/commands/refactor-clean.md

@@ -0,0 +1,80 @@
+# Refactor Clean
+
+Identifique e remova código morto com segurança, com verificação de testes em cada passo.
+
+## Passo 1: Detectar Código Morto
+
+Rode ferramentas de análise com base no tipo do projeto:
+
+| Tool | What It Finds | Command |
+|------|--------------|---------|
+| knip | Unused exports, files, dependencies | `npx knip` |
+| depcheck | Unused npm dependencies | `npx depcheck` |
+| ts-prune | Unused TypeScript exports | `npx ts-prune` |
+| vulture | Unused Python code | `vulture src/` |
+| deadcode | Unused Go code | `deadcode ./...` |
+| cargo-udeps | Unused Rust dependencies | `cargo +nightly udeps` |
+
+Se nenhuma ferramenta estiver disponível, use Grep para encontrar exports com zero imports:
+```
+# Find exports, then check if they're imported anywhere
+```
+
+## Passo 2: Categorizar Achados
+
+Classifique os achados em níveis de segurança:
+
+| Tier | Examples | Action |
+|------|----------|--------|
+| **SAFE** | Unused utilities, test helpers, internal functions | Delete with confidence |
+| **CAUTION** | Components, API routes, middleware | Verify no dynamic imports or external consumers |
+| **DANGER** | Config files, entry points, type definitions | Investigate before touching |
+
+## Passo 3: Loop de Remoção Segura
+
+Para cada item SAFE:
+
+1. **Rode a suíte completa de testes** — Estabeleça baseline (tudo verde)
+2. **Delete o código morto** — Use a ferramenta Edit para remoção cirúrgica
+3. **Rode a suíte de testes novamente** — Verifique se nada quebrou
+4. **Se testes falharem** — Reverta imediatamente com `git checkout -- <file>` e pule este item
+5. **Se testes passarem** — Vá para o próximo item
+
+## Passo 4: Tratar Itens CAUTION
+
+Antes de deletar itens CAUTION:
+- Procure imports dinâmicos: `import()`, `require()`, `__import__`
+- Procure referências em string: nomes de rota, nomes de componente em configs
+- Verifique se é exportado por API pública de pacote
+- Verifique ausência de consumidores externos (dependents, se publicado)
+
+## Passo 5: Consolidar Duplicatas
+
+Depois de remover código morto, procure:
+- Funções quase duplicadas (>80% similares) — mesclar em uma
+- Definições de tipo redundantes — consolidar
+- Funções wrapper sem valor — inline
+- Re-exports sem propósito — remover indireção
+
+## Passo 6: Resumo
+
+Reporte resultados:
+
+```
+Dead Code Cleanup
+──────────────────────────────
+Deleted:   12 unused functions
+           3 unused files
+           5 unused dependencies
+Skipped:   2 items (tests failed)
+Saved:     ~450 lines removed
+──────────────────────────────
+All tests passing ✅
+```
+
+## Regras
+
+- **Nunca delete sem rodar testes antes**
+- **Uma remoção por vez** — Mudanças atômicas facilitam rollback
+- **Se houver dúvida, pule** — Melhor manter código morto do que quebrar produção
+- **Não refatore durante limpeza** — Separe responsabilidades (limpar primeiro, refatorar depois)