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.