From ca8b46241eb6c6e94aa5090c45cde91d378a8b2f Mon Sep 17 00:00:00 2001 From: Frank Date: Sun, 18 Oct 2026 19:24:51 -0700 Subject: [PATCH] fix(grilling): round-two review notes (Refs #20) - opening restores 'shared understanding' alongside 'nothing is silently assumed', and 'Map this as a design tree' - cluster rationale restated: tight clusters keep each scout aware of possible adjacencies - web_search: explicit 'do not delegate to a subagent' - 'Done' heading -> 'Definition of Done' --- agent/skills/grilling/SKILL.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/agent/skills/grilling/SKILL.md b/agent/skills/grilling/SKILL.md index ce7d4cd..fb0a9a6 100644 --- a/agent/skills/grilling/SKILL.md +++ b/agent/skills/grilling/SKILL.md @@ -5,7 +5,7 @@ description: Grill the user relentlessly about a plan, decision, or idea. Use wh # Grilling -Interview the user relentlessly until nothing is silently assumed. The subject is a **design tree**: every decision branches into the decisions that hang off it. +Interview the user relentlessly until nothing is silently assumed and you reach a shared understanding. Map this as a **design tree**: every decision branches into the decisions that hang off it. A decision is **frontier** when it can be asked now, without an answer you haven't heard yet. The interview is done when the frontier is empty: every branch of the tree visited. @@ -36,11 +36,11 @@ Write `local://grilling-state.md` at the end of every round: the tree, each deci ## Facts are yours, decisions are theirs -- Environment facts (filesystem, repo, live config): dispatch a **scout** per fact-cluster, batched into one `task` call, before the round's `ask`. Cluster tightly; spawns are the expensive route. -- Outside-world facts: call `web_search` directly. +- Environment facts (filesystem, repo, live config): dispatch a **scout** per fact-cluster, batched into one `task` call, before the round's `ask`. Cluster tightly; doing so keeps each scout more aware of possible adjacencies. +- Outside-world facts: call `web_search` directly, do not delegate to a subagent. - Cheap lookups: `read`/`grep` inline. - The main session is where questions happen: every spawn carries the exact facts to return, and comes back into the next round. -## Done +## Definition of Done The frontier is empty and nothing sits blocked. Distil the ledger into a **brief**: one line per decision, verdict plus rationale, grouped by branch. Put it in chat, then one closing `ask`: "Proceed on this brief?" Nothing executes before that yes. After it, fold the brief into the project's knowledge base, or a log markdown file, wherever the project keeps its decisions.