Agent skill

Nw Roadmap

by nWave-ai in nWave-ai/nWave

Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps.

MITAuto-check passedProduct & Project Management

Install Nw Roadmap

skills CLI
$ npx skills add nWave-ai/nWave --skill nw-roadmap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nWave-ai/nWave nw-roadmap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .claude/skills && cp -r skills-src/nWave/skills/nw-roadmap .claude/skills/nw-roadmap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nw-roadmap
GitHub stars
616
Token cost
~1.8k tokens
SKILL.md length
384 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps.

  • Works in 2 steps: Parse Parameters — Extract agent name… → Scaffold Skeleton — Run des.cli.roadmap…
  • Planning implementation steps before execution
  • SKILL.md covers Overview, Usage, Execution Steps and Invocation Principles, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Nw Roadmap is an agent skill from nWave-ai/nWave. Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering User stories and Test-driven development. It works with Bash. The repository describes itself as: AI agents that guide you from idea to working code, with you in control at every step. The licence is MIT.

When your agent uses it

  • Planning implementation steps before execution
  • Tasks that involve User stories
  • Tasks that involve Test-driven development

Example prompts

  • “Use the nw-roadmap skill to create a phased roadmap.json for a feature goal with acceptance criteria and TDD steps”
  • “/nw-roadmap”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Parse Parameters — Extract agent name (after @, validated against agent registry), goal description (quoted string), and derive feature-id…
  2. Scaffold Skeleton — Run des.cli.roadmap init via Bash BEFORE invoking agent. Gate: CLI exits 0; stop and report error on non-zero exit.

What it can do on your machine

Read from SKILL.md and the folder at commit da401a8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nw Roadmap loads about 1.8k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 384 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nWave-ai/nWave at commit da401a8, republished under its MIT licence (© nWave-ai). 384 words, ~1,752 tokens.

