Problem
The next-steps prompts produced by plan- and review-producing skills use ▶/· markers but no numbers. Selecting an option requires copy-pasting the full line or typing the skill name. There's also no guidance on when to clear context before proceeding.
Context
Solution
Numbered options with emojis
Replace ▶/· markers with sequential numbers and consistent emojis. Bold only the recommended option's label.
Emoji assignments:
- 🧠 Refine plan / Design and plan
- 🎶 Orchestrate
- 🚀 Implement directly
- 📝 Update ticket
Example (next-steps-after-plan.md):
Next steps:
1. 🧠 Refine plan: Clear context and use the `refine-plan` skill with plan: {plan_path}, ticket: {ticket_source}
2. 🎶 **Orchestrate** (🟢 recommended): Clear context and use the `orchestrate-dev` skill with plan: {plan_path}, ticket: {ticket_source}
3. 🚀 Implement directly
Context-clearing guidance
Prepend "Clear context and use..." vs "Use..." based on the option:
- Orchestrate — always "Clear context". Subagents start fresh; prior conversation wastes tokens.
- Refine plan / Design and plan — "Clear context". The plan artifact is self-contained.
- Implement directly — no "Clear context". Conversation history is valuable for manual implementation.
- Update ticket — no "Clear context". Ticket update benefits from review discussion.
Paths
Artifact paths in the output should use ~/-relative format when possible and absolute paths otherwise.
Acceptance criteria
Problem
The next-steps prompts produced by plan- and review-producing skills use
▶/·markers but no numbers. Selecting an option requires copy-pasting the full line or typing the skill name. There's also no guidance on when to clear context before proceeding.Context
▶/·format was introduced in #320 Add next-steps resumption prompt to plan-producing skills #329 via_data/next-steps-after-plan.md_data/next-steps-after-review.mdwas added in Modify review-change skill to check code against ticket, if one is given #328next-steps-after-plan.mdwere tuned in next-steps-after-plan rules over-recommend refinement for interactive plans #351Solution
Numbered options with emojis
Replace
▶/·markers with sequential numbers and consistent emojis. Bold only the recommended option's label.Emoji assignments:
Example (
next-steps-after-plan.md):Context-clearing guidance
Prepend "Clear context and use..." vs "Use..." based on the option:
Paths
Artifact paths in the output should use
~/-relative format when possible and absolute paths otherwise.Acceptance criteria
_data/next-steps-after-plan.mdand_data/next-steps-after-review.mduse numbered options~/-relative format where possible and absolute paths otherwise