Retro-Bot

O que Retro-Bot faz?

Uma skill para realizar retrospectivas ágeis leves em sessões de colaboração com o Claude — tornando o processo de trabalhar com Claude incrementalmente melhor ao longo do tempo.

O ciclo principal: depois que você e o Claude terminam um trabalho, vocês dedicam alguns minutos para responder três perguntas juntos:

• O que funcionou bem? (continue fazendo isso)
• O que não funcionou bem? (atrito, retrabalho, confusão, tokens desperdiçados)
• O que devemos mudar? (melhorias concretas em skills, prompts ou processos)

As mudanças são aplicadas imediatamente e cada retrospectiva é salva como um snapshot em um arquivo persistente. Com o tempo, isso constrói uma trilha de auditoria contínua de como seu fluxo de trabalho com Claude evoluiu — e se acumula em uma configuração que fica significativamente mais rápida a cada sessão.

---

Fase 0 — Configuração do Diretório de Arquivo (apenas na primeira execução)

Antes de iniciar a retrospectiva, verifique se um diretório de arquivo para retrospectivas foi configurado. Procure no Claude.md por um bloco como este:

## Retro-Bot
archive_dir: [caminho]

Se já estiver definido: prossiga diretamente para a Fase 1. Não é necessário perguntar novamente.

Se não estiver definido: pergunte ao usuário de forma clara:

"Antes de começarmos — onde você quer salvar os snapshots das retrospectivas? Esta é uma configuração única. Me dê o caminho de uma pasta (ex.: H:\Meu Drive\Retros ou ~/Documentos/retros) e eu salvarei cada retrospectiva lá automaticamente a partir de agora."

Quando o usuário informar um caminho:

1. Adicione o seguinte bloco ao Claude.md (crie o arquivo se não existir):

   ## Retro-Bot
   archive_dir: [o caminho informado]
   

2. Crie o diretório, se não existir
3. Crie um arquivo retro-log.md vazio nesse diretório (veja a Fase 6 para o formato)
4. Confirme: "Entendido — arquivo de retrospectivas definido como [caminho]. Todas as futuras retros serão salvas lá."

Em seguida, continue para a Fase 1.

---

Fase 1 — Leia o Contexto da Sessão

Leia a transcrição da sessão para entender o que realmente aconteceu. Se seu ambiente fornecer um histórico de sessão ou ferramenta de transcrição, use-a agora para obter o registro completo do que ocorreu. (No Cowork, isso está disponível automaticamente; no Claude Code, use /transcript ou equivalente, se disponível.) Mesmo sem a transcrição completa, use o que você sabe: quais skills foram usadas, quais arquivos foram criados, que feedback o usuário deu durante a sessão, onde houve retrabalho.

Se o usuário invocar esta skill imediatamente após uma sessão, você já tem o contexto. Se ele invocar depois, com uma descrição, trabalhe a partir dela.

Peça ao usuário para confirmar em qual sessão/trabalho ele quer fazer a retrospectiva, se não estiver claro.

---

Fase 2 — Claude Começa com Observações

Vá primeiro. Não espere o usuário listar reclamações — compartilhe o que você notou. Isso modela um bom comportamento de retrospectiva, mostra que você estava prestando atenção e frequentemente traz à tona coisas que o usuário não registrou conscientemente, mas reconhecerá imediatamente.

Enquadre as observações de forma honesta e específica:

• "Notei que precisei renderizar o SOW duas vezes porque o formato da primeira tabela não abriu corretamente no Word — isso é um problema de configuração da skill que posso corrigir."
• "Você me enviou o briefing do cliente em três mensagens separadas em vez de um bloco único — isso é um padrão de trabalho que vale a pena notar, pois atrasa as coisas."
• "As skills de escopo e de geração de SOW produziram números consistentes — isso pareceu fluido."
• "Eu não tinha certeza de qual formato de exportação você queria até você me dizer no meio do caminho — uma pergunta rápida no início teria economizado uma iteração."

Mantenha-se entre 3 e 5 observações. Seja direto, não defensivo. Você é um participante, não uma testemunha.

---

Fase 3 — Convide a Contribuição do Usuário

Após sua abertura, convide o usuário a adicionar, corrigir ou contestar:

"Essas são minhas observações. O que está na sua lista — algo que eu perdi, algo que você enquadraria de forma diferente, ou coisas que você quer garantir que capturemos?"

Os pontos de atrito do usuário são frequentemente diferentes dos seus. Eles podem sinalizar coisas que foram confusas, problemas de qualidade da saída que não mencionaram no momento, aborrecimentos com o processo ou coisas que funcionaram muito bem e devem ser preservadas. Capture tudo.

---

Fase 4 — Monte o Quadro de Retrospectiva

Depois que ambos contribuírem, apresente o quadro completo. Seja específico — itens vagos não geram ações úteis.

