Skip to content

nWave-ai/nWave / nWave/skills/nw-tdd-methodology

nw-tdd-methodology

Verified

Deep knowledge for Outside-In TDD - double-loop architecture, ATDD integration, port-to-port testing, walking skeletons, and test doubles policy

Outside-In TDD Methodology

Lean composing core. The deep knowledge is decomposed into seven one-job-one-trigger modules; five ship as skills under the nw-tdd-methodology-* prefix and the other two are summarised in this core. This core keeps the name (shared — the crafters, acceptance-designer, distill, and the test-optimizer all reference it) and routes to the module whose trigger fires. Load the module(s) for the job in play; do not re-inline their content here.

Composition — module → trigger

ModuleJobTrigger (when to load)
(summarised below)the full TDD cyclethe invocation owns test authoring and runs RED→GREEN→COMMIT; production-only craft against an immutable oracle does not trigger this job
(summarised below)workflow shapedeciding the development-workflow shape — double-loop, Outside-In vs Inside-Out, lightweight ATDD, BDD, Bache workflow, unit-of-behavior framing
nw-tdd-methodology-port-to-porttest boundarydeciding what a test enters/asserts on — port-to-port discipline, the layer-specific Universe, refactoring-resilience, hexagonal per-layer strategy
nw-tdd-methodology-test-doubleschoose a doublechoosing/building a test double — Meszaros taxonomy, classical-vs-mockist, mock-only-at-port-boundaries policy, doubles-must-validate-inputs contract
nw-tdd-methodology-walking-skeletonbuild a WSbuilding/validating a walking skeleton — WS protocol, feature-level skeleton with incremental slice coverage, Mandate 5 adapter-strategy decision tree, Mandate 6 adapter real-I/O, adapter-integration RED-phase semantics
nw-tdd-methodology-paradigmwrite a unit/acceptance testwriting a unit or acceptance test — property-based + state-delta mandate, applicability matrix, debt-payoff curve, delta-first trigger/bypass
nw-tdd-methodology-pbt-deepwrite a PBT (deep)writing a property-based test needing deep mechanics — A13/P6 stateful preconditions, four property-finding strategies, two shrinking mechanisms, targeted/search-based PBT

How to use

  1. Identify the job in play (which trigger fires).
  2. Read ~/.claude/skills/nw-tdd-methodology-{module}/SKILL.md for that job unless its body is already preloaded or the job is summarised below.
  3. For an invocation owning the full test-authoring cycle, apply the cycle summary + -paradigm; add other modules when their triggers apply. Managed production-only crafters implement against the immutable ATD-owned oracle and report oracle defects to its owner; the cycle summary grants no test-authoring or commit authority.

The seven modules together cover the full methodology.

Jobs summarised in this core

  • Cycle — 3-phase RED/GREEN/COMMIT canon. A new test must fail for the right reason before any production code is written; GREEN matches the public contract; no production code without a requiring test; after GREEN verify the new code is wired into the real driving port. Code examples follow the project's own language.
  • Workflow shape — double-loop TDD: an outer acceptance test through the driving port stays red while inner unit-level cycles drive the implementation green. Choose Outside-In (acceptance first, collaborators discovered) or Inside-Out (domain first) by how much of the design is known; keep the unit of behavior an observable outcome, not a function or class.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall