fix(checkpoint): add early-exit routing and wrap-up step

Replace undefined "I've seen enough" exits with proper early-exit
handling across steps 02-04. Extract wrap-up logic into dedicated
step-05-wrapup.md. Fix step-02 menu text that incorrectly promised
"code review" when step-03 does risk surfacing.
This commit is contained in:
Alex Verkhovsky 2026-04-01 09:36:25 -07:00
parent 0d505257d3
commit c45cc35c60
4 changed files with 45 additions and 28 deletions

View File

@ -73,12 +73,17 @@ Take your time — click through the stops, read the diff, trace the logic. Whil
- "party mode on whether this schema migration is safe"
- or just ask anything
When you are done with the walkthrough:
- **"detail pass"** — I'll surface the highest-risk spots and run code review
- **"testing"** — I'll suggest how to observe the behavior
- **"I've seen enough"** — tell me what to do about this {change_type} and we wrap up
When you're ready, say **next** and I'll surface the highest-risk spots.
```
## EARLY EXIT
If at any point the human signals they want to make a decision about this {change_type} (e.g., "let's ship it", "this needs a rethink", "I'm done reviewing", or anything suggesting they're ready to decide), confirm their intent:
- If they want to **approve and ship** → read fully and follow `./step-05-wrapup.md`
- If they want to **reject and rework** → read fully and follow `./step-05-wrapup.md`
- If you misread them → acknowledge and continue the current step.
## NEXT
When the human signals readiness for the next phase, read fully and follow `./step-03-detail-pass.md`
Default: read fully and follow `./step-03-detail-pass.md`

View File

@ -76,10 +76,17 @@ End the message with:
You've seen the design and the risk landscape. From here:
- **"dig into [area]"** — I'll deep-dive that specific area with correctness focus
- **"testing"** — I'll suggest how to observe the behavior
- **"I've seen enough"** — tell me what to do about this {change_type} and we wrap up
- **"next"** — I'll suggest how to observe the behavior
```
## EARLY EXIT
If at any point the human signals they want to make a decision about this {change_type} (e.g., "let's ship it", "this needs a rethink", "I'm done reviewing", or anything suggesting they're ready to decide), confirm their intent:
- If they want to **approve and ship** → read fully and follow `./step-05-wrapup.md`
- If they want to **reject and rework** → read fully and follow `./step-05-wrapup.md`
- If you misread them → acknowledge and continue the current step.
## TARGETED RE-REVIEW
When the human says "dig into [area]" (e.g., "dig into the auth changes", "dig into the schema migration"):
@ -96,4 +103,4 @@ The human can trigger multiple targeted re-reviews. Each time, present new findi
## NEXT
When the human signals readiness for testing, read fully and follow `./step-04-testing.md`
Read fully and follow `./step-04-testing.md`

View File

@ -66,26 +66,9 @@ End the message with:
```
---
You've seen the change and how to verify it. From here:
- **"I've seen enough"** — we wrap up this {change_type}
- or just ask anything
You've seen the change and how to verify it. When you're ready to make a call, just say so.
```
## WRAP-UP
## NEXT
When the human says "I've seen enough" or signals they're done:
```
---
Review complete. What's the call on this {change_type}?
- **Approve** — ship it
- **Request changes** — I'll help draft feedback
- **Discuss** — something's still on your mind
```
Act on their decision:
- **Approve**: Acknowledge briefly. If reviewing a PR, offer to approve via `gh pr review --approve` — but confirm with the human before executing, since this is a visible action on a shared resource.
- **Request changes**: Ask what needs changing. Help draft specific, actionable feedback tied to `path:line` locations.
- **Discuss**: Open conversation — answer questions, explore concerns, dig into any aspect.
When the human signals they're ready to make a decision about this {change_type}, read fully and follow `./step-05-wrapup.md`

View File

@ -0,0 +1,22 @@
# Step 5: Wrap-Up
Display: `Orientation → Walkthrough → Detail Pass → Testing → [Wrap-Up]`
## Follow Global Step Rules in SKILL.md
## PROMPT FOR DECISION
```
---
Review complete. What's the call on this {change_type}?
- **Approve** — ship it (I can help with interactive patching first if needed)
- **Rework** — back to the drawing board (revert, revise the spec, try a different approach)
- **Discuss** — something's still on your mind
```
## ACT ON DECISION
- **Approve**: Acknowledge briefly. If the human wants to patch something before shipping, help apply the fix interactively. If reviewing a PR, offer to approve via `gh pr review --approve` — but confirm with the human before executing, since this is a visible action on a shared resource.
- **Rework**: Ask what went wrong — was it the approach, the spec, or the implementation? Help the human decide on next steps (revert commit, open an issue, revise the spec, etc.). Help draft specific, actionable feedback tied to `path:line` locations if the change is a PR from someone else.
- **Discuss**: Open conversation — answer questions, explore concerns, dig into any aspect. After discussion, return to the decision prompt above.