Rodadas, não fila
O novo grilling pergunta em cada rodada toda a fronteira de decisões cujos pré-requisitos já foram resolvidos.
01 / SINAL
O tweet diz exatamente o que o GitHub confirma.
“/grill-me and /grill-with-docs are changing. No more ‘one question at a time’ — now it asks questions in rounds. Faster, less token spend, but still keeps dependencies between questions clear. Shipping in v1.2.”Matt Pocock, 17 jul 2026 · tweet original
13 → ~3 rodadas
A changeset usa esse exemplo: a mesma árvore de 13 perguntas, preservando dependências, em aproximadamente três rodadas.
PR draft
Matt respondeu “It’s in a PR”. A tag mais recente continua sendo v1.1.0.
02 / MAC
O desenho do Fable já resolve metade do problema.
Fonte de configuração~/agents-config/shared/
AGENTS.md + skills pessoais compartilhadas.
→
Skills canônicas~/agents-config/shared/skills
22 skills promovidas instaladas da release/v1.2. ~/.agents/skills e ~/.claude/skills apontam para cá.
→
ConsumidoresClaude Code
Codex
Pi
Codex
Pi
Regras universais compartilhadas; detalhes de cada harness ficam fora delas.
Fonte única real
~/.codex/AGENTS.md e o AGENTS do Pi apontam para o mesmo arquivo; o Claude usa um shim de uma linha importando esse AGENTS. O desenho evita duplicação e mantém procedimentos em skills.
~/.codex/skills
Não transforme esse diretório em symlink nem coloque ali as skills compartilhadas. Ele contém .system. O Codex descobre a store compartilhada diretamente em ~/.agents/skills.
1e90cf9; as 22 skills pré-release foram registradas no commit assinado 499fcb5, com a origem upstream release/v1.2@9c326299 gravada na mensagem.03 / SETUP
O caminho seguro para este Mac.
Proteja a baseline
Versione ~/agents-config e documente a restauração dos symlinks. Não inclua integralmente ~/.codex/config.toml ou ~/.claude.json: eles misturam estado local, plugins, IDs e paths.
Instale pela CLI universal, globalmente
A documentação upstream usa npx; neste Mac, a política é pnpm, então use o equivalente abaixo. O alvo explícito é Claude Code porque a instalação global popula a store canônica ~/.agents/skills, que o Codex já lê diretamente.
pnpm dlx skills@latest add mattpocock/skills \ --global \ --agent claude-code
Inclua setup-matt-pocock-skills e selecione symlink. Não use --all: o repo também contém material in-progress, deprecated, misc e personal. Em um Mac sem a topologia do Fable, o comando genérico teria também --agent codex.
A topologia distribui sozinha
~/.claude/skills e ~/.agents/skills já resolvem para a mesma store física. O Claude enxerga o primeiro; o Codex, segundo o manual oficial atual, lê $HOME/.agents/skills e suporta diretórios de skill symlinkados. Nada precisa ser adicionado ao diretório .system.
Verifique antes de confiar
pnpm dlx skills@latest ls --global readlink ~/.agents/skills readlink ~/.claude/skills
Reabra sessões dos agentes e confira se as skills aparecem. No Claude, invoque /setup-matt-pocock-skills; no Codex, use $setup-matt-pocock-skills.
Rode o setup uma vez por repositório
Essa etapa configura tracker, labels e local dos documentos do projeto. Ela é por repo de propósito; não deve engrossar o AGENTS global com escolhas específicas de um projeto.
Um ciclo para os dois
pnpm dlx skills@latest update --global
No thread, Matt respondeu duas vezes que skills update é o caminho oficial.
Plugin Claude + CLI Codex
Funciona, mas cria duas filosofias de distribuição e dois ciclos de update. O plugin nativo do Codex ainda está no roadmap.
04 / SELEÇÃO
Quais skills instalar? As 22 promovidas.
22
Minha recomendação para vocêInstale o conjunto curado inteiro do manifest oficial. Ele funciona como um sistema de workflows com dependências internas; selecionar apenas as skills “famosas” deixa rotas quebradas. Evite
--all, porque a descoberta do repositório também encontra rascunhos, conteúdo pessoal, deprecated e experimentos.Maior retorno no uso diário
setup-matt-pocock-skills— prepara tracker, labels e docs uma vez por repositório.ask-matt— o roteador. Você descreve a situação e ele aponta a skill ou fluxo correto.grill-with-docs/grill-me— o primeiro para trabalho em codebase, com glossary/ADRs; o segundo para decisões sem repo.diagnosing-bugs— cria feedback loop antes de teorizar e fecha com regression test.research— delega leitura de fontes primárias a um subagente e salva um relatório citado.handoff— atravessa sessões sem carregar um contexto gigante ou perder decisões.implement+tdd+code-review— cadeia de execução: red/green e revisão paralela Standards × Spec.
Ideia → entrega
Esse é o núcleo operacional descrito pelo próprio ask-matt.
grill-with-docsgrillingdomain-modelingprototypehandoffto-specto-ticketsimplementtddcode-review
Uso recorrente
ask-mattgrill-meresearchdiagnosing-bugs
Fluxos especializados
triagewayfinderresolving-merge-conflicts
Arquitetura e linguagem
improve-codebase-architecturecodebase-design
Aprender e criar skills
teachwriting-great-skillssetup-matt-pocock-skills
As 22 do manifest oficial
ask-mattdiagnosing-bugsgrill-with-docstriageimprove-codebase-architecturesetup-matt-pocock-skillstddto-specto-ticketswayfinderimplementprototyperesearchdomain-modelingcodebase-designcode-reviewresolving-merge-conflictsgrill-megrillinghandoffteachwriting-great-skills
No instalador interativo, selecione exatamente estes nomes. Esta é a lista curada em .claude-plugin/plugin.json; ela exclui os diretórios que Matt ainda não promoveu.
setup-matt-pocock-skills, grill-me, grilling, grill-with-docs, domain-modeling, diagnosing-bugs, research, handoff, prototype, implement, tdd e code-review. Nesse modo, deixe ask-matt para depois, porque o roteador pressupõe que o conjunto completo esteja disponível.05 / SPOILER
A v1.2 já está exposta — mas ainda é pré-release.
Dois commits exclusivos
| Commit | Mudança | Impacto |
|---|---|---|
b8fd9af | Grilling por rodadas | Fronteira de decisões + fact-finding em subagentes. |
9c32629 | Prototype lógico em HTML | Um arquivo autocontido, compartilhável, com estado e walkthroughs. |
0 atrás, 2 à frente
A branch parte da main atual e adiciona só essas duas mudanças. O PR #593 estava draft e mergeável na auditoria.
batch-grill-me
O experimento separado foi removido na release porque o comportamento migrou para a skill compartilhada grilling.
Pesquisa granular
Se uma pergunta depende de um fato, um subagente busca esse fato. Apenas as perguntas downstream esperam; o resto da rodada segue.
Versões desencontradas
package.json ainda diz 1.1.0, enquanto o manifest do plugin do Claude já diz 1.2.0. A tag v1.2.0 não existia em 18/07.
06 / DECISÃO
Qual opção atende ao requisito?
| Opção | Claude | Codex | Fonte única | Veredito |
|---|---|---|---|---|
skills CLI global + store ~/.agents/skills | Via ~/.claude/skills | Lê direto | Sim | Recomendado |
| Plugin nativo do Claude | Sim, gerenciado | Não nativamente | Não entre ambos | Só Claude |
| Copiar manualmente | Sim | Sim | Não | Drift provável |
Symlink do ~/.codex/skills inteiro | — | Risco à .system | Enganosa | Não fazer |
07 / LIMITES
Compartilhe skills; separe políticas de harness.
AGENTS + skills
Regras que valem igual para Claude, Codex e Pi e procedimentos reutilizáveis.
config.toml e agents
Política de subagentes, modelo, effort, hooks e papéis devem permanecer no espaço específico do Codex.
Preferência do Grill
A v1.2 documenta um opt-out de uma pergunta por vez. Só ponha isso no AGENTS compartilhado se quiser o mesmo comportamento nos três harnesses.
08 / FONTES
Evidências primárias e trilha de auditoria.
Tweet original — mudança para rodadas
mattpocock/skills — README oficial
PR #593 — Release v1.2
Comparação main…release/v1.2
Spoiler: grilling/SKILL.md
Spoiler: prototype/LOGIC.md
PR #586 — experimento batch-grill-me
PR #551 — metadados do Codex
ADR — plugin Claude agora, Codex depois
skills CLI — flags, paths e método de symlink
Manual oficial do Codex — skills globais em ~/.agents/skills
Codex — diferença entre symlink de arquivo e de diretório
macOS + diretório Claude symlinkado — histórico do risco
A topologia local foi cruzada com a tarefa Codex 019f77a3-4d8e-78f3-8d9f-f6428b98eb9a e confirmada no filesystem. Em 18/07/2026, as 22 skills promovidas foram instaladas na fonte global compartilhada a partir da branch release/v1.2; ~/.codex/skills/.system permaneceu intacto.