nw-distill

What problem does it solve?

This skill provides a structured methodology for creating acceptance tests within the DISTILL wave. It encapsulates domain knowledge for acceptance designers, including port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.

Core Features & Use Cases

• Port-to-Port Principle: Every acceptance criterion must name the driving port through which behavior is exercised, enabling tests that are wired to actual system entry points.
• Prior Wave Reading: Before scenario writing, read SSOT and feature delta artifacts to align expectations with upstream decisions.
• Artifact Reconciliation: Reconcile wave decisions across DISCUSS, DESIGN, and DEVOPS artifacts to avoid contradictions.
• Walking Skeleton Strategy: Decide and document walking skeleton strategy, auto-detect adapters, and map them to real or in-memory I/O as appropriate.
• Driving Adapter Verification: Ensure driving adapters are exercised via subprocess/HTTP/hook in at least one walking skeleton scenario.
• Documentation Back-Propagation: Record upstream findings and decisions in docs/feature/{feature-id}/distill/upstream-issues.md when gaps or contradictions are discovered.

Quick Start

Start by gathering SSOT artifacts and identifying driving ports before writing the first set of acceptance-scenario sketches.