mcpField
P
prd

prd

github.com/yansfilDevelopment043 installsUpdated 19w ago
Repository

About prd

prd is a skill for producing implementation-ready PRDs without implementing code. It grounds requirements and acceptance criteria in project exploration, then prepares a checklist and context notes for handoff to implementation.

Key features

  1. 01Explore project guidance and code
  2. 02Define scope and non-goals
  3. 03Write testable requirements
  4. 04Specify verifiable acceptance criteria
  5. 05Create task checklist and context notes

Use cases

  1. 01Turning a feature request into a PRD
  2. 02Preparing an implementation handoff
  3. 03Clarifying requirements before coding

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yansfil/vibe-engineering --skill prd

After installing, type/prdin Claude Code to confirm it loaded.

Details

From the project README

prd

Use this skill to write a PRD that an implementation agent can execute.

The PRD is a handoff document. Do not implement code while using this skill.

Output Location

Save PRD artifacts under .dev/<topic-slug>/ unless the project has a stronger local convention or the user asks for a different location.

Default files:

  • .dev/<topic-slug>/prd.md - the contract: problem, scope, requirements, acceptance criteria, tasks, and verification.
  • .dev/<topic-slug>/checklist.md - a checkable task list derived from the PRD's tasks, for implement to adopt as its live checklist (see Checklist Shape).
  • .dev/<topic-slug>/context-notes.md - grounding notes from the codebase exploration (key files, conventions, constraints) so implement does not re-discover them.

If the topic slug is unclear, choose a short kebab-case slug from the feature name and state it before writing files.

Inputs

Prefer one of these inputs:

  • A clarify handoff summary.
  • A user-provided feature request with enough detail.
  • Existing project docs such as CLAUDE.md, AGENTS.md, README.md, specs, or adjacent PRDs.

If major ambiguity remains, ask one blocking question or recommend running /clarify first.

Workflow

  1. Explore the codebase as needed before writing - read relevant project guidance, code, and config so the PRD is grounded in how the project actually works.
  2. Define the problem, goal, users, and current scope.
  3. Separate scope from non-goals.
  4. Note expected technical structure changes at a high level.
  5. Write numbered, testable requirements.
  6. Write acceptance criteria that can be checked by a person, command, browser, API response, database row, or log.
  7. Derive tasks from the requirements. Do not invent hidden scope in tasks.
  8. Define agent verification and human verification separately.
  9. End with an implementation result report contract.
  10. Write checklist.md from the tasks (see Checklist Shape) and context-notes.md from what the codebase exploration surfaced, so the handoff to implement is complete.

Required PRD Shape

# PRD: <feature>

## Summary

## Problem And Goal

## Users And Use Cases

## Pre-Work

## Non-Goals

## Requirements

## Acceptance Criteria

## Verification - Agent

## Verification - Human

## Technical Structure And Changes

## Tasks

## Risks And Open Decisions

## Implementation Result Report Contract

Checklist Shape

checklist.md is the actionable form of the PRD's tasks - the list implement checks off as it builds. Keep it in sync with the Tasks and Acceptance Criteria sections; do not add scope here that the PRD does not state.

Each task carries traceability tags so implement can seed a structured task list from it:

  • (req: R1) - the requirement(s) the task implements.
  • (ac: AC1) - the acceptance criterion(s) the task is responsible for. Omit if the task is pure setup with no AC of its own.
  • (after: T1) - the task(s) that must complete first, when order matters. Reference tasks by their T<n> id. Omit for tasks with no prerequisite.

Number the tasks T1, T2, ... so after: can reference them.

# Checklist: <feature>

## Tasks

- [ ] T1 <task 1> (req: R1) (ac: AC1)
- [ ] T2 <task 2> (req: R2) (ac: AC2) (after: T1)

## Acceptance Criteria

- [ ] AC1 <criterion 1>
- [ ] AC2 <criterion 2>

## Human Checks

- [ ] <thing a person must confirm>

Rules

  • Write the PRD in Korean. Keep the section headings from Required PRD Shape as-is, but write all prose, requirements, acceptance criteria, and tasks in Korean.
  • Requirements must describe observable behavior.
  • Acceptance criteria must have a verification path.
  • Tasks must trace back to requirements or verification.
  • If there is no expected structural change, say so explicitly.
  • Keep the PRD implementation-ready, not marketing-oriented.
  • Do not expand the MVP because a related idea seems useful.

Comments

Markdown supported