Decide
Contract
| Field |
Bound contract |
| Trigger |
The user has a fork and wants it resolved and applied, not explored: "help me decide", "just decide this", "what should I do here", or "decide and fix it". |
| Authority |
Human-gated: asks before unrecoverable or observable-surface removal; otherwise reversible local, applying the selected change or dispatching the verify/keep/revert loop. No remote mutation. |
| Side effect |
Local artifacts only; rollback is git revert or edit revert of the applied change. |
| Done |
The fork, user pick, and resulting change are named; the pick is implemented and verified in the same turn. |
Inputs
The fork: the decision point the user named, or one surfaced from the code. Optional: the user's stated preference, which becomes the recommended default only if evidence supports it.
Procedure
- Confirm that the user wants this fork resolved and applied. Do not use this skill for a verdict of the agent's own making, an exploration that ends in a document, a whole-session director-executor posture, a wide design tree handled in batches, or ambiguity within a stated request. Stop if any of those apply; this skill does not route there. Done when: the fork is confirmed as user-requested and apply-ready, or the run stops with the routing reason stated.
- Ground the fork before framing it. Resolve from evidence first with
grep, glob, read, or lsp. A fork the code already answers is not a fork: read it, say what it answers, and do not ask. Never ask what a search settles. Done when: the fork is grounded from evidence or resolved as already-answered by the code.
- Frame one single-select per axis. Give two to four options, placing
(Recommended) first and stating its consequence in the description. Each option names what the code looks like afterward. Where two options differ visibly, put the difference in preview as a diff or tree. Never use multiSelect for override semantics. Done when: one single-select per axis is framed with the recommended option first and consequences stated.
- Take the pick and act in the same turn. A pick applied in one edit gets the edit. A pick needing a verify, keep, or revert loop is restated as its goal and executed as that loop. A pick that removes an observable surface or cannot be reverted from git gets one concern stated, then a yes. Done when: the pick is applied as an edit, loop, or gated action in the same turn.
- When applying one pick opens the next fork, ask it immediately with the settled decision restated in one line. Never bank a queue of questions to fire at the end. Done when: the next fork is asked immediately or no next fork exists.
- When the user picks what the agent would not: execute the pick, state the concern once, never re-litigate. Done when: the pick is executed with one concern stated and no re-litigation.
- Close with one line naming the fork, the pick, and what changed. Done when: one closing line names the fork, pick, and resulting change.
Failure and recovery
- Fork already answered by the code: not a fork. State what the code answers and stop; do not frame a question.
- Pick removes an observable surface or cannot be reverted from git: state one concern and require a yes before applying. If the user does not confirm, do not apply; leave the working tree unchanged.
- Pick needs a verify/keep/revert loop that does not converge: stop, name the non-converged state, and leave the partial result with the rollback path stated. Never pretend the done predicate holds.
- User pick contradicts evidence: execute the pick, state the concern once, never re-litigate. Do not refuse a confirmed pick.
Output
One line naming the fork, the pick, and the resulting change, with the pick implemented and verified in the same turn.
1---2name: decide3description: Use when the user has a fork and wants it resolved and applied, not explored: "decide this", "choose the path", or "decide and fix it".4---56# Decide78## Contract910| Field | Bound contract |11|---|---|12| Trigger | The user has a fork and wants it resolved and applied, not explored: "help me decide", "just decide this", "what should I do here", or "decide and fix it". |13| Authority | Human-gated: asks before unrecoverable or observable-surface removal; otherwise reversible local, applying the selected change or dispatching the verify/keep/revert loop. No remote mutation. |14| Side effect | Local artifacts only; rollback is git revert or edit revert of the applied change. |15| Done | The fork, user pick, and resulting change are named; the pick is implemented and verified in the same turn. |1617## Inputs1819The fork: the decision point the user named, or one surfaced from the code. Optional: the user's stated preference, which becomes the recommended default only if evidence supports it.2021## Procedure22231. Confirm that the user wants this fork resolved and applied. Do not use this skill for a verdict of the agent's own making, an exploration that ends in a document, a whole-session director-executor posture, a wide design tree handled in batches, or ambiguity within a stated request. Stop if any of those apply; this skill does not route there. Done when: the fork is confirmed as user-requested and apply-ready, or the run stops with the routing reason stated.242. Ground the fork before framing it. Resolve from evidence first with `grep`, `glob`, `read`, or `lsp`. A fork the code already answers is not a fork: read it, say what it answers, and do not ask. Never ask what a search settles. Done when: the fork is grounded from evidence or resolved as already-answered by the code.253. Frame one single-select per axis. Give two to four options, placing `(Recommended)` first and stating its consequence in the description. Each option names what the code looks like afterward. Where two options differ visibly, put the difference in `preview` as a diff or tree. Never use `multiSelect` for override semantics. Done when: one single-select per axis is framed with the recommended option first and consequences stated.264. Take the pick and act in the same turn. A pick applied in one edit gets the edit. A pick needing a verify, keep, or revert loop is restated as its goal and executed as that loop. A pick that removes an observable surface or cannot be reverted from git gets one concern stated, then a yes. Done when: the pick is applied as an edit, loop, or gated action in the same turn.275. When applying one pick opens the next fork, ask it immediately with the settled decision restated in one line. Never bank a queue of questions to fire at the end. Done when: the next fork is asked immediately or no next fork exists.286. When the user picks what the agent would not: execute the pick, state the concern once, never re-litigate. Done when: the pick is executed with one concern stated and no re-litigation.297. Close with one line naming the fork, the pick, and what changed. Done when: one closing line names the fork, pick, and resulting change.3031## Failure and recovery32- Fork already answered by the code: not a fork. State what the code answers and stop; do not frame a question.33- Pick removes an observable surface or cannot be reverted from git: state one concern and require a yes before applying. If the user does not confirm, do not apply; leave the working tree unchanged.34- Pick needs a verify/keep/revert loop that does not converge: stop, name the non-converged state, and leave the partial result with the rollback path stated. Never pretend the done predicate holds.35- User pick contradicts evidence: execute the pick, state the concern once, never re-litigate. Do not refuse a confirmed pick.3637## Output38One line naming the fork, the pick, and the resulting change, with the pick implemented and verified in the same turn.
OutlineDriven