SuperAPI AI Directory

prd

General & other

View repository

Updated 10-16 02:31

About this skill

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.