Skip to content

Commit 2a5889d

Browse files
committed
feat(studio-next): list viable next actions with low-friction choice prompts
Bridged from Codex Game Studios commit 687320f. Shifts studio-next from 'recommend the single best action' to listing viable actions (3-5, fewer when fewer are real) with one marked (Recommended). Adds numbered-text fallback and a. yes / b. no go/no-go prompts when the question tool is unavailable. Adapted Codex -> OpenCode: request_user_input -> question, $studio-next -> /studio-next.
1 parent 58c4fc4 commit 2a5889d

1 file changed

Lines changed: 37 additions & 21 deletions

File tree

.opencode/skills/studio-next/SKILL.md

Lines changed: 37 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: studio-next
3-
description: "Lightweight OpenCode Game Studios continuity router. Reads handoff, session, sprint, stage, workflow, and slice state to recommend the single best next action after a work unit."
3+
description: "Lightweight OpenCode Game Studios continuity router. Reads handoff, session, sprint, stage, workflow, and slice state to list viable next actions with one recommended choice after a work unit."
44
---
55

66
# Studio Next
@@ -98,7 +98,7 @@ Route using installed commands when possible:
9898
If a routed command is not installed, recommend the closest installed command and
9999
state the missing command plainly.
100100

101-
## Step 4: Rank And Choose One Best Action
101+
## Step 4: Rank Viable Actions
102102

103103
Rank candidates in this order:
104104

@@ -110,34 +110,50 @@ Rank candidates in this order:
110110
6. Handoff preservation if session state should be durable.
111111
7. Optional hygiene or carve-out work.
112112

113-
Recommend exactly one best next action. Include:
113+
List all viable next actions in ranked order. Usually this is 3-5 choices, but
114+
fewer is correct when fewer are genuinely viable. Do not invent filler options
115+
to reach a target count. Mark exactly one choice `(Recommended)`.
116+
117+
For each option include:
114118

115119
- Command to run.
116-
- Why this is the best next action now.
120+
- Why this action is viable now.
117121
- Slice classification (`extend`, `feed`, or `carve-out`).
118122
- Any prerequisite owed check.
119123
- Whether the recommendation is based on verified state or file-reported state.
120124

121-
## Step 5: Use Structured Choice Only When Needed
122-
123-
If there is one clear best action, output it and stop. Do not ask an unnecessary
124-
choice question.
125+
## Step 5: Use Low-Friction Choice Prompts
125126

126-
If there are genuinely 2-3 viable lanes with similar priority, use the `question`
127-
tool when available:
127+
When several next actions are viable, use the `question` tool when available:
128128

129129
- Header: `Next work`
130130
- Question: `Which lane should we take next?`
131-
- Options: 2-3 mutually exclusive lanes
131+
- Options: all viable lanes, usually 3-5 when available and fewer when fewer are
132+
real
132133
- Put the recommended lane first and append `(Recommended)` to its label
133134
- Each option description must include command, reason, slice classification,
134135
and rough size in sessions
135136

136137
If the `question` tool is unavailable, fall back to a concise numbered prompt
137-
with the same 2-3 options.
138+
with the same options:
139+
140+
```text
141+
1. <Command/action> (Recommended) - <brief reason> [extend/feed/carve-out]
142+
2. <Command/action> - <brief reason> [extend/feed/carve-out]
143+
3. <Command/action> - <brief reason> [extend/feed/carve-out]
144+
```
145+
146+
Use a binary prompt only when there is one mandatory action because a gate,
147+
blocker, or owed verification must be cleared before any other work is valid:
148+
149+
```text
150+
a. yes
151+
b. no
152+
```
138153

139154
Do not use a broad "what do you want to do?" ending. The output must either
140-
recommend one action or offer a small structured lane choice.
155+
offer the viable next lanes as a compact choice list or, for mandatory actions,
156+
offer a go/no-go prompt.
141157

142158
## Output Shape
143159

@@ -147,25 +163,25 @@ recommend one action or offer a small structured lane choice.
147163
State read: <files used, with missing files omitted>
148164
Slice: <version or unset> | Last clean boot/playtest: <verified/reported/unset>
149165
150-
Best next action:
151-
- <command> - <why this is next> [extend/feed/carve-out, <verified/reported>]
166+
Viable next actions:
167+
1. <command> (Recommended) - <why this is best now> [extend/feed/carve-out, <verified/reported>]
168+
2. <command> - <why this is viable> [extend/feed/carve-out, <verified/reported>]
169+
3. <command> - <why this is viable> [extend/feed/carve-out, <verified/reported>]
152170
153171
Owed before starting:
154172
- <checks or "None">
155173
156-
Why not the other lanes:
157-
- <short note only when another lane looked plausible>
174+
Mandatory gate, if one blocks all other work:
175+
a. yes
176+
b. no
158177
```
159178

160-
When multiple lanes are viable, add the structured choice immediately after this
161-
briefing.
162-
163179
## Continuity Epilogue Pattern
164180

165181
At the end of any discrete work unit, mentally apply this same check even when
166182
the user did not invoke `/studio-next` explicitly:
167183

168184
1. Summarize what completed.
169185
2. Surface owed verification.
170-
3. Recommend the single best next action.
186+
3. List viable next actions with one recommended option.
171187
4. Suggest `/handoff` when session state should be preserved.

0 commit comments

Comments
 (0)