alexion/dev
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(grill): clarify frontier updates

Browse Source
This commit is contained in:
alexion
2026-10-20 16:57:54 -04:00
parent 51e2429dd4
commit cf7d66de02
1 changed files with 19 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
src/skills/grill/SKILL.md
View File

@@ -7,32 +7,21 @@ Interview the user relentlessly until you reach a shared understanding. Map this
Maintain the design tree in a new Markdown file. Use the file as the source of truth. Maintain the design tree in a new Markdown file. Use the file as the source of truth.
The **frontier** is the complete set of unresolved decisions whose prerequisites are settled. Build the **frontier** before asking a question.
At the start of the grill, inventory every known decision. The frontier contains every unresolved decision whose prerequisites are settled.
After each answer, recompute and display the complete frontier.
Do not hide ready decisions because another question is selected.
Ask one selected frontier question per turn. After each answer, update the design tree.
Mark it as selected in the displayed frontier. Display every frontier decision.
A clarification does not settle, remove, or replace a question. Mark the decision selected for this turn.
After answering a clarification, show the unchanged selected question again.
Finish only when the frontier is empty. Ask one selected decision per turn.
A clarification keeps the selected decision open.
Answer the clarification, then ask the selected decision again.
Format a question like so: Format a question like so:
``` ```
❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices> ❓ **Q1** - **<question title>**: <question body>
**Options**
1. <option>
...
<n>. **<recommended option>** — recommended
---
❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
**Options** **Options**
@@ -41,11 +30,17 @@ Format a question like so:
<n>. **<recommended option>** — recommended <n>. **<recommended option>** — recommended
``` ```
List every viable answer in an ordered list and mark your recommended answer. List every viable answer in an ordered list.
Word each question so "yes" accepts your recommended answer. Mark the recommended answer.
Write each question so that "yes" selects the recommended option.
Each user answer reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier in the file and ask the next question. A question whose answer depends on another open question belongs later, not next. After each answer, settle the answered decision.
Add decisions that the answer reveals.
Move every newly ready decision into the frontier.
Keep decisions with unresolved prerequisites outside the frontier.
Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), find it with available tools; don't ask the user for anything you could look up yourself. The _decisions_ are the user's: put each to them and wait. Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), find it with available tools; don't ask the user for anything you could look up yourself. The _decisions_ are the user's: put each to them and wait.
The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Present every settled decision from the design tree. Do not act on it until the user confirms you have reached a shared understanding. Finish when the frontier is empty.
Present every settled decision from the design tree.
Wait for user confirmation before acting on the decisions.