Comece em dez minutos

Tudo o que veio antes deste capítulo tratava do caso, do esquema e da facilitação. Este capítulo trata da prática. Daqui a dez minutos, você poderá ter as habilidades assimiladas, um gatilho que se aciona sem que ninguém perceba e uma visão clara do que acontece depois que as cinco primeiras entradas forem registradas.

Instale as duas habilidades

A prática é disponibilizada como duas habilidades gratuitas no repositório TeamRetro-Skills, de código aberto sob a licença MIT:

• ai-session-retro**** redige o registro de encerramento da sessão: a análise retrospectiva em quatro partes, com referências a evidências, descrita neste guia, com um rótulo fixo de causa raiz para cada ponto de atrito e uma solução do tamanho de um bilhete para cada constatação.
• ai-retro-brief**** lê as entradas acumuladas e sintetiza o resumo de uma página para a pré-retrospectiva: atritos recorrentes classificados por frequência e custo, a distribuição das causas-raíz, se as soluções anteriores foram realmente adotadas e três ações recomendadas.

Clone o repositório e insira as habilidades na sua configuração do Claude Code. Ainda não usa o Claude Code? O pacote de prompts independente de ferramenta do repositório mantém o mesmo esquema (a mesma entrada em quatro partes, os mesmos rótulos fixos, a mesma regra de “nenhuma resposta sem uma solução”) no Cursor, no GitHub Copilot ou em qualquer agente ao qual você possa fornecer um prompt do sistema.

Torne o gatilho determinístico

Aqui está a única etapa de configuração que as equipes costumam pular e depois se arrependem. A invocação de habilidades é probabilística: se nada acionar o retro no final da sessão, o registro fica vazio sem que ninguém perceba, e seu primeiro resumo nunca terá conteúdo suficiente. A solução é adicionar um gatilho determinístico. Escolha pelo menos um desses; dois é melhor.

Um gancho de início de sessão. Adicione um SessionStartgancho .claude/settings.jsonque insira uma linha de contexto: “no final natural de uma sessão substancial, execute a habilidade ai-session-retro e salve a entrada”. É um pouco rude (ele também é acionado em sessões de dois minutos), mas é o único gatilho que não depende de ninguém se lembrar de nada.

Um comando/retro. Crie-o com.claude/commands/retro.md uma instrução curta para executar a habilidade na sessão atual, exatamente como especificado. Digitar o comando /retrono final de um branch de recurso ou de um turno de triagem o aciona sob demanda. O resultado é determinístico uma vez digitado; o ponto fraco é a memória humana, portanto, combine-o com uma das outras opções.

Uma regra de convenção. Uma frase no arquivo de contexto do escopo (CLAUDE.md / AGENTS.md) ou no SOP da equipe para escopos que não envolvam código: “Encerre toda sessão substancial assistida por IA executando o ai-session-retro e salvando a entrada.” Sem necessidade de infraestrutura; trate isso como a norma, não como o gatilho.

Trechos exatos para copiar e colar, para todos os três, estão no repositórioSETUP.md.

Como ficará sua primeira postagem

Realize uma sessão com a habilidade ativada. Ao final, o agente escreve algo como isto: uma figura real do âmbito do marketing, e não da programação, para deixar claro que a prática não se limita apenas aos desenvolvedores:

# 2026-07-16 — Monthly ads account review

**Session size:** ~25 turns, 1 deliverable
**Outcome:** shipped

## Friction
- **[missing-context]** The brief didn't say the French campaigns were
  deliberately paused for Q3; ~40 min (est.) auditing a "broken"
  campaign that was fine.
  → Fix (altitude: process): add campaign-status flags to the monthly
    brief template

## Do this first
Campaign-status flags in the brief template — kills the largest single
time sink this month.

Uma etiqueta por constatação, evidência com um custo, uma solução dimensionada para se tornar um ticket. Essa primeira leitura costuma ser o momento em que a prática faz sentido: o agente aponta algo sobre o seu trabalho que você já sabia, de certa forma, mas nunca havia colocado no papel.

Após cinco propostas, analise o briefing

Uma entrada é uma anedota; cinco é o número a partir do qual os padrões começam a fazer sentido. Após uma ou duas semanas de trabalho normal, execute o programaai-retro-brief. Ele analisa todas as entradas, classifica os atritos recorrentes, indica claramente qual grupo de causas-raíz predomina (briefing, documentação, material de trabalho, ferramentas ou o próprio agente) e verifica se as soluções propostas nas entradas anteriores foram de fato adotadas. O resultado é uma página, escrita para pessoas que estão prestes a participar de uma retrospectiva.

Em seguida, feche o ciclo; há duas maneiras de fazer isso:

• Com qualquer ferramenta de retro. O resumo é apenas um documento. Leia-o antes da reunião e adicione o(s) primeiro(s) item(ns) ao quadro que você estiver usando, incluindo notas adesivas. Todo o processo funciona dessa maneira, do início ao fim, sem o TeamRetro ou qualquer outro produto específico.
• Com o TeamRetro, o agente publica por conta própria. Se sua equipe realiza suas retrospectivas no TeamRetro, o agente pode preparar suas recomendações a partir do registro e, com a sua confirmação em cada item, enviá-las pelo servidor MCP do TeamRetro: itens em espera na fila para a sua próxima retrospectiva ou ações quando uma correção já tiver um responsável. Cada item publicado recebe o prefixo [AI retro], para que a equipe possa ver qual participante o levantou: as conclusões do agente chegam ao quadro como uma contribuição própria, em vez de você repassá-las de segunda mão.

Para onde ir a seguir

Esse é todo o ciclo: instalação, acionamento, cinco entradas, resumo, retrospectiva. Se você quiser revisar o raciocínio por trás de qualquer etapa (os rótulos, as regras de honestidade, a facilitação), o centro de guias traz links para todos os capítulos. E se você estiver enviando isso para um colega de equipe que não vai ler seis capítulos, envie a ele como coletar feedback de seus agentes de IA, a versão de 10 minutos deste guia completo.