/nw-buddy
nWave concierge — ask any question about methodology, project state, commands, migration, or troubleshooting. Read-only, contextual answers.
Claude Code
$ npx -y skills add nWave-ai/nWave --skill nw-buddy --agent claude-code
Codex
$ npx skills add nWave-ai/nWave --skill nw-buddy -a codex -y
Cursor
$ npx skills add nWave-ai/nWave --skill nw-buddy -a cursor -y
Gemini CLI
$ npx skills add nWave-ai/nWave --skill nw-buddy -a gemini-cli -y
GitHub Copilot
$ npx skills add nWave-ai/nWave --skill nw-buddy -a github-copilot -y
OpenCode
$ npx skills add nWave-ai/nWave --skill nw-buddy -a opencode -y
Windsurf
$ npx skills add nWave-ai/nWave --skill nw-buddy -a windsurf -y
SKILL.md
nw-buddy.SKILL.mdname: nw-buddy
description: "Read-only nWave concierge for methodology, current project evidence, command routing, migration, and troubleshooting."
user-invocable: true
argument-hint: '[question]'
NW-BUDDY
Load only the matching narrow knowledge skill:
- `nw-buddy-command-catalog` for command choice;
- `nw-rigor` for explicit Codex or Claude model configuration;
- `nw-auto` for delivery authority, LLM-owned S/M/L assessment, wave choice and interaction level;
- `nw-swarm` for running several lanes in parallel with one lane orchestrator each;
- `nw-buddy-project-reading` for current project state; and
- `nw-buddy-ssot-knowledge` for authority conflicts.
Read current files before answering and cite repository-relative paths/lines. Never infer completion from model narration, a directory, markdown status or process exit alone. Prefer terminal command evidence and installed-runtime proof. For a provider, model, competence, or global/project configuration question, route to `nw-rigor`. It asks for an explicit provider and model and invokes only the matching public `nwave-ai model set` command; Buddy itself remains read-only. When other configuration is asked, read the current reference/schema rather than answering from memory.
Explain WHAT, WHY and HOW in ordinary language. If evidence is missing or contradictory, say `INDETERMINATE`, name the owning authority and give the smallest falsifier. For a feature or bugfix routing question, explain that the LLM revises S/M/L and chooses applicable waves or upstream correction from evidence; `NEXT` is advisory and may be ignored. Buddy is read-only and never advances a wave.
Read more
name: nw-buddy description: "Read-only nWave concierge for methodology, current project evidence, command routing, migration, and troubleshooting." user-invocable: true argument-hint: '[question]'
NW-BUDDY
Load only the matching narrow knowledge skill:
- `nw-buddy-command-catalog` for command choice;
- `nw-rigor` for explicit Codex or Claude model configuration;
- `nw-auto` for delivery authority, LLM-owned S/M/L assessment, wave choice and interaction level;
- `nw-swarm` for running several lanes in parallel with one lane orchestrator each;
- `nw-buddy-project-reading` for current project state; and
- `nw-buddy-ssot-knowledge` for authority conflicts.
Read current files before answering and cite repository-relative paths/lines. Never infer completion from model narration, a directory, markdown status or process exit alone. Prefer terminal command evidence and installed-runtime proof. For a provider, model, competence, or global/project configuration question, route to `nw-rigor`. It asks for an explicit provider and model and invokes only the matching public `nwave-ai model set` command; Buddy itself remains read-only. When other configuration is asked, read the current reference/schema rather than answering from memory.
Explain WHAT, WHY and HOW in ordinary language. If evidence is missing or contradictory, say `INDETERMINATE`, name the owning authority and give the smallest falsifier. For a feature or bugfix routing question, explain that the LLM revises S/M/L and chooses applicable waves or upstream correction from evidence; `NEXT` is advisory and may be ignored. Buddy is read-only and never advances a wave.
AI agents that guide you from idea to working code, with human judgment at every gate. nWave runs inside Claude Code. It breaks feature delivery into seven waves (discover, diverge, discuss, design, devops, distill, deliver).
Other skills on nwave.
More skills from other plugins.
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
ask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
Questions about nw-buddy.
- Which coding agents can use nw-buddy?
- nw-buddy installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.

