Pergunte ao Matt
Você não se lembra de todas as skills, então pergunte.
Um fluxo é um caminho através das skills. A maioria dos caminhos percorre um fluxo principal e duas rampas de entrada que se fundem a ele. Todo o resto é independente ou uma camada de vocabulário que roda subjacente.
O fluxo principal: ideia → entrega
A rota pela qual a maioria do trabalho passa. Você tem uma ideia e quer que ela seja construída.
-
/grill-with-docs— aprimore a ideia por meio de entrevista. Comece aqui quando você tem um codebase: é stateful, retendo o que aprende emCONTEXT.mde ADRs. (Sem codebase? Use/grill-me— veja Independentes. Ambos executam a mesma primitiva/grilling;grill-with-docsé aquele que deixa um rastro documental.) -
Ramificação — você consegue resolver todas as perguntas em conversa? Se uma pergunta precisa de uma resposta executável (estado, lógica de negócio, uma UI que você precisa ver), desvie por um protótipo, conectado por
/handoffem ambas as direções (veja Cruzando sessões):/handoffpara fora, então abra uma nova sessão contra aquele arquivo,/prototypepara responder à pergunta com código descartável,/handoffde volta com o que aprendeu, e referencie-o a partir do tópico da ideia original.
-
Ramificação — isso é uma construção de múltiplas sessões?
- Sim →
/to-prd(transforme o tópico em um PRD) →/to-issues(divida o PRD em issues independentemente selecionáveis). Como as issues são independentes, limpe o contexto entre cada uma: inicie uma nova sessão por issue e execute/implementpassando o PRD e a única issue para trabalhar. - Não →
/implementaqui mesmo, na mesma janela de contexto.
De qualquer forma,
/implementconstrói cada issue dirigindo/tddinternamente — uma fatia vermelho-verde de cada vez — e depois finaliza executando/code-review, uma revisão em dois eixos (Padrões + Especificação) do diff, antes de commitar. Recorra a/tddpor conta própria quando você só quiser construir um comportamento concreto test-first sem uma especificação completa, e/code-reviewpor conta própria sempre que quiser revisar um branch ou PR contra um ponto fixo. - Sim →
Higiene de contexto
Mantenha os passos 1–3 em uma janela de contexto ininterrupta — não compacte ou limpe até depois de /to-issues — para que a entrevista, o PRD e as issues sejam construídos sobre o mesmo raciocínio. Cada /implement então começa do zero, trabalhando a partir da issue.
O limite para isso é a zona inteligente: a janela (~120k tokens em modelos de ponta) dentro da qual o modelo ainda raciocina com clareza. Se uma sessão se aproximar desse limite antes de /to-issues, não force com qualidade degradada — use /handoff e continue em um novo tópico.
Rampas de entrada
Uma situação inicial que gera trabalho e depois se funde ao fluxo principal.
-
Bugs e solicitações se acumulando →
/triage. Ela move issues através de funções de triagem e produz issues prontas para agente, que/implementdepois coleta.A triagem é apenas para issues que você não criou — relatórios de bug, solicitações de funcionalidade recebidas, qualquer coisa que chegue bruta. Issues que
/to-issuesproduziu já estão prontas para agente, então não as trie. -
Algo quebrou →
/diagnosing-bugs. Para os difíceis: o bug que resiste a um primeiro olhar, a falha intermitente, a regressão que se insinuou entre dois estados conhecidamente bons. Ela se recusa a teorizar até ter um ciclo de feedback apertado — um comando que já falha neste bug — e então corrige com um teste de regressão. Sua análise post-mortem repassa para/improve-codebase-architecturequando a verdadeira descoberta é que não há uma boa junção para fixar o bug.
Saúde do codebase
Não é trabalho de funcionalidade — é manutenção.
/improve-codebase-architecture— execute sempre que tiver um momento livre para manter o codebase bom para agentes operarem. Ela revela oportunidades de aprofundamento; escolher uma gera uma ideia que você pode levar para o fluxo principal em/grill-with-docs. É o levantamento que encontra os candidatos;/codebase-design(abaixo) é a bancada onde você projeta o escolhido.
Vocabulário subjacente
Duas referências invocadas pelo modelo que rodam abaixo das outras skills — cada uma é a fonte única de verdade para seu vocabulário. Recorra a elas diretamente quando as palavras, não o processo, são o problema; ou deixe que as skills acima as puxem.
/domain-modeling— aprimore a linguagem de domínio do projeto: desafie um termo vago, resolva uma palavra sobrecarregada ("conta" fazendo três trabalhos), registre uma decisão difícil de reverter como um ADR. É a disciplina ativa que/grill-with-docsimpulsiona para manterCONTEXT.mdcomo um glossário limpo./codebase-design— o vocabulário de módulo profundo (módulo, interface, profundidade, junção, adaptador, alavancagem, localidade) para projetar a forma de um módulo: muito comportamento por trás de uma interface pequena em uma junção limpa./tdde/improve-codebase-architectureambos falam essa linguagem.
Cruzando sessões
/handoff— quando um tópico está cheio ou você precisa ramificar (por exemplo, em uma sessão/prototype), isso compacta a conversa em um arquivo markdown. Você não continua no lugar — você abre uma nova sessão e referencia aquele arquivo para carregar o contexto adiante. É a ponte entre janelas de contexto, em ambas as direções. Use-o quando quiser uma sessão nova mas precisar da conversa atual preservada./compact(embutido) — permaneça na mesma conversa, permitindo que as trocas anteriores sejam resumidas. Use-o em pausas intencionais entre fases, quando não se importar em perder o histórico verbatim. Não compacte no meio de uma fase — o agente pode perder o rumo./handoffbifurca;/compactcontinua.
Independentes
Fora do fluxo principal completamente.
/grill-me— a mesma entrevista implacável que/grill-with-docs, mas para quando você não tem codebase. Sem estado: não salva nada localmente, não constróiCONTEXT.md. Recorra a ela para aprimorar qualquer plano ou design que não viva em um repositório./prototype— um programa pequeno e descartável que responde a uma pergunta de design: esse modelo de estado parece certo, ou qual deveria ser a aparência desta UI. Descartável desde o primeiro dia — guarde a resposta, delete o código. É o desvio no passo 2 do fluxo principal, mas recorra a ele sempre que uma pergunta de design for difícil de resolver no papel./research— delegue o trabalho de leitura a um agente em segundo plano: ele investiga uma pergunta contra fontes primárias e depois deixa um arquivo Markdown citado no repositório. Continue trabalhando enquanto ele lê. O arquivo que ele produz é algo para levar para o fluxo principal em/grill-with-docs— a pesquisa alimenta o pensamento, não o substitui./teach— aprenda um conceito ao longo de múltiplas sessões, usando o diretório atual como um workspace com estado./writing-great-skills— referência para escrever e editar skills bem.
Pré-condição
/setup-matt-pocock-skills — execute antes do seu primeiro fluxo de engenharia para configurar o rastreador de issues, os rótulos de triagem e o layout de documentos que as outras skills assumem. Rastreadores de issues personalizados também funcionam.