write-a-prd

Generate a PRD document through user interviews and repository audits.

160|16|Updated Dec 4, 2024
One-click install
npx skills add https://github.com/MaggieAppleton/maggieappleton.com-V3 --skill write-a-prd-maggieappleton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/MaggieAppleton/maggieappleton.com-V3/tree/main/.claude/skills/planning-and-product/write-a-prd
Command: npx skills add https://github.com/MaggieAppleton/maggieappleton.com-V3 --skill write-a-prd-maggieappleton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you create a PRD by interviewing the user, auditing the codebase, and outlining modules to implement, then submitting it as a GitHub issue.

Core Features & Use Cases

  • Structured user interviews to clarify problems and goals, ensuring alignment before drafting requirements.
  • Repository exploration to verify assumptions against existing code and design context.
  • Modular PRD design that identifies major components, success criteria, risks, and acceptance criteria, ready for handoff.
  • PRD submission as a GitHub issue, including a clear problem statement, solution approach, user stories, decisions, and tests.

Quick Start

Describe the initial problem and desired outcome, then let the skill guide you through interviews, repo review, and module design to generate a PRD and issue template.

Frequently Asked Questions about write-a-prd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a PRD and what sections should a product requirements document include?

A PRD defines product scope by clarifying problems and mapping modular design. A complete PRD includes Problem Statement, Solution, User Stories, Implementation Decisions, Testing Decisions, Out of Scope, Further Notes, and a GitHub issue template for development handoff.

How do I write a PRD for a new software feature?

To write a PRD for a new feature, describe the initial problem and desired outcome. The skill guides you through structured user interviews, audits your existing codebase to verify assumptions, maps modular components, and generates a complete requirements document ready for submission.

Can I generate a GitHub issue template directly from product requirements?

Yes, you can generate a GitHub issue template directly from product requirements. The skill outputs a structured PRD that includes a clear problem statement, solution approach, user stories, decisions, and tests formatted for immediate submission as a GitHub issue.

How do I align product requirements with existing codebase architecture?

To align product requirements with your codebase, the skill audits your repository during the planning phase. It explores existing code and design context to verify assumptions, ensuring the generated PRD and modular design accurately reflect your current architecture.

What is the best way to document user stories and acceptance criteria for development handoff?

The best way to document user stories and acceptance criteria is through a structured PRD. By conducting user interviews to clarify goals and mapping modular design, the skill outlines major components, success criteria, risks, and acceptance criteria ready for developer handoff.

Do I need to conduct user interviews before drafting product requirements?

Yes, conducting user interviews before drafting product requirements ensures alignment. The skill uses structured interviews to clarify problems and goals, verifying assumptions against existing code before generating the final PRD document and GitHub issue template.