| name | next-step |
| description | Mid-session orchestrator. Given the current project state and what was just done, propose the next move. Lighter than /start-here -- skips the health check, focuses on "what's the highest-leverage next thing." Spawns mendix-orchestrator agent for the synthesis. Use when a skill just finished and the user asks "what next?" or "ok, now what?". |
next-step
Mid-session continuation primitive. Doesn't repeat the health check (that's /start-here's job). Focused on: what's the highest-leverage move RIGHT NOW given what just happened?
When to invoke
Auto-invoke when:
- A skill finished (success or fail) and the user asks "what next?" / "now what?" / "next move?".
- The user finishes a manual step (e.g., handoff) and says "done" — propose the post-handoff next move.
Do not invoke for:
- Session start — that's
/start-here.
- Specific requests — just do them.
What it does
- Read recent context (last 3-5 messages of conversation, last skill output).
- Read MISSION.md + LEARNINGS.md + PHASE-D-PLAN.md (parallel).
- Spawn
mendix-orchestrator agent with brief: "Last action was X. Result was Y. What's the highest-leverage next move? Apply MISSION.md heuristics."
- Output:
## /next-step
**Last action:** <what just happened, 1 line>
**Result:** <success | partial | fail — 1 line>
**Recommended next:**
- **<action>** — <rationale citing MISSION.md / LEARNINGS.md>
Command: `<exact command>`
**Alternative paths:**
- <option B with one-line rationale>
- <option C with one-line rationale>
**Pick one or describe.**
Hard rules
- 3 sentences of context max before the recommendation. The user just saw what happened; don't rehash.
- One primary recommendation + 2 alternatives. Not a menu of 6.
- Reference MISSION.md priorities in the rationale — every recommendation should connect to "what Neo wants."
- If the last action failed, the recommendation is to fix the failure FIRST, not to move on to new work.
Cross-reference
- Mission:
<repo>/.claude/MISSION.md
- Orchestrator:
<repo>/.claude/agents/mendix-orchestrator.md
- Companion:
/start-here (session start), /workflow (named recipes).
