NWave nw-continue

Detects current wave progress for a feature and resumes at the next step. Scans docs/feature/ for artifacts.

install

source · Clone the upstream repo

git clone https://github.com/nWave-ai/nWave

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/nWave-ai/nWave "$T" && mkdir -p ~/.claude/skills && cp -r "$T/nWave/skills/nw-continue" ~/.claude/skills/nwave-ai-nwave-nw-continue && rm -rf "$T"

manifest: nWave/skills/nw-continue/SKILL.md

source content

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:

Fill the gap — start from missing wave
Continue as-is
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