loop-me

Grill me about specs for the workflows I want to build, within this workspace.

npx skills add https://github.com/mattpocock/skills --skill loop-me

Run a stateful /grilling session whose only output is workflow specs. Use the grilling discipline — relentless, one question at a time, a recommended answer attached to each — aimed at the vocabulary and goal below. Create, edit, and delete specs as the grilling resolves things.

The loop lens

A loop is a recurring pattern in the user's life: their career, their week, their morning, a single repeated activity. Picturing a life as loops within loops reveals how predictable its activities really are — which is what makes them worth delegating. Use the lens to find loops worth specifying, and propose ones the user hasn't noticed.

A workflow is the spec of one loop, made real. You run a workflow on a loop — the loop is its running instantiation. Workflows live in workflows/*.md and are the source of truth.

Vocabulary

A shared language, reached for only when a workflow calls for it — never a checklist. Mandate nothing structural: a workflow needs no AI, no checkpoint, and no schedule unless the grilling shows it does.

  • Trigger — what fires each run: an event (a new email, a new issue) or a schedule (every morning). Event-triggering is usually the more efficient.
  • Checkpoint — a human-in-the-loop point where the user is asked to verify or decide. Some workflows have none and run autonomously; some use no AI at all.
  • Push right — defer the checkpoint as far as it will go. Do maximal work before involving the human, so they are asked once, late, with everything prepared.
  • Brief — what a checkpoint presents: a tight, decision-ready summary — what was produced, why, and a link down to the asset itself — never the raw output. The user reads a brief, not a draft. Speed of review is imperative.

Definition of done

A workflow spec is done when an implementer agent could build it without asking a single question. Grill until then; nothing is done while a question remains.

The workspace

  • workflows/*.md — one spec per workflow.
  • NOTES.md — raw notes on the user's world: the tools they use, the channels they process, and their own terminology for both. When it is empty or thin, interview them about their world before specifying anything. Sharpen fuzzy terms into canonical ones as they surface, and record them here.

Mais skills de mattpocock

grill-me
mattpocock
Entreviste o usuário incansavelmente sobre um plano ou design até chegar a um entendimento compartilhado, resolvendo cada ramo da árvore de decisão. Use quando o usuário quiser testar um plano sob pressão, ser questionado sobre seu design ou mencionar "grill me".
researchcommunicationproject-management
improve-codebase-architecture
mattpocock
Encontre oportunidades de aprofundamento em uma base de código, informado pela linguagem de domínio em CONTEXT.md e pelas decisões em docs/adr/. Use quando o usuário quiser melhorar a arquitetura, encontrar oportunidades de refatoração, consolidar módulos fortemente acoplados ou tornar uma base de código mais testável e navegável por IA.
developmentcode-reviewapi
tdd
mattpocock
Desenvolvimento orientado a testes com ciclo red-green-refactor. Use quando o usuário quiser construir funcionalidades ou corrigir bugs usando TDD, mencionar "red-green-refactor", quiser testes de integração ou pedir desenvolvimento orientado a testes.
developmenttesting
handoff
mattpocock
Compacte a conversa atual em um documento de handoff para que outro agente possa continuar.
communicationproject-managementdocument
prototype
mattpocock
Construa um protótipo descartável para desenvolver um design antes de se comprometer com ele. Roteia entre dois ramos — um aplicativo de terminal executável para questões de estado/lógica de negócios, ou várias variações de UI radicalmente diferentes alternáveis a partir de uma rota. Use quando o usuário quiser prototipar, verificar um modelo de dados ou máquina de estado, criar um mockup de UI, explorar opções de design, ou disser "prototipe isso", "deixe-me brincar com isso", "tente alguns designs".
developmentdesigncreative
triage
mattpocock
Triar problemas através de uma máquina de estados orientada por funções de triagem. Use quando o usuário quiser criar um problema, triar problemas, revisar bugs ou solicitações de funcionalidades recebidas, preparar problemas para um agente AFK ou gerenciar o fluxo de trabalho de problemas.
developmentproject-managementcommunication
obsidian-vault
mattpocock
Pesquise, crie e gerencie notas no vault do Obsidian com wikilinks e notas de índice. Use quando o usuário quiser encontrar, criar ou organizar notas no Obsidian.
productivitydocument
edit-article
mattpocock
Edite e melhore artigos reestruturando seções, aprimorando a clareza e refinando a prosa. Use quando o usuário quiser editar, revisar ou melhorar um rascunho de artigo.
documentcreative