Skip to content

Commit c0ce73a

Browse files
committed
feat(agents): add low-friction decision prompts and /handoff exception
Bridged from Codex Game Studios commits 687320f and 2eae58d. - Adds 'Low-Friction Decision Prompts' section: numbered options with one (Recommended), a. yes / b. no shortcuts for confirmations, no filler options. - Adds /handoff exception to Collaboration Boundary: explicit /handoff invocation authorizes the declared handoff workflow (continuity writes, path-scoped staging, commit, push) without a second approval. Narrowly scoped - no source edits, branch switching, force-push, or --no-verify. - Updates Continuity Epilogue point 3 to list viable actions. Adapted Codex -> OpenCode: $handoff -> /handoff.
1 parent 2a5889d commit c0ce73a

1 file changed

Lines changed: 27 additions & 2 deletions

File tree

AGENTS.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,10 +71,35 @@ Question -> Options -> Decision -> Draft -> Approval.
7171
tools.
7272
- Agents must show drafts or summaries before requesting approval.
7373
- Multi-file changes require explicit approval for the full changeset.
74+
- `/handoff` exception: explicit invocation of the OpenCode-native `/handoff`
75+
skill counts as user approval for that skill's declared handoff workflow only:
76+
update `production/session-handoff.md`, `production/session-archive.md`, and
77+
`production/session-state/active.md`; stage relevant uncommitted changes by
78+
path; create the standard handoff commit; and push the current branch.
79+
- The `/handoff` exception does not authorize design/game-feel/balance
80+
decisions, new source edits outside the continuity files, writes to undeclared
81+
files, branch switching, force-pushes, or `--no-verify` / amend workarounds.
7482
- No commits without user instruction.
7583

7684
See `docs/COLLABORATIVE-DESIGN-PRINCIPLE.md` for full protocol and examples.
7785

86+
## Low-Friction Decision Prompts
87+
88+
OpenCode surfaces may not always provide a clickable choice UI. When handing
89+
control back to the user, make the reply easy to answer with a short token.
90+
91+
- For multiple viable choices, list all real options, usually 3-5 when available
92+
and fewer when fewer are viable. Do not invent filler options.
93+
- Use numbered options for multi-choice prompts. Mark exactly one option
94+
`(Recommended)`.
95+
- For yes/no confirmations, include explicit letter shortcuts:
96+
- `a. yes`
97+
- `b. no`
98+
- Keep each option label short. Put reasoning in one brief sentence before the
99+
options or after each option only when needed.
100+
- Never end with an unstructured "what do you want to do?" when a small viable
101+
choice set is possible.
102+
78103
## Verification Integrity
79104

80105
- Never claim a build, test, lint, smoke check, or playtest passed unless it ran
@@ -160,8 +185,8 @@ After each discrete work unit, apply this mentally or run `/studio-next`:
160185

161186
1. Summarize what was completed.
162187
2. Surface owed verification.
163-
3. Recommend the single best next action from handoff, session, sprint, stage,
164-
workflow, and slice state.
188+
3. List the viable next actions from handoff, session, sprint, stage, workflow,
189+
and slice state, with one clearly marked `(Recommended)`.
165190
4. Suggest `/handoff` when session state should be preserved.
166191

167192
Read `.opencode/docs/session-continuity.md` and

0 commit comments

Comments
 (0)