Skills
nw-ab-critique-dimensions
- nw-ab-critique-dimensions — Review dimensions for validating agent quality - template compliance, safety, testing, and priority validation
nw-abr-critique-dimensions
- nw-abr-critique-dimensions — Review dimensions for validating agent quality - template compliance, safety, testing, and priority validation
nw-ad-critique-dimensions
- nw-ad-critique-dimensions — Review dimensions for acceptance test quality - happy path bias, GWT compliance, business language purity, coverage completeness, walking skeleton user-centricity, priority validation, observable behavior assertions, traceability coverage, and walking skeleton boundary proof
nw-agent-creation-workflow
- nw-agent-creation-workflow — Detailed 5-phase workflow for creating agents - from requirements analysis through validation and iterative refinement
nw-agent-testing
- nw-agent-testing — 5-layer testing approach for agent validation including adversarial testing, security validation, and prompt injection resistance
nw-architectural-styles-tradeoffs
- nw-architectural-styles-tradeoffs — Architectural style selection decision matrices, trade-off analysis, structural enforcement rules, and combination patterns. Load when choosing or evaluating architecture styles.
nw-architecture-patterns
- nw-architecture-patterns — Comprehensive architecture patterns, methodologies, quality frameworks, and evaluation methods for solution architects. Load when designing system architecture or selecting patterns.
nw-at-completeness-check
- nw-at-completeness-check — Canonical AT completeness gate — research-anchored 7-category taxonomy (C1-C7) + 15-item mechanical checklist. Paradigm-neutral. Drives acceptance-designer reviewer verdict deterministically.
nw-authoritative-sources
- nw-authoritative-sources — Domain-specific authoritative source databases, search strategies by topic category, and source freshness rules
nw-bdd-methodology
- nw-bdd-methodology — BDD patterns for acceptance test design - Given-When-Then structure, scenario writing rules, pytest-bdd implementation, anti-patterns, and living documentation
nw-bdd-requirements
- nw-bdd-requirements — BDD requirements discovery methodology - Example Mapping, Three Amigos, conversational patterns, Given-When-Then translation, and collaborative specification
nw-brainstorming
- nw-brainstorming — Structured divergent thinking techniques — HMW framing, SCAMPER, Crazy 8s mechanics, and option diversity guarantees. Enforces strict separation of generation and evaluation phases.
nw-buddy
- nw-buddy — nWave concierge — ask any question about methodology, project state, commands, migration, or troubleshooting. Read-only, contextual answers.
nw-buddy-command-catalog
- nw-buddy-command-catalog — 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-buddy-project-reading
- nw-buddy-project-reading — How the nWave buddy agent reads a project to answer questions — detection, order of inspection, and citation discipline.
nw-buddy-ssot-knowledge
- nw-buddy-ssot-knowledge — Single Source of Truth detection — where truth lives in an nWave repo and how to avoid contradicting it.
nw-buddy-wave-knowledge
- nw-buddy-wave-knowledge — Wave methodology knowledge for the buddy agent — what each wave does, its inputs and outputs, and how to route questions.
nw-bugfix
- nw-bugfix — Bug fix workflow: root cause analysis → user review → regression test + fix via TDD
nw-canary
- nw-canary — Canary skill for auto-injection detection
nw-cicd-and-deployment
- nw-cicd-and-deployment — CI/CD pipeline design methodology, deployment strategies, GitHub Actions patterns, and branch/release strategies. Load when designing pipelines or deployment workflows.
nw-collaboration-and-handoffs
- nw-collaboration-and-handoffs — Cross-agent collaboration protocols, workflow handoff patterns, and commit message formats for TDD/Mikado/refactoring workflows
nw-collapse-detection
- nw-collapse-detection — Documentation collapse anti-patterns - detection rules, bad examples, and remediation strategies for type-mixing violations
nw-command-design-patterns
- nw-command-design-patterns — Best practices for command definition files - size targets, declarative template, anti-patterns, and canonical examples based on research evidence
nw-command-optimization-workflow
nw-continue
- nw-continue — Detects current wave progress for a feature and resumes at the next step. Scans docs/feature/ for artifacts.
nw-data-architecture-patterns
- nw-data-architecture-patterns — Data architecture patterns (warehouse, lake, lakehouse, mesh), ETL/ELT pipelines, streaming architectures, scaling strategies, and schema design patterns
nw-database-technology-selection
- nw-database-technology-selection — Database comparison catalogs, RDBMS vs NoSQL selection criteria, CAP/ACID/BASE theory, OLTP vs OLAP, and technology-specific characteristics
nw-ddd-event-modeling
- nw-ddd-event-modeling — Event Modeling facilitation technique — brainstorm events, identify commands and views, define aggregate boundaries, write Given-When-Then specifications
nw-ddd-eventsourcing
- nw-ddd-eventsourcing — Event Sourcing and CQRS as DDD implementation patterns — when to use, aggregate event streams, projections, snapshots, sagas, upcasting, conflict resolution
nw-ddd-strategic
- nw-ddd-strategic — Strategic DDD — bounded context discovery, context mapping patterns, subdomain classification, ubiquitous language, and organizational alignment
nw-ddd-tactical
- nw-ddd-tactical — Tactical DDD — aggregate design rules, entities, value objects, domain events, repositories, domain services, and anti-pattern detection
nw-deliver
- nw-deliver — Orchestrates the full DELIVER wave end-to-end (roadmap > execute-all > finalize). Use when all prior waves are complete and the feature is ready for implementation.
nw-deliver-orchestration
- nw-deliver-orchestration — DELIVER wave orchestration workflow -- 9 phases from baseline to finalization. Load when user invokes *deliver command. Covers state tracking, smart skip logic, retry, resume, and quality gate enforcement.
nw-density-resolution-contract
- nw-density-resolution-contract — Shared density-resolution contract for wave skills. Canonical detail on the D12 cascade, density resolver call, ad-hoc override workflow, and DocumentationDensityEvent telemetry emission. Referenced from nw-discover / nw-discuss / nw-design / nw-devops / nw-distill / nw-deliver.
nw-deployment-strategies
- nw-deployment-strategies — Rollback procedures, risk assessment, pre/post-deployment validation, and contingency planning. Load when orchestrating deployment or preparing rollback plans. For deployment strategy details (canary, blue-green, rolling), see
cicd-and-deployment skill.
nw-design
- nw-design — Designs system architecture with C4 diagrams and technology selection. Routes to the right architect based on design scope (system, domain, application, or full stack). Two interaction modes: guide (collaborative Q&A) or propose (architect presents options with trade-offs).
nw-design-methodology
- nw-design-methodology — Apple LeanUX++ design workflow, journey schema, emotional arc patterns, and CLI UX patterns. Load when transitioning from discovery to visualization or when designing journey artifacts.
nw-design-patterns
- nw-design-patterns — 7 agentic design patterns with decision tree for choosing the right pattern for each agent type
nw-devops
- nw-devops — Designs CI/CD pipelines, infrastructure, observability, and deployment strategy. Use when preparing platform readiness for a feature.
nw-diagram
- nw-diagram — Generates C4 architecture diagrams (context, container, component) in Mermaid or PlantUML. Use when creating or updating architecture visualizations.
nw-discover
- nw-discover — Conducts evidence-based product discovery through customer interviews and assumption testing. Use at project start to validate problem-solution fit.
nw-discovery-methodology
- nw-discovery-methodology — Question-first approach to understanding user journeys. Load when starting a new journey design or when the discovery phase needs deepening.
nw-discovery-workflow
- nw-discovery-workflow — 4-phase discovery workflow with decision gates, phase transitions, success metrics, and state tracking
nw-discuss
- nw-discuss — Conducts Jobs-to-be-Done analysis, UX journey design, and requirements gathering through interactive discovery. Use when starting feature analysis, defining user stories, or creating acceptance criteria.
nw-distill
- nw-distill — Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.
nw-diverge
- nw-diverge — Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence. Use when the team has a validated problem but hasn't chosen a solution approach.
nw-diverger-review-criteria
- nw-diverger-review-criteria — Review criteria for the nw-diverger-reviewer — validates JTBD rigor, research quality, option diversity, taste application correctness, and recommendation coherence in DIVERGE wave artifacts
nw-divio-framework
- nw-divio-framework — DIVIO/Diataxis four-quadrant documentation framework - type definitions, classification decision tree, and signal catalog
nw-document
- nw-document — Creates evidence-based documentation following DIVIO/Diataxis principles. Use when writing tutorials, how-to guides, reference docs, or explanations.
nw-domain-driven-design
- nw-domain-driven-design — Strategic and tactical DDD patterns, bounded context discovery, context mapping, aggregate design rules, and decision frameworks for when to apply DDD
nw-dor-validation
- nw-dor-validation — Definition of Ready checklist criteria, antipattern detection patterns, UAT quality rules, and domain language enforcement for product owner review
nw-dr-review-criteria
- nw-dr-review-criteria — Critique dimensions, severity framework, verdict decision matrix, and review output format for documentation assessment reviews
nw-execute
- nw-execute — Dispatches one unit of DELIVER work to a specialized agent for TDD execution. Runs a single roadmap.json step through the TDD cycle.
nw-fast-forward
- nw-fast-forward — Fast-forwards through remaining waves end-to-end without stopping for review between waves.
nw-finalize
- nw-finalize — Archives a completed feature to docs/evolution/, migrates lasting artifacts to permanent directories, and cleans up the temporary workspace. Use after all implementation steps pass and mutation testing completes.
nw-five-whys-methodology
- nw-five-whys-methodology — Toyota 5 Whys methodology with multi-causal branching, evidence requirements, and validation techniques
nw-forge
- nw-forge — Creates new specialized agents using the 5-phase workflow (ANALYZE > DESIGN > CREATE > VALIDATE > REFINE). Use when building a new AI agent or validating an existing agent specification.
nw-fp-algebra-driven-design
nw-fp-clojure
- nw-fp-clojure — Clojure language-specific patterns, data-first modeling, REPL-driven development, and spec
nw-fp-domain-modeling
- nw-fp-domain-modeling — Domain modeling with algebraic data types, smart constructors, and type-level error handling
nw-fp-fsharp
- nw-fp-fsharp — F# language-specific patterns, Railway-Oriented Programming, and Computation Expressions
nw-fp-haskell
- nw-fp-haskell — Haskell language-specific patterns, GADTs, type classes, and effect systems
nw-fp-hexagonal-architecture
nw-fp-kotlin
- nw-fp-kotlin — Kotlin language-specific patterns with Arrow, Raise DSL, and coroutine-based effects
nw-fp-principles
- nw-fp-principles — Core functional programming thinking patterns and type system foundations, language-agnostic
nw-fp-scala
- nw-fp-scala — Scala 3 language-specific patterns with ZIO, Cats Effect, and opaque types
nw-fp-usable-design
- nw-fp-usable-design — Naming conventions, API ergonomics, and usability patterns for functional code
nw-hexagonal-testing
- nw-hexagonal-testing — 5-layer agent output validation, I/O contract specification, vertical slice development, and test doubles policy with per-layer examples
nw-hotspot
- nw-hotspot — Git change frequency hotspot analysis — find the most-changed files in your codebase
nw-infrastructure-and-observability
- nw-infrastructure-and-observability — Infrastructure as Code patterns (Terraform, Kubernetes), observability design (SLOs, metrics, alerting, dashboards), and pipeline security stages. Load when designing infrastructure, observability, or security scanning.
nw-interviewing-techniques
- nw-interviewing-techniques — Mom Test questioning toolkit, JTBD analysis, interview conduct, assumption testing framework, and hypothesis design
nw-investigation-techniques
nw-jtbd-analysis
- nw-jtbd-analysis — JTBD methodology for extracting real jobs behind feature requests — job statements, abstraction layers, first-principles extraction, ODI outcome statements, and opportunity scoring
nw-jtbd-bdd-integration
- nw-jtbd-bdd-integration — Translating JTBD analysis to BDD scenarios - job story to Given-When-Then patterns, forces-based test discovery, job-map-based test discovery, and property-shaped criteria
nw-jtbd-core
- nw-jtbd-core — Core JTBD theory and job story format - job dimensions, job story template, job stories vs user stories, 8-step universal job map, outcome statements, and forces of progress
nw-jtbd-interviews
- nw-jtbd-interviews — JTBD discovery techniques adapted for AI product owner context. Four Forces extraction, job dimension probing, question banks, and anti-patterns for interactive feature discovery conversations.
nw-jtbd-opportunity-scoring
- nw-jtbd-opportunity-scoring — JTBD opportunity scoring and prioritization - outcome statement format, opportunity algorithm, scoring interpretation, feature prioritization, and opportunity matrix template
nw-jtbd-workflow-selection
- nw-jtbd-workflow-selection — JTBD workflow classification and routing - ODI two-phase framework, five job types with workflow sequences, baseline type selection, workflow anti-patterns, and common recipes
nw-leanux-methodology
- nw-leanux-methodology — LeanUX backlog management methodology - user story template, story sizing, story states, task types, Definition of Ready/Done, anti-pattern detection and remediation
nw-legacy-refactoring-ddd
- nw-legacy-refactoring-ddd — DDD-guided legacy refactoring patterns -- strangler fig, bubble context, ACL migration, 14 tactical/strategic/infrastructure patterns, and incremental monolith-to-microservices methodology
nw-mikado
- nw-mikado — [EXPERIMENTAL] Complex refactoring roadmaps with visual tracking
nw-mikado-method
- nw-mikado-method — Enhanced Mikado Method for complex architectural refactoring - systematic dependency discovery, tree-based planning, and bottom-up execution
nw-mutation-test
- nw-mutation-test — Runs feature-scoped mutation testing to validate test suite quality. Use after implementation to verify tests catch real bugs (kill rate >= 80%).
nw-new
- nw-new — Guided wizard to start a new feature. Asks what you want to build, recommends the right starting wave, and launches it.
nw-operational-safety
- nw-operational-safety — Tool safety protocols, adversarial output validation, error recovery patterns, and I/O contracts for research operations
nw-opportunity-mapping
- nw-opportunity-mapping — Opportunity Solution Trees, opportunity scoring, Lean Canvas, JTBD job mapping, and technique selection guide
nw-optimize-tests
- nw-optimize-tests — Minimizes test count while preserving coverage. Detects byte-identical pairs, parametrize-inflation, language-guarantee tests, AST-shape tests, stale migration nets. Approval gate before any change.
nw-outcome-kpi-framework
- nw-outcome-kpi-framework — Outcome KPI definition methodology - synthesizes Who Does What By How Much (Gothelf/Seiden), Running Lean (Maurya), and Measure What Matters (Doerr) into a practical framework for measurable outcome KPIs
nw-par-critique-dimensions
- nw-par-critique-dimensions — Platform design review critique dimensions and severity levels. Load when reviewing CI/CD pipelines, infrastructure, deployment strategies, observability, or security designs.
nw-persona-jtbd-analysis
- nw-persona-jtbd-analysis — Structured persona creation and JTBD analysis methodology - persona templates, ODI job step tables, pain point mapping, success metric quantification, and multi-persona segmentation
nw-po-review-dimensions
- nw-po-review-dimensions — Requirements quality critique dimensions for peer review - confirmation bias detection, completeness validation, clarity checks, testability assessment, and priority validation
nw-post-mortem-framework
- nw-post-mortem-framework — Blameless post-mortem structure, incident timeline reconstruction, response evaluation, and organizational learning
nw-production-readiness
- nw-production-readiness — Monitoring, observability, operational procedures, CI/CD lessons learned, and quality gate definitions. Load when assessing production readiness or validating operational excellence.
nw-production-safety
- nw-production-safety — Agent safety boundaries - input validation, output filtering, scope constraints, and document creation policy
nw-progressive-refactoring
- nw-progressive-refactoring — Progressive L1-L6 refactoring hierarchy, 22 code smell taxonomy, atomic transformations, test code smells, and Fowler refactoring catalog
nw-property-based-testing
- nw-property-based-testing — Property-based testing strategies, mutation testing, shrinking, and combined PBT+mutation workflow for test quality validation
nw-quality-framework
- nw-quality-framework — Quality gates - 11 commit readiness gates, build/test protocol, validation checkpoints, and quality metrics
nw-quality-validation
- nw-quality-validation — Type-specific validation checklists, six quality characteristics, and quality gate thresholds for documentation assessment
nw-query-optimization
- nw-query-optimization — SQL and NoSQL query optimization techniques, indexing strategies, execution plan analysis, JOIN algorithms, cardinality estimation, and database-specific query patterns
nw-refactor
- nw-refactor — Applies the Refactoring Priority Premise (RPP) levels L1-L6 for systematic code refactoring. Use when improving code quality through structured refactoring passes.
nw-research
- nw-research — Gathers knowledge from web and files, cross-references across multiple sources, and produces cited research documents. Use when investigating technologies, patterns, or decisions that need evidence backing.
nw-research-methodology
- nw-research-methodology — Research output templates, distillation workflow, and quality standards for evidence-driven research
nw-review
- nw-review — Dispatches an expert reviewer agent to critique workflow artifacts. Use when a roadmap, implementation, or step needs quality review before proceeding.
nw-review-workflow
- nw-review-workflow — Detailed review process, v2 validation checklist, and scoring methodology for agent definition reviews
nw-rigor
- nw-rigor — Selects a quality-vs-token-consumption profile (lean, standard, thorough, exhaustive, custom, inherit) and persists it globally (~/.nwave/global-config.json) or per-project (.nwave/des-config.json). Use when tuning how much rigor wave commands apply.
nw-roadmap
- nw-roadmap — Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.
nw-roadmap-design
- nw-roadmap-design — Roadmap concision rules, step decomposition efficiency, AC abstraction guidelines, and step-to-scenario mapping. Load when creating implementation roadmaps.
nw-roadmap-review-checks
- nw-roadmap-review-checks — Roadmap-specific validation checks for architecture reviews. Load when reviewing roadmaps for implementation readiness.
nw-rr-critique-dimensions
nw-sa-critique-dimensions
- nw-sa-critique-dimensions — Architecture quality critique dimensions for peer review. Load when invoking solution-architect-reviewer or performing self-review of architecture documents.
nw-sar-critique-dimensions
- nw-sar-critique-dimensions — Architecture quality critique dimensions for peer review. Load when performing architecture document reviews.
nw-sc-review-dimensions
- nw-sc-review-dimensions — Reviewer critique dimensions for peer review - implementation bias detection, test quality validation, completeness checks, and priority validation
nw-sd-case-studies
- nw-sd-case-studies — 25 real-world system design case studies condensed from Alex Xu's System Design Interview Vol 1 and 2 - requirements, architecture, deep dive insights, key takeaways
nw-sd-framework
- nw-sd-framework — 4-step system design framework with back-of-envelope estimation, scaling ladder, and common pitfalls
nw-sd-patterns
- nw-sd-patterns — Core distributed systems patterns - load balancing, caching, sharding, consistent hashing, message queues, rate limiting, CDN, Bloom filters, ID generation, replication, conflict resolution, CAP theorem
nw-sd-patterns-advanced
- nw-sd-patterns-advanced — Advanced distributed patterns - event sourcing, CQRS, saga, stream processing, append-only log, exactly-once delivery, sequencer, double-entry ledger, erasure coding, order book, watermarks
nw-security-and-governance
- nw-security-and-governance — Database security (encryption, access control, injection prevention), data governance (lineage, quality, MDM), and compliance frameworks (GDPR, CCPA, HIPAA)
nw-security-by-design
- nw-security-by-design — Security design principles, STRIDE threat modeling, OWASP Top 10 architectural mitigations, and secure patterns. Load when designing systems or reviewing architecture for security.
nw-shared-artifact-tracking
- nw-shared-artifact-tracking — Shared artifact registry, common artifact patterns, and integration validation. Load when tracking data that flows across journey steps or validating horizontal coherence.
nw-source-verification
- nw-source-verification — Source reputation tiers, cross-referencing methodology, bias detection, and citation format requirements
nw-speculative-dispatch
- nw-speculative-dispatch — Speculative parallel implementation methodology — dispatch N candidate implementations, audit all, score, pick best. Auditability mandate: ALL candidates logged (not just winner).
nw-spike
- nw-spike — Runs a timeboxed PROBE to validate one core assumption, then optionally PROMOTES the probe into a walking skeleton — the first e2e thin slice of the feature, committed and demo-able. Use after DISCUSS when the feature involves a new mechanism, performance requirement, or external integration.
nw-spike-methodology
- nw-spike-methodology — Teaches agents how to run a timeboxed spike - throwaway code that validates one assumption before DESIGN
nw-stakeholder-engagement
- nw-stakeholder-engagement — Demonstration preparation, audience-tailored presentations, feedback collection, and business outcome measurement. Load when preparing demos or measuring business value delivery.
nw-stress-analysis
- nw-stress-analysis — Advanced architecture stress analysis methodology for designing systems that survive unknown stresses. Load when --residuality flag is used or when designing high-uncertainty, mission-critical systems.
nw-taste-evaluation
- nw-taste-evaluation — Design taste evaluation framework — DVF primary filter, Apple/Google/Jobs design principles as explicit scoring criteria, weighted decision matrix, and option ranking for the DIVERGE wave
nw-tdd-cross-language
- nw-tdd-cross-language — Port the state-delta + property-based testing paradigm to languages other than Python. DIY recipes per language; canonical Python ref shipped in nwave_ai.state_delta.
nw-tdd-methodology
- nw-tdd-methodology — Deep knowledge for Outside-In TDD - double-loop architecture, ATDD integration, port-to-port testing, walking skeletons, and test doubles policy
nw-tdd-review-enforcement
- nw-tdd-review-enforcement — Test design mandate enforcement, test budget validation, TDD phase validation (3-phase canon per ADR-025), and external validity checks for the software crafter reviewer
nw-test-design-mandates
- nw-test-design-mandates — Design mandates for acceptance tests - hexagonal boundary, business language abstraction, user journey completeness, pure function extraction, 3 Pillars (domain language / chained narrative / production composition), and the layered ATD discipline (Universe-bound assertion, layer-dependent PBT mode, two-tier acceptance, example-based sad paths)
nw-test-optimization
- nw-test-optimization — Methodology for minimizing test count while maximizing behavioral coverage - behavior definition, anti-pattern catalog, consolidation patterns, stopping criterion, coverage-preserving validation
nw-test-organization-conventions
- nw-test-organization-conventions — Test directory structure patterns by architecture style, language conventions, naming rules, and fixture placement. Decision tree for selecting test organization strategy.
nw-test-refactoring-catalog
- nw-test-refactoring-catalog — Detailed refactoring mechanics with step-by-step procedures, and test code smell catalog with detection patterns and before/after examples
nw-update
- nw-update — Queues a deferred self-update of nwave-ai. Writes a PendingUpdateFlag that the SessionStart hook replays on the next Claude Code launch, so the current session is not interrupted. Falls back to manual instructions when the package manager cannot be detected.
nw-user-story-mapping
- nw-user-story-mapping — 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-ux-desktop-patterns
- nw-ux-desktop-patterns — 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-ux-emotional-design
- nw-ux-emotional-design — 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-principles
- nw-ux-principles — Core UX principles for product owners. Load when evaluating interface designs, writing acceptance criteria with UX requirements, or reviewing wireframes and mockups.
nw-ux-tui-patterns
- nw-ux-tui-patterns — 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-web-patterns
- nw-ux-web-patterns — Web UI design patterns for product owners. Load when designing web application interfaces, writing web-specific acceptance criteria, or evaluating responsive designs.
nw-wizard-shared-rules
- nw-wizard-shared-rules — Shared rules for feature ID derivation and wave detection used by /nw-new, /nw-continue, and /nw-fast-forward wizards