From 950dc79bb0657500d73121c342ab56b1b05fbc02 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Wed, 29 Jul 2026 12:33:07 +0100 Subject: [PATCH] feat(grilling): bold the question title The title now carries its own bold alongside the bold Q-number, so the question line reads as a heading. Sync the docs page and changeset. Co-Authored-By: Claude Opus 5 --- .changeset/grilling-question-format.md | 2 +- docs/productivity/grilling.md | 2 +- skills/productivity/grilling/SKILL.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.changeset/grilling-question-format.md b/.changeset/grilling-question-format.md index 7f015e7..6101ce9 100644 --- a/.changeset/grilling-question-format.md +++ b/.changeset/grilling-question-format.md @@ -2,4 +2,4 @@ "mattpocock-skills": patch --- -Pin the question format in **`grilling`**. Every question in a round is now emitted in one fixed shape — `❓ **Q1** - `, then the body (prose or multiple choices), then the recommendation on its own `➡️` line. A round reads as a scannable numbered list with each recommendation visually separated from the question, so you can answer by number instead of quoting questions back. +Pin the question format in **`grilling`**. Every question in a round is now emitted in one fixed shape — `❓ **Q1** - **<title>**`, then the body (prose or multiple choices), then the recommendation on its own `➡️` line. A round reads as a scannable numbered list with each recommendation visually separated from the question, so you can answer by number instead of quoting questions back. diff --git a/docs/productivity/grilling.md b/docs/productivity/grilling.md index 7006750..efb2d15 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 maps the plan as a **design tree** — every decision branches into the decisions that hang off it — and works that tree in **rounds** until you and the agent share the same understanding. -Each round asks the whole **frontier**: every decision whose prerequisites are already settled — the questions it can put to you *now* without guessing at answers it hasn't heard yet. Your answers reshape the tree, pushing the frontier outward, and the next round asks whatever that unblocks. Thirteen questions land in a handful of rounds instead of thirteen. Every question arrives in a fixed shape — numbered and titled behind a `❓` (`❓ **Q1** - Storage backend`), then the body, then the agent's recommendation on its own `➡️` line — so a round reads as a scannable list and you can answer it by number rather than by quoting it back; any *fact* the environment can settle it dispatches to a background sub-agent rather than asking you — and it doesn't block on that research, only the questions downstream of it wait. It won't act on the plan until you confirm the shared understanding has been reached. +Each round asks the whole **frontier**: every decision whose prerequisites are already settled — the questions it can put to you *now* without guessing at answers it hasn't heard yet. Your answers reshape the tree, pushing the frontier outward, and the next round asks whatever that unblocks. Thirteen questions land in a handful of rounds instead of thirteen. Every question arrives in a fixed shape — numbered and titled behind a `❓` (`❓ **Q1** - **Storage backend**`), then the body, then the agent's recommendation on its own `➡️` line — so a round reads as a scannable list and you can answer it by number rather than by quoting it back; any *fact* the environment can settle it dispatches to a background sub-agent rather than asking you — and it doesn't block on that research, only the questions downstream of it wait. It won't act on the plan until you confirm the shared understanding has been reached. ### Prefer one question at a time? diff --git a/skills/productivity/grilling/SKILL.md b/skills/productivity/grilling/SKILL.md index ccfb893..95bd01e 100644 --- a/skills/productivity/grilling/SKILL.md +++ b/skills/productivity/grilling/SKILL.md @@ -10,7 +10,7 @@ Work the tree in **rounds**. The **frontier** is every decision whose prerequisi Each question should be formatted like so: ``` -❓ **Q1** - <question title>: <question body, might be multiple paragraphs, including multiple choices> +❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices> ➡️ <your recommended answer> ```