nw-buddy

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

322 stars

Best use case

nw-buddy is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using nw-buddy should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/nw-buddy/SKILL.md --create-dirs "https://raw.githubusercontent.com/nWave-ai/nWave/main/nWave/skills/nw-buddy/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/nw-buddy/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How nw-buddy Compares

Feature / Agentnw-buddyStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 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.

## Agent Invocation

@nw-nwave-buddy

Execute *help to show capabilities, or ask any nWave question directly.

**Configuration:**
- model: sonnet (optimized for frequent, low-cost interactions)
- mode: read-only (never creates or modifies files)

## Success Criteria

- [ ] Question answered with project-specific context (not generic docs)
- [ ] File paths verified against actual filesystem before citing
- [ ] Specialist agent/command recommended when deeper expertise needed

## Examples

```
/nw-buddy Where are the documents for my rate-limiting feature?
/nw-buddy What should I do next?
/nw-buddy What's JTBD?
/nw-buddy How do I migrate to the SSOT model?
/nw-buddy My DISTILL is failing — architecture missing
```

## Expected Outputs

- Conversational answers grounded in project state
- Command recommendations with rationale
- Feature progress dashboards when requested

Related Skills

nw-buddy-wave-knowledge

322
from nWave-ai/nWave

Wave methodology knowledge for the buddy agent — what each wave does, its inputs and outputs, and how to route questions.

nw-buddy-ssot-knowledge

322
from nWave-ai/nWave

Single Source of Truth detection — where truth lives in an nWave repo and how to avoid contradicting it.

nw-buddy-project-reading

322
from nWave-ai/nWave

How the nWave buddy agent reads a project to answer questions — detection, order of inspection, and citation discipline.

nw-buddy-command-catalog

322
from nWave-ai/nWave

All /nw-* commands — what they do, when to use them, which agent they invoke. For the buddy agent to help users pick the right command.

nw-ux-web-patterns

322
from nWave-ai/nWave

Web UI design patterns for product owners. Load when designing web application interfaces, writing web-specific acceptance criteria, or evaluating responsive designs.

nw-ux-tui-patterns

322
from nWave-ai/nWave

Terminal UI and CLI design patterns for product owners. Load when designing command-line tools, interactive terminal applications, or writing CLI-specific acceptance criteria.

nw-ux-principles

322
from nWave-ai/nWave

Core UX principles for product owners. Load when evaluating interface designs, writing acceptance criteria with UX requirements, or reviewing wireframes and mockups.

nw-ux-emotional-design

322
from nWave-ai/nWave

Emotional design and delight patterns for product owners. Load when designing onboarding flows, empty states, first-run experiences, or evaluating the emotional quality of an interface.

nw-ux-desktop-patterns

322
from nWave-ai/nWave

Desktop application UI patterns for product owners. Load when designing native or cross-platform desktop applications, writing desktop-specific acceptance criteria, or evaluating panel layouts and keyboard workflows.

nw-user-story-mapping

322
from nWave-ai/nWave

User story mapping for backlog management and outcome-based prioritization. Load during Phase 2.5 (User Story Mapping) to produce story-map.md and prioritization.md.

nw-tr-review-criteria

322
from nWave-ai/nWave

Review dimensions and scoring for root cause analysis quality assessment

nw-tlaplus-verification

322
from nWave-ai/nWave

TLA+ formal verification for design correctness and PBT pipeline integration