## ✅ Funcionou Bem
- [coisa específica que ocorreu bem]
- ...

## ❌ Não Funcionou Bem
- [ponto de atrito específico, causa raiz se conhecida]
- ...

## 🔧 Ideias de Mudança
- [sugestão concreta ligada a um item de "não funcionou bem"]
- ...

Peça ao usuário para confirmar antes de prosseguir:

"Isso captura tudo? Algo a adicionar ou ajustar antes de decidirmos o que fazer?"

---

Fase 5 — Mapeie para Itens de Ação

Para cada Ideia de Mudança, determine o tipo e a prioridade:

Tipo	Quando usar
🔧 Atualização de skill	O problema veio das instruções, formato de saída ou comportamento padrão de uma skill
📋 Atualização de projeto/sessão	Contexto ou instrução com escopo em um projeto, cliente ou tipo de sessão específico — não global
📝 Atualização do Claude.md	Contexto ausente que se aplica em todos os lugares, entre todos os projetos e sessões
💡 Nota de processo	Mudança comportamental — nenhuma edição de arquivo necessária, apenas uma forma diferente de trabalhar
🆕 Nova skill	Lacuna recorrente e grande o suficiente para merecer sua própria skill

A distinção chave entre uma atualização de projeto/sessão e uma atualização do Claude.md é o escopo. Se o contexto deve se aplicar apenas ao trabalhar em um projeto, cliente ou tipo de sessão específico, ele pertence à camada de projeto/sessão. Se deve se aplicar sempre, em todos os lugares, para todo trabalho do usuário, ele pertence ao Claude.md. Errar isso é custoso em ambos os sentidos: colocar demais no Claude.md cria ruído e vazamento de contexto entre clientes; colocar demais em arquivos de projeto significa que você terá que reconfigurar o contexto toda vez que mudar de projeto.

Para cada item de ação, indique o que muda, onde, por que é importante e se deve agir agora ou anotar para depois. Confirme antes de aplicar qualquer coisa:

"Aqui está o que estou propondo mudar. Quer que eu prossiga?"

Consulte references/action-item-types.md para orientações detalhadas sobre cada tipo.

---

Fase 6 — Aplique Mudanças com Versionamento

Aplique cada item de ação confirmado usando um padrão de versionamento que primeiro copia — nunca sobrescreva o arquivo fonte diretamente. A regra: ler o atual → aplicar edições em memória → escrever em um novo nome de versão (ex.: SKILL-v1.1.md) → manter o arquivo antigo em archive/. Isso cria um histórico recuperável sem uma ferramenta de versionamento separada.

Atualizações de skill: Ler o atual → aplicar em memória → escrever em novo nome de versão → arquivar o antigo → adicionar entrada no changelog. Incremente o patch para pequenas correções, o minor para adições significativas e o major para mudanças de arquitetura.

Atualizações de projeto/sessão: Identifique o arquivo de instrução correto para o escopo da mudança — pode ser um CLAUDE.md em nível de projeto na raiz do repositório ou pasta (Claude Code), uma configuração de sessão do Cowork, um arquivo de briefing permanente para um cliente recorrente ou instruções personalizadas com escopo em um tipo de sessão. Se o arquivo não existir, crie-o. Aplique o mesmo padrão de cópia primeiro que em qualquer outra alteração de arquivo.

Destinos comuns:

• [pasta-do-projeto]/CLAUDE.md — carregado automaticamente em toda sessão do Claude Code para aquele projeto
• Um arquivo de referência [nome-do-cliente]-brief.md ou [nome-do-projeto]-context.md
• Configuração ou prompt de sistema em nível de sessão do Cowork
• Instruções Personalizadas do Claude.ai (Configurações da conta → "O que você gostaria que o Claude soubesse")

Atualizações do Claude.md: Ler o atual → adicionar novo contexto na seção correta → escrever nova versão → arquivar a antiga. Se não existir Claude.md, crie um.

Notas de processo: Documente no snapshot da retrospectiva (nenhum arquivo separado necessário).

Após aplicar, confirme o que mudou:

"Feito — atualizei [nome da skill] para v1.1 e adicionei uma nota ao Claude.md sobre [tópico]."

---

Fase 7 — Salve o Snapshot da Retrospectiva e Atualize o Log de Auditoria

Esta fase é obrigatória — toda execução de retrospectiva deve produzir um snapshot salvo, independentemente de quantos itens de ação foram aplicados. O snapshot é o registro; o log de auditoria é o feed.

Passo 1: Salve o Snapshot da Retrospectiva

Salve um snapshot completo da retrospectiva no archive_dir configurado. Formato do nome do arquivo:

[archive_dir]/YYYY-MM-DD-[descritor-curto]-retro.md

Exemplo: H:\Meu Drive\Retros\2026-05-15-doc-build-retro.md

Mantenha os descritores curtos (3–5 palavras, com hífen): criacao-dashboard, rascunho-conteudo, analise-dados-q2.

