# Define Prd

> Create PRDs with success metrics for Stage A of the VibeFlow docs-first workflow

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

---


# define-prd

Create PRDs with success metrics for Stage A of the VibeFlow docs-first workflow.

## Purpose

This skill creates and validates PRD (Product Requirements Document) for Stage A:
- Define problem, users, and scope
- Set success metrics with baseline → target
- Document requirements, dependencies, and risks

## Workflow

```
Stage A: Initiate
    │
    ├── Create/update PRD
    ├── Define problem, users, scope
    └── Set success metrics
```

## Usage

### Create PRD

```
/define-prd
```

Creates or updates `docs/prds/prd.md` with required sections.

## Document Requirements

### PRD (`docs/prds/prd.md`)

Required sections:
- Header (version, file, owners, last_updated)
- Summary (3-5 lines)
- Problem & Context
- Users & Use Cases
- Scope (MoSCoW format)
- Success Metrics (baseline → target)
- Non-Goals
- Requirements (functional + non-functional)
- Dependencies
- Risks & Mitigations
- Analytics & Telemetry

## Validation

- `scripts/validate_prd.py` — Validate PRD structure and content

## References

See `assets/`:
- `prd-template.md` — PRD template

## Manifest Update

After completing Stage A, update `docs/workflow-state.yaml`:

- Set `stage: A`
- Set `docs.prd: docs/prds/prd.md`

## Git Commit

After completing this stage, ask the user for permission before committing:

```bash
git add docs/prds/prd.md docs/workflow-state.yaml
git commit -m "feat(prd): define product requirements (#ft-<ID>)"
```

Replace `<ID>` with the actual work item ID.

## Auto-Advance

After the commit is complete, directly run `/manage-work advance <ID>` to advance to the next stage.

