From 0e9a0727924c39cc2a0c7e04d04526a73bef7ac4 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Fri, 3 Jul 2026 09:47:48 +0100 Subject: [PATCH 1/2] grilling: add confirmation gate and grill leading word Add a hard stop so the agent won't enact the plan until the user confirms shared understanding is reached. Recruit the pretrained "grill" leading word in the description, and re-sync the docs page with the new gate behaviour. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/productivity/grilling.md | 2 +- skills/productivity/grilling/SKILL.md | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/productivity/grilling.md b/docs/productivity/grilling.md index 2384bd1..8fa5067 100644 --- a/docs/productivity/grilling.md +++ b/docs/productivity/grilling.md @@ -14,7 +14,7 @@ npx skills update grilling `grilling` is the relentless interview that stress-tests a plan or design before you build it. It walks down the design tree branch by branch, resolving the dependencies between decisions one at a time until you and the agent share the same understanding. -It asks **one question at a time** and waits for your answer before the next — never a bulk list, which is bewildering. Each question comes with the agent's own recommended answer, and any question the codebase can settle it explores instead of asking you. +It asks **one question at a time** and waits for your answer before the next — never a bulk list, which is bewildering. Each question comes with the agent's own recommended answer, and any question the codebase can settle it explores instead of asking you. It won't start enacting the plan until you confirm the shared understanding has been reached. ## When to reach for it diff --git a/skills/productivity/grilling/SKILL.md b/skills/productivity/grilling/SKILL.md index fe3569d..e220063 100644 --- a/skills/productivity/grilling/SKILL.md +++ b/skills/productivity/grilling/SKILL.md @@ -1,6 +1,6 @@ --- name: grilling -description: Interview the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases. +description: Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases. --- Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. @@ -8,3 +8,5 @@ Interview me relentlessly about every aspect of this plan until we reach a share Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering. If a question can be answered by exploring the codebase, explore the codebase instead. + +Do not enact the plan until I confirm we have reached a shared understanding. From e1c025eaee5b822d2cec645589f32291a88a89f7 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Fri, 3 Jul 2026 09:48:46 +0100 Subject: [PATCH 2/2] Add minor changeset for grilling gate and leading word Co-Authored-By: Claude Opus 4.8 (1M context) --- .changeset/grilling-gate-and-leading-word.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/grilling-gate-and-leading-word.md diff --git a/.changeset/grilling-gate-and-leading-word.md b/.changeset/grilling-gate-and-leading-word.md new file mode 100644 index 0000000..34c8bfd --- /dev/null +++ b/.changeset/grilling-gate-and-leading-word.md @@ -0,0 +1,5 @@ +--- +"mattpocock-skills": minor +--- + +Add a confirmation gate to **`grilling`**: the agent won't enact the plan until you confirm the shared understanding has been reached, turning the skill's existing "shared understanding" completion criterion into an explicit stop-gate. The `description` also recruits the pretrained **`grill`** leading word ("Grill the user relentlessly") to sharpen invocation, and the docs page is re-synced with the new gate behaviour.