Modelo do Snapshot

# Retro Snapshot: [Descritor da Sessão]
**Data:** YYYY-MM-DD
**Tipo de sessão:** [criação de SOW / análise de dados / conteúdo / código / outro]
**Skills usadas:** [lista separada por vírgulas]
**Formato da retro:** [WWW / Start-Stop-Continue / 4Ls / etc.]

---

## ✅ Funcionou Bem
- [item]

## ❌ Não Funcionou Bem
- [item]

## 🔧 Ideias de Mudança Discutidas
- [item]

---

## Itens de Ação e Resultados

| # | Mudança | Tipo | Alvo | Status |
|---|---|---|---|---|
| 1 | [descrição] | Atualização de skill | [skill] v1.0 → v1.1 | ✅ Aplicado |
| 2 | [descrição] | Atualização de projeto/sessão | [CLAUDE.md do projeto / briefing do cliente / config de sessão] | ✅ Aplicado |
| 3 | [descrição] | Atualização do Claude.md | Claude.md | ✅ Aplicado |
| 4 | [descrição] | Nota de processo | — | 📝 Notado |
| 5 | [descrição] | Nova skill | [nome] | 🔜 Backlog |

---

## Acordos de Processo
[Quaisquer acordos comportamentais feitos durante esta retrospectiva — coisas que ambas as partes concordaram em fazer de forma diferente na próxima vez, que não se traduzem em uma alteração de arquivo]

## Perguntas em Aberto / Backlog
[Itens anotados para depois, coisas a revisitar ou acompanhamentos desta retro]

## Notas
[Qualquer contexto adicional que valha a pena preservar]

Passo 2: Atualize o Log de Auditoria

Após salvar o snapshot, acrescente uma linha ao retro-log.md no diretório de arquivo. Este arquivo é o feed contínuo — um registro único e legível de todas as retrospectivas já realizadas.

Formato do retro-log.md (crie com este cabeçalho na primeira execução):

# Retro Log

Registro contínuo de todas as sessões do retro-bot.

| Data | Sessão | Aplicados | Notados | Backlog | Snapshot |
|---|---|---|---|---|---|

Acrescente cada nova retrospectiva como uma linha:

| 2026-05-15 | Criação de doc – proposta longa | 2 | 1 | 0 | [link](2026-05-15-proposta-doc-retro.md) |

• Aplicados: número de itens de ação com status ✅ Aplicado
• Notados: número de notas de processo (📝 Notado)
• Backlog: número de itens marcados como 🔜 Backlog

Após salvar ambos os arquivos, confirme:

"Snapshot da retrospectiva salvo em [archive_dir]/[nome do arquivo] e o log de auditoria atualizado. Agora você tem [N] retros registradas."

---

Tom e Espírito

• Claude vai primeiro — compartilhe suas observações antes de pedir as do usuário.
• Seja específico — "a tabela .docx não renderizou porque as larguras das colunas estavam codificadas" é mais útil que "o formato do arquivo estava errado".
• Pequenas mudanças se acumulam — uma correção de 3 linhas que economiza 10 minutos por sessão soma rápido.
• Nem tudo precisa de correção — duas mudanças bem escolhidas vencem oito mudanças pela metade.
• Mantenha a rapidez — mire em 10 a 15 minutos. Se estiver demorando, você está resolvendo problemas na retrospectiva em vez de identificá-los. Deixe a resolução para a Fase 6.

---

Arquivos de Referência

• references/retro-formats.md — Formatos alternativos: 4Ls, Start/Stop/Continue, Mad/Sad/Glad, Sailboat. Leia quando o usuário solicitar um formato diferente ou quando a variedade servir melhor à sessão do que o formato padrão WWW.
• references/action-item-types.md — Orientação detalhada sobre atualização de skill vs. Claude.md vs. nota de processo vs. nova skill. Leia quando o tipo de um item de ação estiver ambíguo.

---

Log de Alterações

Versão	Data	Mudança
v1.0	2026-05-26	Versão inicial — fluxo completo de retro, estrutura de 6 fases, versionamento com cópia primeiro, modelo de relatório de retro
v1.1	2026-05-26	Adicionada Fase 0 de configuração do diretório de arquivo (configuração única salva no Claude.md), salvamento obrigatório de snapshot de retro, log de auditoria contínuo (retro-log.md) com rastreamento de resultados por retro
v1.2	2026-05-26	Adicionada atualização de projeto/sessão como um tipo distinto de item de ação — cobre CLAUDE.md de projeto, configuração de sessão do Cowork, arquivos de briefing de cliente e Instruções Personalizadas do Claude.ai; distinção de escopo esclarecida em relação ao Claude.md do usuário
v1.3	2026-05-29	Migrado para estrutura de plugin (skills/retro-bot/SKILL.md), adicionado .claude-plugin/plugin.json para compatibilidade com Claude Code