nwave-ai/nw-continue

NW-CONTINUE: Resume a Feature

Wave: CROSS_WAVE (entry point) | Agent: Main Instance (self — wizard) | Command: /nw-continue

Overview

Scans docs/feature/ for active projects, detects wave artifacts, displays progress summary, launches next wave command. Eliminates manual artifact inspection when returning after hours/days.

You (main Claude instance) run this wizard directly. No subagent delegation.

Behavior Flow

Step 1: Scan for Projects

If project ID provided as argument, use it directly.

Otherwise scan docs/feature/ for project directories:

ls -d docs/feature/*/

No directories found: Display "No active projects found under docs/feature/." Suggest /nw-new. Stop.

Step 2: Project Selection (Multiple Projects)

If multiple directories exist, list by most recent file modification:

find docs/feature/{feature-id}/ -type f -printf '%T@ %p\n' | sort -rn | head -1

Present via AskUserQuestion: project name|last modified date|most recent first. Ask user to select.

Step 3: Wave Progress Detection

Check each wave's artifacts using Wave Detection Rules in ~/.claude/nWave/skills/common/wizard-shared-rules.md.

Step 4: Anomaly Detection

Check before showing progress:

Empty/corrupted artifacts: Verify file size > 0 for each "complete" artifact. If empty, flag: "Warning: user-stories.md exists but is empty (0 bytes). Recommend re-running DISCUSS wave."

Non-adjacent waves (skipped): If artifacts exist for non-consecutive waves (e.g., DISCUSS + DELIVER but no DESIGN/DISTILL), warn with options:

1. Fill the gap — start from missing wave
2. Continue as-is
3. Show all artifacts for manual review

Step 5: DELIVER Progress Detail

If DELIVER in progress, show step-level detail:

• Read docs/feature/{id}/deliver/execution-log.json: count COMMIT/PASS steps, find first without COMMIT/PASS
• Read .develop-progress.json if exists: check last failure point
• Display: "DELIVER in progress: Steps 01-01 through 02-01 complete. Next: 02-02"

Step 6: Progress Display

Feature: {feature-id}

  DISCOVER   ○ not started
  DISCUSS    ● complete
  DESIGN     ● complete
  DISTILL    ◐ in progress
  DELIVER    ○ not started

  Next: DISTILL — Create acceptance tests

Symbols: ● complete | ◐ in progress | ○ not started

Step 7: Recommendation and Launch

Recommend next wave: resume in-progress wave|successor of last complete wave. Show via AskUserQuestion for confirmation. After confirmation, invoke recommended wave command by reading its task file, passing project ID as argument.

Error Handling

| Error | Response | |-------|----------| | No docs/feature/ directory | Suggest /nw-new | | Empty project directory | Suggest /nw-new or re-run from DISCUSS | | Corrupted artifact (0 bytes) | Flag file, recommend re-running that wave | | Skipped waves | Warn, offer gap-fill or continue options | | Cannot parse execution-log.json | Show raw file status, suggest manual review |

Success Criteria

• [ ] Projects scanned from docs/feature/
• [ ] Project selected (auto or user choice)
• [ ] Wave progress detected accurately from artifact presence
• [ ] Anomalies flagged (empty files, skipped waves)
• [ ] DELIVER step-level progress shown when applicable
• [ ] Progress summary displayed
• [ ] Next wave recommended and launched after user confirmation

Examples

Example 1: Single project, resume at DESIGN

/nw-continue

Wizard finds one project: notification-service. DISCUSS artifacts exist (complete), no DESIGN artifacts. Shows progress, recommends DESIGN. User confirms, wizard launches /nw-design notification-service.

Example 2: DELIVER resume

/nw-continue rate-limiting

Wizard checks rate-limiting project. All waves through DISTILL complete, DELIVER in progress (steps 01-01 through 02-01 done). Shows "Next: step 02-02", launches /nw-deliver "rate-limiting".

Example 3: Multiple projects

/nw-continue

Wizard finds rate-limiting (modified today) and user-notifications (modified 3 days ago). Lists them, user picks rate-limiting. Wizard shows progress and recommends next wave.

Example 4: No projects

/nw-continue

Wizard finds no docs/feature/ directories. Shows "No active projects found" and suggests /nw-new.