skills

Sincroniza este repositório com um novo release do upstream (mattpocock/skills), adaptando as mudanças para pt-BR em vez de copiá-las. Use quando sair um release novo no upstream ou quando uma issue de "Sync upstream" for aberta pelo workflow check-upstream.

Pergunte qual skill ou fluxo encaixa na sua situação. Um router sobre as skills deste repo.

Revisa as mudanças desde um ponto fixo (commit, branch, tag ou merge-base) em dois eixos — Standards (o código segue os padrões de codificação documentados deste repo?) e Spec (o código faz o que a issue/spec de origem pediu?). Roda as duas revisões em sub-agents paralelos e reporta lado a lado. Use quando o usuário quiser revisar um branch, um PR, mudanças em andamento, ou pedir para "revisar desde X".

Implementa um pedaço de trabalho baseado em uma spec ou conjunto de tickets.

Constrói um prototype descartável para responder a uma pergunta de design. Use quando o usuário quiser checar se um modelo de estado ou uma lógica faz sentido, ou explorar como uma UI deveria ser.

Investiga uma pergunta contra fontes primárias de alta confiança e registra os achados como um arquivo Markdown no repo. Use quando o usuário quiser um tema pesquisado, fatos de docs ou de API reunidos, ou o trabalho braçal de leitura delegado a um background agent.

Configura este repo para as engineering skills — configura seu issue tracker, vocabulário de triage labels e layout de docs de domínio. Rode uma vez antes do primeiro uso das outras engineering skills.

Test-driven development. Use quando o usuário quiser construir features ou corrigir bugs test-first, mencionar "red-green-refactor", ou quiser testes de integração.

Transforma a conversa atual em uma spec e publica no issue tracker do projeto — sem entrevista, só síntese do que você já discutiu.

Quebra um plano, spec ou a conversa atual em um conjunto de tickets tracer-bullet, cada um declarando suas blocking edges, publicados no tracker configurado — edges como texto num arquivo local, ou links de blocking nativos num tracker de verdade.

Move issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.

Planeja um pedaço enorme de trabalho — maior do que uma sessão de agent consegue segurar — como um mapa compartilhado de tickets de investigação no seu issue tracker, e resolve um ticket por vez até que o caminho até o destino esteja claro.

Passa a conversa atual para um background agent novo, que retoma o trabalho imediatamente.

Gera um wizard bash interativo que conduz um humano por um procedimento manual — setup de terceiros, uma migração pontual, uma transição de estado A→B — abrindo URLs, capturando valores, confirmando cada passo e escrevendo arquivos .env e secrets do GitHub Actions.

Roteador do ciclo completo de desenvolvimento — da ideia à entrega — encadeando grilling, to-spec, to-tickets, triage, implement e code-review com regras explícitas de dimensionamento, decomposição e despacho de agentes.

Grill o usuário sem dó sobre um plano ou design. Use quando o usuário quiser stress-test de um plano antes de construir, ou usar qualquer frase-gatilho de 'grill'.

Referência para escrever e editar skills bem — o vocabulário e princípios que tornam uma skill previsível.

Vocabulário compartilhado para projetar módulos profundos (deep modules). Use quando o usuário quiser projetar ou melhorar a interface de um módulo, encontrar oportunidades de deepening, decidir onde colocar um seam, tornar o código mais testável ou navegável por IA, ou quando outra skill precisar do vocabulário de deep-module.

Loop de diagnóstico para bugs difíceis e regressões de performance. Use quando o usuário disser "diagnose"/"debug this", ou relatar algo quebrado/lançando/falhando/lento.

Constrói e afia o modelo de domínio de um projeto. Use quando o usuário quiser fixar terminologia de domínio ou uma ubiquitous language, registrar uma decisão arquitetural, ou quando outra skill precisar manter o modelo de domínio.

Uma entrevista implacável para afiar um plano ou design, que também cria docs (ADRs e glossário) conforme avançamos.

Escaneia uma codebase em busca de oportunidades de deepening, apresenta como relatório HTML visual e depois sabatina a escolhida.

Use quando precisar resolver um conflito de git merge/rebase em andamento.