Brag document a partir do histórico git
Objetivo: transformar o que você realmente entregou em um rascunho editável, sem inventar impacto. Um brag document lista trabalho e resultados; esta skill coleta o trabalho e marca cada resultado ausente como uma lacuna para você preencher.
Etapa 1: coletar as evidências
Pergunte pela janela de tempo (padrão: os últimos 6 meses) e pelos repositórios. Depois, com o GitHub CLI autenticado:
gh search prs --author @me --merged --merged-at ">=YYYY-MM-DD" --json title,url,closedAt,repository --limit 200
Para código fora do GitHub, use git log --author="<nome ou email>" --since="YYYY-MM-DD" --no-merges --pretty="%h %ad %s" --date=short em cada repositório. Pergunte também ao usuário para colar qualquer coisa que o git não possa mostrar: incidentes tratados, mentoria, revisões realizadas, palestras, documentações, plantão, decisões de design, elogios de colegas.
Não leia repositórios privados que o usuário não nomeou. Não adivinhe nomes, equipes ou números.
Etapa 2: agrupar, ainda não resumir
Agrupe os itens em temas (por exemplo: confiabilidade, novos recursos, performance, ferramentas, mentoria, trabalho entre equipes). Liste cada item sob seu tema com data e link. Mescle duplicatas (um PR de funcionalidade mais suas correções posteriores).
Etapa 3: rascunhar cada tema
Para cada tema, escreva:
- O que fiz: uma ou duas frases em verbos simples, usando apenas o que os títulos, diffs e notas do usuário suportam.
- Resultado: somente se um número, citação ou desfecho foi fornecido. Caso contrário, escreva
[GAP: o que mudou para os usuários ou para a equipe? alguma métrica antes/depois?]. - Evidência: links.
- Sinal de escopo (se houver suporte): liderei, fiz sozinho, trabalhei entre equipes, estive de plantão, revisei outros.
Etapa 4: finalizar com lacunas e perguntas
Termine com uma lista de cada [GAP], ranqueada por quanto fortaleceria o argumento, e as três perguntas cujas respostas agregariam mais. Ofereça-se para transformar a versão final em uma autoavaliação, um resumo de promoção ou bullets de currículo.
Regras
- Nunca invente métricas, porcentagens, nomes de clientes, títulos ou escopo. Uma lacuna visível é melhor que um número inventado.
- Não inflacione: "contribuí para" permanece "contribuí para". Associe os verbos às evidências.
- Mantenha o crédito do usuário honesto: se um PR foi um esforço de equipe, diga qual parte foi dele.
- Mantenha detalhes privados ou confidenciais fora do documento, a menos que o usuário diga que o documento é interno.
- Saída em Markdown que o usuário possa colar em suas anotações.