Next

---
name: torque:next
description: "Determine the single best next action based on current project state. Reads GSD state, SP plans, and git context to suggest exactly one command to run."
---

# Torque Next Action

Analyze project state and recommend exactly ONE next command. Think of this as a GPS for your development workflow.

## Procedure

### Step 1: Gather state

Same as `/torque:status` — read `.planning/`, `docs/plans/`, git state. But don't output the full status. Focus on determining the current position.

### Step 2: Decision tree

Work through this tree top-to-bottom. First match wins.

```
1. Is there an active bug or failing test?
   → `systematic-debugging`
   Why: Bugs block everything. Fix first.

2. Does .planning/ exist?
   ├─ YES (GSD project):
   │   a. Is there a HANDOFF.md in the active phase?
   │      → `/gsd:resume-work`
   │      Why: Paused work should be resumed before starting new work.
   │
   │   b. Is STATE.md showing a phase in "executing" with incomplete plans?
   │      → `/gsd:execute-phase` (continue)
   │      Why: Finish what you started.
   │
   │   c. Is a phase complete but not verified?
   │      → `/gsd:verify-work`
   │      Why: Verification before review.
   │
   │   d. Is a phase verified but not code-reviewed?
   │      → `requesting-code-review`
   │      Why: GSD has no review step — SP fills the gap.
   │
   │   e. Is a phase reviewed but not shipped?
   │      → `/gsd:ship` or `/gsd:pr-branch`
   │      Why: Ship cleanly — filters .planning/ commits from PR.
   │
   │   f. Are all phases in the current milestone complete?
   │      → `/gsd:audit-milestone` then `/gsd:complete-milestone`
   │      Why: Close out the milestone properly.
   │
   │   g. Is the next phase planned but not started?
   │      → `/gsd:execute-phase`
   │      Why: Plans exist, execute them.
   │
   │   h. Is the next phase discussed and spec'd but not planned?
   │      → `/gsd:plan-phase`
   │      Why: Context and spec exist, create plans.
   │
   │   h2. Is the next phase discussed but not spec'd (ambiguous scope)?
   │       → `/gsd:spec-phase`
   │       Why: Lock falsifiable requirements before planning.
   │
   │   i. Is there a next phase that hasn't been discussed?
   │      → `/gsd:discuss-phase`
   │      Why: Gather context before planning.
   │
   │   i2. Is this an AI/LLM phase that hasn't been designed?
   │       → `/gsd:ai-integration-phase`
   │       Why: Produce AI-SPEC.md with framework + eval strategy.
   │
   │   j. No more phases in roadmap?
   │      → `/gsd:new-milestone` or project complete
   │
   └─ NO (no .planning/):
       a. Does docs/plans/ exist with incomplete plans?
          → Re-read plans, continue execution
          Why: Pick up where you left off.
       
       b. No workflow state at all?
          → Ask: "New project or standalone feature?"
          → New project: `/gsd:new-project`
          → Existing codebase: `/gsd:map-codebase`
          → Quick standalone: `brainstorming`
```

### Step 3: Output format

```
## Next Action

→ `/gsd:plan-phase`

**Why**: Phase 3 ("Payment integration") has CONTEXT.md from discuss-phase
but no PLAN.md files yet. Planning is the next step before execution.

**Current position**: Milestone 1, Phase 3 of 7
**What this does**: Creates executable PLAN.md files with task breakdown,
dependencies, and wave assignments for parallel execution.
```

Keep it to ONE recommendation. If truly ambiguous, show at most two options with a clear default.

## Rules

- Never modify any files. This is read-only.
- Always explain WHY this is the next action.
- Show current position for context.
- One recommendation. Not a menu.