From b843cb5ea74b1fe5e58a0fc23cddef9e66076fb8 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Thu, 30 Apr 2026 12:38:11 +0100 Subject: [PATCH] Add structured sections for 'what-to-do' and 'supporting-info' in SKILL.md Co-authored-by: Copilot --- skills/engineering/grill-with-docs/SKILL.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/skills/engineering/grill-with-docs/SKILL.md b/skills/engineering/grill-with-docs/SKILL.md index 2e77882..6dad6ad 100644 --- a/skills/engineering/grill-with-docs/SKILL.md +++ b/skills/engineering/grill-with-docs/SKILL.md @@ -3,12 +3,18 @@ name: grill-with-docs description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions. --- + + 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. Ask the questions one at a time, waiting for feedback on each question before continuing. If a question can be answered by exploring the codebase, explore the codebase instead. + + + + ## Domain awareness During codebase exploration, also look for existing documentation: @@ -78,3 +84,5 @@ Only offer to create an ADR when all three are true: 3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md). + +