# Discovery

> Create a discovery document to gather and clarify requirements

- Skill: `dvcrn/discovery` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/discovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/discovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/discovery

---


# Discovery

Create a discovery document for gathering and clarifying requirements before creating an implementation plan.

## What It Does

1. Gathers functional and non-functional requirements
2. Documents constraints and dependencies
3. Identifies open questions that need answers
4. Proposes a high-level approach
5. Documents risks and unknowns

## Usage

```
/discovery <topic>
```

**Arguments:**
- `topic` (required): The feature or topic to discover requirements for

## Output

Creates: `flow/discovery/discovery_<topic>_v<version>.md`

## Document Structure

```markdown
# Discovery: [Topic]

## Context
Why this discovery is needed

## Requirements Gathered
### Functional Requirements
- [FR-1]: Description

### Non-Functional Requirements
- [NFR-1]: Description

### Constraints
- [C-1]: Description

## Open Questions
| # | Question | Status | Answer |
|---|----------|--------|--------|
| 1 | Question | Open   | -      |

## Technical Considerations
Architecture, dependencies, patterns

## Proposed Approach
High-level recommendation

## Risks and Unknowns
Identified risks with mitigation strategies

## Next Steps
Follow-up actions
```

## Example

```
/discovery user authentication with OAuth
```

**Creates:** `flow/discovery/discovery_user_authentication_with_oauth_v1.md`

## Critical Rules

- **No Code**: Discovery is for gathering requirements only. No implementation.
- **Ask Questions**: Use interactive questions to clarify unclear requirements.
- **Mark Assumptions**: Always explicitly mark assumptions for validation.

## Next Command

After discovery, run `/create-plan @flow/discovery/discovery_<topic>_v1.md` to create an implementation plan.