Download SKILL.mdSave it as .claude/skills/nw-roadmap/SKILL.md (or your agent's skills folder).
name
nw-roadmap
description
Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.
user-invocable
false
argument-hint
[agent] [goal-description] - Example: @solution-architect "Migrate to microservices"

NW-ROADMAP: Goal Planning

Wave: CROSS_WAVE Agent: Architect (nw-solution-architect) or domain-appropriate agent

Overview

Dispatches expert agent to fill a pre-scaffolded YAML roadmap skeleton. CLI tools handle structure; agent handles content.

Output: docs/feature/{feature-id}/deliver/roadmap.json

Usage

bash
/nw-roadmap @nw-solution-architect "Migrate monolith to microservices"
/nw-roadmap @nw-software-crafter "Replace legacy authentication system"
/nw-roadmap @nw-product-owner "Implement multi-tenant support"

Execution Steps

You MUST execute these steps in order. Do NOT skip any.

  1. Parse Parameters — Extract agent name (after @, validated against agent registry), goal description (quoted string), and derive feature-id from goal in kebab-case (e.g., "Migrate to OAuth2" -> "migrate-to-oauth2"). Gate: agent name, goal, and feature-id all resolved.

  2. Scaffold Skeleton — Run des.cli.roadmap init via Bash BEFORE invoking agent. Gate: CLI exits 0; stop and report error on non-zero exit.

bash
des-roadmap init \
  --project-id {feature-id} \
  --goal "{goal-description}" \
  --output docs/feature/{feature-id}/deliver/roadmap.json

For complex projects add: --phases 3 --steps "01:3,02:2,03:1"

Do NOT write the file manually.

  1. Invoke Agent — Invoke the named agent via Task tool to fill skeleton TODO placeholders. Gate: agent completes without error.
@{agent-name}

Fill in the roadmap skeleton at docs/feature/{feature-id}/deliver/roadmap.json.
Replace every TODO with real content. Do NOT change the YAML structure
(phases, steps, keys). Fill in: names, descriptions, acceptance criteria,
time estimates, dependencies, and implementation_scope paths.

Goal: {goal-description}

# Test paradigm mandate (STANDING 2026-05-05) — apply per test level

GUARD — emit by deliverable_type (ADR-PST-003 / OPEN-5-A): the mandate
block below applies ONLY when `deliverable_type == application` (or when
deliverable_type is unset — application is the default). For a plugin/skill
deliverable, do NOT emit the mandate; instead include this one-line directive
in each step's `implementation_notes`:

  STRUCTURAL VERIFICATION (mandatory, plugin/skill): This step ships prompt
  text / config / docs, not application code, so the Hypothesis + state-delta
  unit mandate does not apply. Verify the deliverable structurally — a golden
  assertion (skill-lint) over the changed markdown/config asserting the
  required block is present and correctly shaped — gated at CI + pre-push.

When `deliverable_type == application` (or unset), for EVERY step's
`implementation_notes`, include this directive verbatim unless the step is
documented as exempt:

  TEST PARADIGM (mandatory): Unit tests for this step MUST be written as
  property-based tests using Hypothesis @given strategies + state-delta
  matchers (assert_state_delta over a declared universe with strict=True).
  Single-example unit tests are FALLBACK only — document why in a
  `# bypass:` comment if used. Acceptance scenarios MUST be framed as
  Property: blocks (quantified preconditions + invariant outcomes) where
  the contract supports it; classic Scenario: is fallback. Integration
  and E2E tests REMAIN single-example — they verify wiring, not
  invariants. Universe declaration is mandatory even when only one slot
  is checked: the unchanged() predicate covers the rest.

  STAGE CONTEXT (cascade): NEW code = Stage 0 (paradigm-from-day-zero,
  no debt accumulates). Bug-prone legacy code = Stage 1 first (state-
  delta migration captures hidden mutations, 33-75% yield), THEN Stage 2
  PBT amplification (low yield by design — surface is debt-paid). Don't
  expect high hit rate on Stage-1-completed surfaces; that's healthy.
  See nw-tdd-methodology::Paradigm Mandate for the full debt-payoff
  framing.

When a step's contract genuinely cannot be expressed as a property
(e.g., golden-file diff, exact error string, single-shot UI flow),
include in `implementation_notes`:

  EXEMPT FROM PARADIGM: <one-sentence reason>. Compensate with
  property-based test at <unit|integration> level on adjacent slot.

Context to pass (if available): measurement baseline|mikado-graph.md|existing docs.

  1. Validate — Run des-roadmap validate via Bash. Gate: exit 0 = success; exit 1 = print errors and stop; exit 2 = usage error, stop.
bash
des-roadmap validate docs/feature/{feature-id}/deliver/roadmap.json

Invocation Principles

Keep agent prompt minimal. Agent knows roadmap structure and planning methodology.

Pass: skeleton file path + goal description + measurement context (if available). Do not pass: YAML templates|phase guidance|step decomposition rules.

For performance roadmaps, include measurement context inline so agent can validate targets against baselines.

Success Criteria

Show full SKILL.md (171 more words)Show less
Dispatcher (you) — all 4 must be checked
  • 1. Parameters parsed (agent name, goal, feature-id)
  • 2. des.cli.roadmap init executed via Bash (exit 0)
  • 3. Agent invoked via Task tool to fill TODO placeholders
  • 4. des.cli.roadmap validate executed via Bash (exit 0)
Agent output (reference)
  • 5. All TODO placeholders replaced with real content
  • 6. Steps are self-contained and atomic
  • 7. Acceptance criteria are behavioral and measurable
  • 8. Step decomposition ratio <= 2.5 (steps / production files)
  • 9. Dependencies mapped, time estimates provided

Error Handling

  • Invalid agent: report valid agents and stop
  • Missing goal: show usage syntax and stop
  • Scaffold failure (exit 2): report CLI error and stop
  • Validation failure (exit 1): print errors, do not proceed

Examples

Example 1: Standard architecture roadmap
/nw-roadmap @nw-solution-architect "Migrate authentication to OAuth2"

Derives feature-id="migrate-auth-to-oauth2", scaffolds skeleton, invokes agent to fill TODOs, validates. Produces docs/feature/migrate-auth-to-oauth2/deliver/roadmap.json.

Example 2: Performance roadmap with measurement context
/nw-roadmap @nw-solution-architect "Optimize test suite execution"

Passes measurement data inline. Agent fills skeleton, validates targets against baseline, prioritizes largest bottleneck first.

Example 3: Mikado refactoring
/nw-roadmap @nw-software-crafter "Extract payment module from monolith"

Agent fills skeleton with methodology: mikado, references mikado-graph.md, maps leaf nodes to steps.

Workflow Context

bash
/nw-roadmap @agent "goal"           # 1. Plan (init -> agent fills -> validate)
/nw-execute @agent "feature-id" "01-01" # 2. Execute steps
/nw-finalize @agent "feature-id"        # 3. Finalize

© nWave-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in nWave/skills/nw-roadmap of nWave-ai/nWave.

Open the folder on GitHubat commit da401a8

Compare with similar skills

Nw Roadmap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nw Roadmap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nw Roadmap this skillnWave-ai/nWave616—~1.8kAutomated safety check: PassMIT
Invokta Deliveryvinilana/invokta139—~894Automated safety check: PassMIT
Speccodewithmukesh/dotnet-claude-kit756—~2kAutomated safety check: PassMIT
Prd V07 Implementation Loopmattgierhart/PRD-driven-context-engineering180—~5.1kAutomated safety check: NotesMIT
Task Reviewer ChorusChorus-AIDLC/Chorus1.2k—~5.3kAutomated safety check: PassAGPL-3.0
Prd V07 Test Planningmattgierhart/PRD-driven-context-engineering180—~3.5kAutomated safety check: NotesMIT

Similar skills

  • Invokta Delivery

    vinilana/invokta

    Deliver Invokta milestones and work items with TDD, adherence to versioned contracts and architecture, complete validation, and one cohesive commit per work item.

    139 GitHub stars~894 tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • Spec

    codewithmukesh/dotnet-claude-kit

    Turn a vague feature or product idea into an agreed, persisted specification through relentless structured questioning.

    756 GitHub stars~2k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Prd V07 Implementation Loop

    mattgierhart/PRD-driven-context-engineering

    Execute implementation within EPICs following test-first development, continuous SoT updates, and code traceability during PRD v0.7 Build Execution.

    180 GitHub stars~5.1k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check: notes
  • Task Reviewer Chorus

    Chorus-AIDLC/Chorus

    Read-only adversarial Chorus task reviewer — independently verifies an implementation against its acceptance criteria and posts a single structured VERDICT comment.

    1.2k GitHub stars~5.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Prd V07 Test Planning

    mattgierhart/PRD-driven-context-engineering

    Define test cases BEFORE implementation, ensuring every API, business rule, and user journey has verifiable acceptance criteria during PRD v0.7 Build Execution.

    180 GitHub stars~3.5k tokensUpdated 1 mo ago
    Testing & QAAuto-check: notes
  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed

More from nWave-ai/nWave

All 14 skills in this repo
  • DELIVER wave orchestration workflow -- 9 phases from baseline to finalization.

    616 GitHub stars~974 tokensUpdated 24 days ago
    Auto-check passed
  • Nw Diagram

    nWave-ai/nWave

    Generates C4 architecture diagrams (context, container, component) in Mermaid or PlantUML.

    616 GitHub stars~640 tokensUpdated 24 days ago
    Auto-check passed
  • Nw Diverge

    nWave-ai/nWave

    Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence.

    616 GitHub stars~2.2k tokensUpdated 24 days ago
    Auto-check passed
  • Nw Document

    nWave-ai/nWave

    Creates evidence-based documentation following DIVIO/Diataxis principles.

    616 GitHub stars~1.4k tokensUpdated 24 days ago
    Auto-check passed
  • Nw Execute

    nWave-ai/nWave

    A skill your agent uses when a DELIVER roadmap already exists and you need to dispatch exactly one identified step through its TDD cycle.

    616 GitHub stars~3k tokensUpdated 24 days ago
    Auto-check passed
  • Nw Forge

    nWave-ai/nWave

    Creates new specialized agents using the 5-phase workflow (ANALYZE DESIGN CREATE VALIDATE REFINE).

    616 GitHub stars~626 tokensUpdated 24 days ago
    Auto-check passed

Works with

Questions about Nw Roadmap

What does Nw Roadmap do?

Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Nw Roadmap is an agent skill from nWave-ai/nWave.json for a feature goal with acceptance criteria and TDD steps.

When should I use Nw Roadmap?

Nw Roadmap fits situations like: planning implementation steps before execution; tasks that involve User stories; tasks that involve Test-driven development.

How do I install Nw Roadmap in Claude Code?

Run `npx skills add nWave-ai/nWave --skill nw-roadmap -a claude-code`. Or copy the skill folder (nWave/skills/nw-roadmap in nWave-ai/nWave) into .claude/skills/nw-roadmap in your project. Claude Code loads it when a task matches its description.

How do I install Nw Roadmap in Codex?

Run `npx skills add nWave-ai/nWave --skill nw-roadmap -a codex`. Or copy the skill folder (nWave/skills/nw-roadmap in nWave-ai/nWave) into .agents/skills/nw-roadmap in your project. Codex loads it when a task matches its description.

Can I use Nw Roadmap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nWave-ai/nWave --skill nw-roadmap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nw-roadmap, .gemini/skills/nw-roadmap, .github/skills/nw-roadmap and .opencode/skills/nw-roadmap in your project.

What does Nw Roadmap need to run?

SKILL.md names no scripts, command-line tools or credentials: Nw Roadmap is instructions for the agent only.

Does Nw Roadmap access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nw Roadmap safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nw Roadmap use?

Nw Roadmap is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nw Roadmap use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nw Roadmap?

Skills that share tags, products or a category with Nw Roadmap: Invokta Delivery (vinilana/invokta, 139 stars), Spec (codewithmukesh/dotnet-claude-kit, 756 stars), Prd V07 Implementation Loop (mattgierhart/PRD-driven-context-engineering, 180 stars) and Task Reviewer Chorus (Chorus-AIDLC/Chorus, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nw Roadmap?

nWave-ai (a GitHub organization) maintains it in nWave-ai/nWave, which has 616 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 16, 2026.

Source: nWave-ai/nWave on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.