Pergunte ao Matt

Quando Usar

Use quando este fluxo de trabalho corresponder à solicitação do usuário: Pergunte qual habilidade ou fluxo se encaixa na sua situação. Um roteador sobre as habilidades invocadas pelo usuário neste repositório.

Fonte: mattpocock/skills (MIT).

Você não se lembra de todas as habilidades, então pergunte.

Um fluxo é um caminho através das habilidades. A maioria dos caminhos segue um fluxo principal, e duas entradas se juntam a ele. Todo o resto é autônomo.

O fluxo principal: ideia → entrega

A rota pela qual a maior parte do trabalho viaja. Você tem uma ideia e quer que ela seja construída.

1. /grill-with-docs — refine a ideia por meio de entrevista. Comece aqui quando você tiver uma base de código: ela é stateful, retendo o que aprende em CONTEXT.md e ADRs. (Sem base de código? Use /grill-me — veja Autônomo.)
2. Ramificação — você consegue resolver todas as perguntas em uma conversa? Se uma pergunta precisar de uma resposta executável (estado, lógica de negócios, uma interface de usuário que você precisa ver), desvie para um protótipo, interligado por /handoff em ambas as direções (veja Cruzando sessões):
   • /handoff para fora, depois abra uma nova sessão para aquele arquivo,
   • /prototype para responder à pergunta com código descartável,
   • /handoff de volta o que você aprendeu e referencie-o a partir do tópico da ideia original.
3. Ramificação — isto é uma construção de várias sessões?
   • Sim → /to-prd (transforme o tópico em um PRD) → /to-issues (divida o PRD em issues que podem ser pegas independentemente). Como as issues são independentes, contexto claro entre cada uma: comece uma nova sessão por issue e inicie /implement passando o PRD e a única issue a ser trabalhada.
   • Não → /implement aqui mesmo, na mesma janela de contexto.

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 o interrogatório, o PRD e as issues se baseiem no 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 nos modelos de ponta) dentro da qual o modelo ainda raciocina de forma aguçada. Se uma sessão se aproximar dela antes de /to-issues, não force o que está degradado — /handoff e continue em um novo tópico.

Entradas

Uma situação inicial que gera trabalho e depois se junta ao fluxo principal.

• Bugs e solicitações se acumulando → /triage. Ele move as issues através das funções de triagem e produz issues prontas para o agente, que /implement pega mais tarde.

  A triagem é apenas para issues que você não criou — relatórios de bugs, solicitações de recursos recebidas, qualquer coisa que chegue crua. As issues que /to-issues produziu já estão prontas para o agente, então não as trie.

Saúde da base de código

Não é trabalho de recursos — é manutenção.

• /improve-codebase-architecture — execute sempre que tiver um momento livre para manter a base de código boa para os agentes operarem. Ele revela oportunidades crescentes; escolher uma gera uma ideia que você pode levar para o fluxo principal em /grill-with-docs.

Cruzando sessões

• /handoff — quando um tópico está cheio ou você precisa se ramificar (por exemplo, para 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 esse arquivo para transportar o contexto. É a ponte entre janelas de contexto, em qualquer direção. Use-o quando quiser uma nova sessão, mas precisar que a conversa atual seja preservada.
• /compact (integrado) — permaneça na mesma conversa, permitindo que as voltas anteriores sejam resumidas. Use-o em pausas intencionais entre fases, quando você não se importa em perder o histórico exato. Não compacte no meio de uma fase — o agente pode se perder. /handoff cria um fork; /compact continua.

Autônomo

Completamente fora do fluxo principal.

• /grill-me — a mesma entrevista implacável de /grill-with-docs, mas para quando você não tem uma base de código. Stateless: não salva nada localmente, não constrói nenhum CONTEXT.md. Use-o para refinar qualquer plano ou design que não esteja em um repositório.
• /teach — aprenda um conceito ao longo de várias sessões, usando o diretório atual como um espaço de trabalho stateful.
• /writing-great-skills — referência para escrever e editar habilidades 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 documentação que as outras habilidades assumem. Rastreadores de issues personalizados também funcionam.

Exemplo

Solicitação do usuário:

…