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'
This commit is contained in:
@@ -5,7 +5,7 @@ description: Grill the user relentlessly about a plan, decision, or idea. Use wh
|
|||||||
|
|
||||||
# Grilling
|
# 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.
|
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
|
## 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.
|
- 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.
|
- Outside-world facts: call `web_search` directly, do not delegate to a subagent.
|
||||||
- Cheap lookups: `read`/`grep` inline.
|
- 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.
|
- 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.
|
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.
|
||||||
|
|||||||
Reference in New Issue
Block a user