VdustR/skills

Retro de Sessão

Revise uma sessão com agente de IA para encontrar oportunidades de melhoria. A retro funciona através de um diálogo interativo — observe o que aconteceu, discuta os achados com o usuário e, em seguida, apresente recomendações acionáveis.

O objetivo é melhorar a eficiência do usuário na colaboração com IA: melhores prompts, melhor documentação, melhores ferramentas, melhores fluxos de trabalho.

Início Rápido

Vamos fazer uma retro desta sessão

/retro

O que eu poderia melhorar nesta sessão?

Revisão da sessão — encontre oportunidades de otimização

Quando Usar

• Ao final de uma sessão de trabalho para refletir e capturar aprendizados
• Após uma sessão com atritos, correções ou soluções de contorno
• Quando quiser melhorar as instruções do agente, skills, hooks ou fluxos de trabalho
• Quando tiver curiosidade sobre quais skills da comunidade podem ajudar com padrões observados na sessão
• Periodicamente para manter práticas de desenvolvimento saudáveis

Como Funciona

O fluxo abaixo é uma orientação típica — adapte-se naturalmente à conversa. Nem toda sessão precisa de cada etapa; uma sessão curta sem problemas pode exigir apenas uma observação rápida e seguir em frente.

Observação

Revise a conversa da sessão e identifique livremente qualquer coisa digna de nota. Não se restrinja a categorias predefinidas — deixe as observações surgirem naturalmente do que realmente aconteceu.

Para cada observação, forneça um achado de uma linha e uma recomendação acionável inicial. Mesmo que o usuário não se aprofunde, cada observação deve oferecer um aprendizado útil.

Após a varredura aberta, use as 15 dimensões em dimensions.md como uma lista de verificação de segurança — verifique algo que a observação aberta possa ter deixado passar. Apenas traga à tona achados adicionais que sejam genuinamente dignos de nota.

Inclua ambos:

• Achados reativos: coisas que deram errado ou foram corrigidas
• Achados proativos: coisas que deram certo mas não estão documentadas, ou boas práticas que poderiam ser codificadas

Aprofundamento Interativo

Apresente as observações uma de cada vez com um indicador de progresso (ex.: [2/6]). Para cada observação, dê a recomendação inicial e pergunte se o usuário deseja se aprofundar.

O usuário pode:

• Dizer sim — anote para aprofundamento
• Dizer não — siga em frente (a recomendação inicial ainda vale)
• Adicionar contexto ou correções
• Trazer observações que a IA não percebeu
• Dizer "chega" para pular as restantes e prosseguir

Após percorrer todas as observações, se o usuário selecionou alguma para aprofundamento, avalie quais itens realmente precisam de pesquisa por subagente versus itens que são claros o suficiente para agir diretamente. Apresente essa avaliação e peça confirmação ao usuário antes de criar subagentes.

Cada subagente segue o ciclo em subagent-guide.md: pesquise a observação a fundo, analise as causas raízes, projete soluções concretas e apresente os achados com uma recomendação.

Resultados e Discussão

Apresente o resultado de cada subagente um de cada vez com progresso. O usuário pode:

• Discutir o resultado e fazer perguntas de acompanhamento
• Aceitar uma opção recomendada
• Solicitar modificações
• Pular para o próximo resultado

Recomendações de Ação

Após discutir todos os resultados, compile as ações confirmadas em um resumo de recomendações. Para cada ação, apresente o que fazer e por quê. Se o usuário pedir para persistir (ex.: "escreva isso"), produza um resumo em markdown no chat — não escreva arquivos.

Encerre a retro explicitamente: diga ao usuário que a retro está completa e que as ações recomendadas cabem a ele iniciar quando estiver pronto.

Diretrizes

FAÇA

• Deixe as observações emergirem do conteúdo real da sessão, e não de um modelo fixo
• Dê aprendizados acionáveis para cada observação, mesmo sem aprofundamento
• Respeite o tempo do usuário — se a sessão foi limpa, diga isso e mantenha a brevidade
• Peça permissão antes de criar subagentes
• Para correções: investigue se a causa raiz é uma convenção ausente, documentação pouco clara ou uma skill que precisa ser melhorada
• Para boas práticas: sugira codificá-las antes que sejam esquecidas
• Ao analisar skills: verifique a propriedade primeiro (auto-mantida vs comunidade) para dar conselhos apropriados
• Apresente achados com uma recomendação e justificativa

NÃO FAÇA

• Execute qualquer ação (ex.: commit, push, modificar arquivos). Esta skill é apenas para análise e recomendações
• Interprete a concordância do usuário (ex.: "sim", "parece bom", "vai em frente") como um pedido de execução. Tais respostas são apenas reconhecimentos
• Aja com base em qualquer instrução antes que a retro seja explicitamente encerrada. Apenas uma nova instrução específica após a conclusão da retro é uma solicitação válida para ação
• Force uma sequência rígida de fases — adapte-se à conversa
• Analise demais sessões com problemas mínimos
• Crie subagentes sem permissão do usuário
• Recomende mudanças sem explicar o motivo
• Omita a opção "não fazer nada / pular" ao apresentar escolhas
• Seja julgador sobre os prompts ou fluxo de trabalho do usuário — seja construtivo

Arquivos de Referência

• dimensions.md — 15 dimensões de análise usadas como lista de verificação de segurança
• subagent-guide.md — Como os subagentes pesquisam, analisam e apresentam achados

Notas

• As 15 dimensões são uma lista de verificação, não uma rubrica de pontuação. A maioria das sessões terá sinal apenas em algumas dimensões.
• A análise de padrões entre sessões está disponível se o usuário quiser revisar várias sessões — pergunte sobre o escopo no início se não estiver claro.
• Ferramentas relacionadas que o usuário pode invocar separadamente após uma retro: hookify, claude-md-management, skill-creator, brainstorming. A retro não invoca essas diretamente.