nw-bdd-requirements SKILL.md skillA

nw-bdd-requirements from nwave-ai/nwave is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nwave-ai/nwave/nw-bdd-requirements@git:20260407.db3038c

Pins git:20260407.db3038c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nwave-ai/nwave
Path
nWave/skills/nw-bdd-requirements/SKILL.md
Versions recorded
4
Latest version
git:20260407.db3038c, committed Apr 7, 2026
First version recorded
Mar 17, 2026
Size
13,225 bytes
Repository stars
633
License
MIT

BDD requirements discovery methodology - Example Mapping, Three Amigos, conversational patterns, Given-When-Then translation, and collaborative specification.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# BDD Requirements Discovery

"If you're not having conversations, you're not doing BDD." -- Liz Keogh

BDD discovers "what we don't know we don't know" through collaborative exploration with concrete examples, not tools or formats.

## The Three Amigos

Three perspectives revealing each other's blindspots:

1. **Problem Owner** (PO, BA, Domain Expert): business need | acceptance criteria | domain knowledge
2. **Problem Solver** (Developer, Engineer): technical constraints | implementation complexity | technical edge cases
3. **Skeptic** (Tester, QA): failure modes | edge cases and boundaries | challenge assumptions

### Session Structure (25-minute timebox)

1. Read user story aloud (2 min) -- shared context
2. Identify acceptance criteria/rules (8 min) -- "what must be true for done?"
3. Explore examples per rule (12 min) -- concrete scenarios, edge cases
4. Capture questions (ongoing) -- unknowns on red cards
5. Review and summarize (3 min) -- shared understanding check

If unmappable in 25 min: too large (split) | too uncertain (spike) | team needs practice.

## Example Mapping

### Four Card Types
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nwave-ai/nwave/nw-bdd-requirements@sha256:6091f8a557c1a3f8

The line at the top of this page pins the label git:20260407.db3038c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_t2mxcrrktj3lomuu.svg)](https://markdownregistry.com/a/art_t2mxcrrktj3lomuu)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 17, 2026 and Apr 7, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20260407.db3038c latest2026-04-07 db3038c 13,225 BA view · diff
git:20260320.d98f3cb2026-03-20 d98f3cb 12,576 BA view · diff
git:20260318.e6a0e192026-03-18 e6a0e19 12,554 BA view · diff
git:20260317.1d161472026-03-17 1d16147 12,545 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13225 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nwave-ai/nwave · 633 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_t2mxcrrktj3lomuu
GET https://markdownregistry.com/api/v1/resolve?ref=nwave-ai/nwave/nw-bdd-requirements
GET https://markdownregistry.com/api/v1/blob/6091f8a557c1a3f8c94755808979a338504861e3fbb4d51ee5fe89b0c2b4f731

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nwave-ai/nwave

nw-ab-agent-template SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-agent-template/SKILL.md · KNOWLEDGE — the canonical agent-spec template (frontmatter + body skeleton). Reference loaded by the create/migrate…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-anti-patterns SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-anti-patterns/SKILL.md · KNOWLEDGE — agent/skill/command anti-pattern catalog with fixes. Reference scanned by validate-spec; no sequence.
git:20261102.c67d57b · audit A · 633 stars
nw-ab-create-agent SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-create-agent/SKILL.md · PROCEDURE — create a NEW agent via the 5-phase workflow (ANALYZE→DESIGN→CREATE→VALIDATE→REFINE). Trigger: build a new…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-critique-dimensions SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-critique-dimensions/SKILL.md · Review dimensions for validating agent quality - template compliance, safety, testing, and priority validation
git:20260320.d98f3cb · audit A · 633 stars
nw-ab-examples SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-examples/SKILL.md · KNOWLEDGE — canonical worked examples for agent creation, migration, and command optimization. Reference for the…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-house-style SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-house-style/SKILL.md · KNOWLEDGE — caveman-native authoring house style + by-construction guarantees (Reasoning Mandate injection…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-merge-agents SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-merge-agents/SKILL.md · PROCEDURE — merge agent B into agent A, relocating skills and cleaning up all references. Trigger: two agents must…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-migrate-monolith SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-migrate-monolith/SKILL.md · PROCEDURE — migrate one legacy monolithic agent to a lean core plus routed skills. Trigger: an existing agent has…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-optimize-command SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-optimize-command/SKILL.md · PROCEDURE — optimize a bloated command file to a lean declarative definition (forge.md pattern). Trigger: a command…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-optimize-skill SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-optimize-skill/SKILL.md · PROCEDURE — optimize one requested existing skill. Measures multi-trigger, duplication, and resident-context debt…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-validate-spec SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-validate-spec/SKILL.md · PROCEDURE — validate an EXISTING agent spec against the nw-ab-validation-checklist. Trigger: checking a spec for…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-validation-checklist SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-validation-checklist/SKILL.md · KNOWLEDGE (data) — the agent-spec validation checklist. The item definitions the validate-spec procedure RUNS against…
git:20261102.c67d57b · audit A · 633 stars

Every file in nwave-ai/nwave

Browse by kind, by grade A, or by owner.