# Nw Buddy

NWave concierge, ask any question about methodology, project state, commands...

- Repository: https://github.com/nWave-ai/nWave (628 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-09-16
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nWave-ai/nWave --skill nw-buddy -g -a claude-code -y`
Codex: `npx skills add nWave-ai/nWave --skill nw-buddy -g -a codex -y`
Cursor: `npx skills add nWave-ai/nWave --skill nw-buddy -g -a cursor -y`
Gemini CLI: `npx skills add nWave-ai/nWave --skill nw-buddy -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add nWave-ai/nWave`

## Description

nWave concierge, ask any question about methodology, project state, commands, migration, or troubleshooting. Read-only, contextual answers.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# NW-BUDDY: nWave Concierge

**Wave**: CROSS_WAVE | **Agent**: Guide (nw-nwave-buddy) | **Command**: `/nw-buddy`

## Overview

Ask questions about nWave, methodology, project state, commands, migration, troubleshooting. Guide reads your project and gives contextual answers.

## Configuration questions, mandatory Read-tool instruction (D7)

Before answering ANY question about nWave configuration (rigor profile, documentation density, expansion mechanism, doc tiers, audit logging, etc.):

1. **Read `docs/reference/global-config.md`** using the Read tool, this is the canonical schema reference. Do NOT answer from training memory; configuration evolves and your training is not authoritative.
2. **Read `docs/guides/configuring-doc-density.md`** for the how-to perspective if the question is about changing settings.
3. Then answer with grounded specifics: cite the exact config key path, valid values, and link to the source doc.

Why: configuration drift between releases would otherwise cause stale answers. The reference doc is the contract. (See ADR-001-rigor-as-config-concern.md for the rigor/density inheritance decision.)

### Expansion mechanism, answering "how do I see more detail?"

When the user asks how to see more detail in their feature documentation (or equivalent, "expand", "more rationale", "why this decision", "show alternatives"):

The rest: https://github.com/nWave-ai/nWave/blob/HEAD/nWave/skills/nw-buddy/SKILL.md
