flow-discover

Discover and approve feature requirements through focused interviewing and repository research. Use when the user has a feature idea, unclear scope, conflicting requirements, or needs Flow context art

SKILL.md

GitHub

Discover a feature

Read discovery, artifacts, memory, and safety before starting.

Procedure

  1. Confirm PWDEV Flow state exists or explain that $flow-init is the prerequisite for persisted artifacts.
  2. Inspect applicable AGENTS.md, repository structure, existing behavior, tests, product context, and active relevant memories without reading secrets.
  3. Classify the request as quick, standard, or product-level. Route bounded changes to $flow-quick; route product problems to $flow-product when a PRD is needed.
  4. Interview one focused decision at a time using the minimum questions required by discovery.
  5. Separate confirmed facts, user decisions, repository observations, assumptions, and open questions.
  6. Research stack and domain pitfalls from repository evidence first. Use current primary sources when external facts may have changed.
  7. Write the context artifacts and set state to DISCOVERING while questions remain.
  8. Present problem, actors, scope, rules, acceptance criteria, risks, and open questions for approval.
  9. On approval, mark the discovery gate APPROVED and recommend $flow-design. Otherwise revise requirements or set BLOCKED with the missing decision.

Collaboration

Work inline by default. Use a read-only research worker only when the user explicitly requests parallel agent work, following collaboration. Keep the interview and approval gate in the primary conversation.

Output

Return STATUS, feature slug, requirements path, supporting context paths, gate result, and NEXT. Do not make architecture decisions during discovery.