MÓDULO 2.5

📊 A Fase de Sumarização

Por que o ciclo precisa de uma fase final que mostra o que aconteceu — em vez de terminar em silêncio. A diferença entre confiança e dúvida.

Sumarização

Sem sumarização: silêncio. Com sumarização: clareza.

1

🤔 O problema do silêncio

Imagina: você roda /claudex plan, espera 10 minutos, e o terminal volta pra prompt sem nada. Como saber se foi bem? Quantas rodadas rodaram? Quantos achados? Esse é o problema do silêncio — e a sumarização é a resposta dele.

😨 Sintomas do silêncio

  • • "Será que rodou direito?"
  • • "Quantas rodadas aconteceram?"
  • • "Algum achado importante?"
  • • "Posso confiar pra executar?"
  • • "Tem que abrir todos os findings.md pra saber?"
2

🔇 Sem sumarização (versão antiga)

$ /claudex plan adicionar expiração para links

[... 8 minutos depois ...]

$ █

Cursor pisca. Terminal vazio. Você não sabe se algo aconteceu, se travou, se faltou conta de tokens. Tem que ir investigar manualmente em .claude/claudex/.

3

📢 Com sumarização

═══════════════════════════════════════════
   CLAUDEX — CICLO CONCLUÍDO
═══════════════════════════════════════════

Tópico: "adicionar expiração para links curtos"
Rodadas: 3 de 3
Tempo total: 8min 42s

Achados:
  R1 (Engenheiro): 2 alto · 2 médio · 2 baixo
  R2 (Segurança):  1 alto · 3 médio · 1 baixo
  R3 (Ops/SRE):    1 alto · 2 médio · 0 baixo

Total: 14 achados — 13 integrados · 1 descartado

PLAN.md:
  Versão inicial: 22 linhas, 4 seções
  Versão final:   58 linhas, 7 seções

✅ PLANO TRAVADO — pronto para execução

Quase os mesmos 8 minutos — mas no final você tem clareza completa do que aconteceu.

4

📋 O que é exibido

Identidade

Tópico do ciclo · número de rodadas executadas · tempo total

Achados por rodada

Quantos por persona, classificados por severidade

Integração

Quantos achados foram integrados · quantos descartados (com nota)

Crescimento do plano

Linhas/seções iniciais vs finais · onde cresceu

Status final

PLANO TRAVADO · ou pendências, ou cancelado

Próximo passo

"Pronto para execução" ou ação manual sugerida

5

💡 Por que dar clareza

A clareza não é só estética. Ela é funcional: define se você confia o suficiente pra executar o plano em produção.

Engenheiros experientes sabem: se a ferramenta termina sem feedback claro, o cérebro humano presume que algo deu errado. Mesmo sem evidência. Sumarização explícita reverte essa presunção.

6

⚖️ Confiança vs. dúvida

😨 Saída sem sumarização

  • • "Será que terminou mesmo?"
  • • "Vou abrir os findings pra ver"
  • • "Dúvida sobre executar"
  • • Reduzido o ROI do Claudex

😎 Saída com sumarização

  • • "14 achados, 13 integrados — bom"
  • • "Posso executar com confiança"
  • • "Próximo passo claro"
  • • ROI completo

A sumarização multiplica o valor de todo o ciclo. Sem ela, mesmo um ciclo perfeito gera dúvida. Com ela, mesmo um ciclo modesto gera confiança.

📌 Resumo

✓
Silêncio gera dúvida — terminar sem feedback é pior do que falhar.
✓
Sumarização é a fase final — exibe tudo num bloco legível.
✓
6 informações essenciais — tópico, rodadas, achados, integração, crescimento, status.
✓
Funcional, não estética — define se você confia para executar.
✓
Multiplica o ROI — ciclo perfeito sem sumarização gera dúvida; ciclo modesto com sumarização gera confiança.
✓
Status final claro — PLANO TRAVADO ou ação manual sugerida.

Próximo Módulo:

2.6 — 🔁 O Ciclo Completo Passo a Passo

← AnteriorPróximo →