fix(grill): limit frontier wording changes
This commit is contained in:
@@ -7,21 +7,32 @@ 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.
|
||||||
|
|
||||||
Build the **frontier** before asking a question.
|
Build the **frontier** before asking the first question.
|
||||||
The frontier contains every unresolved decision whose prerequisites are settled.
|
The frontier contains every unresolved decision with settled prerequisites.
|
||||||
|
|
||||||
After each answer, update the design tree.
|
After each answer, update the design tree.
|
||||||
Display every frontier decision.
|
Display every frontier decision.
|
||||||
Mark the decision selected for this turn.
|
Mark the selected decision.
|
||||||
|
|
||||||
Ask one selected decision per turn.
|
Ask one selected decision each turn.
|
||||||
A clarification keeps the selected decision open.
|
A clarification keeps that decision open.
|
||||||
Answer the clarification, then ask the selected decision again.
|
Answer the clarification.
|
||||||
|
Then ask the decision again.
|
||||||
|
|
||||||
Format a question like so:
|
Format a question like so:
|
||||||
|
|
||||||
```
|
```
|
||||||
❓ **Q1** - **<question title>**: <question body>
|
❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
|
||||||
|
|
||||||
|
**Options**
|
||||||
|
|
||||||
|
1. <option>
|
||||||
|
...
|
||||||
|
<n>. **<recommended option>** — recommended
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
|
||||||
|
|
||||||
**Options**
|
**Options**
|
||||||
|
|
||||||
@@ -30,17 +41,11 @@ Format a question like so:
|
|||||||
<n>. **<recommended option>** — recommended
|
<n>. **<recommended option>** — recommended
|
||||||
```
|
```
|
||||||
|
|
||||||
List every viable answer in an ordered list.
|
List every viable answer in an ordered list and mark your recommended answer.
|
||||||
Mark the recommended answer.
|
Word each question so "yes" accepts your recommended answer.
|
||||||
Write each question so that "yes" selects the recommended option.
|
|
||||||
|
|
||||||
After each answer, settle the answered decision.
|
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.
|
||||||
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.
|
||||||
|
|
||||||
Finish when the frontier is empty.
|
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.
|
||||||
Present every settled decision from the design tree.
|
|
||||||
Wait for user confirmation before acting on the decisions.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user