wa:spec-discovery

Guide multi-stage domain requirements discovery and write a structured DISCOVERY.md document.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-spec-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wa:spec-discovery
Source: https://github.com/jeremy-newhouse/eck-e2e-weather-app/tree/main/.claude/skills/spec-discovery
Command: npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-spec-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams collaboratively discover and document complete, testable requirements for a new feature by exploring the right domains and tracking completeness as you go.

Core Features & Use Cases

  • Domain-based requirements discovery: Guides exploration across problem space, users, functional behavior, data/state, priorities, and related areas with gated coverage.
  • Present–React–Confirm workflow: Produces decisions and assumptions only after user validation, with prompts tailored to each domain’s goals.
  • Structured output for implementation: Writes a ready-to-use discovery report to docs/{feature}/DISCOVERY.md that includes requirements, acceptance criteria candidates, open questions, and domain coverage.

Quick Start

Run the spec-discovery skill for a feature idea like user notification preferences to generate a structured discovery document at docs/{feature}/DISCOVERY.md.

Frequently Asked Questions about wa:spec-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I discover and document complete feature requirements collaboratively?

To discover feature requirements collaboratively, this Skill guides a multi-stage workflow exploring problem, users, behavior, data, priorities, and integration domains. It tracks completeness interactively and outputs a structured DISCOVERY.md document.

What is domain-based requirements discovery and when do I need it?

Domain-based requirements discovery is an early-stage spec generation process that explores problem space, users, functional behavior, and data to confirm assumptions. You need it when teams must capture decisions and determine domain coverage before writing testable acceptance criteria.

How do I generate a discovery document with acceptance criteria for a new feature?

To generate a discovery document, run the Skill with a feature description. It performs codebase research, ingests FRDs, and writes a structured DISCOVERY.md file to docs/{feature}/ containing requirements, acceptance criteria candidates, and open questions.

Can I use this requirements discovery workflow for early-stage spec generation without existing code?

Yes, this workflow applies to early-stage spec generation where teams must confirm assumptions and capture decisions. It requires plan-mode activation and performs codebase research to satisfy statusline stage updates during the discovery process.

What's the best way to track completeness across problem, user, and data domains during requirements gathering?

The best way to track completeness is using a gated coverage workflow that applies prompts tailored to each domain's goals. This ensures requirements discovery captures problem space, users, behavior, data, priorities, and security dimensions before generating spec documentation.