write-prd

name	write-prd
description	Create a product requirements document in ChatPRD from codebase context. Use when speccing a new feature, writing up requirements, or drafting a PRD.

Write a PRD

Trigger

User wants to create a product requirements document for a feature, with context from the current codebase.

Workflow

1. Ask the user what feature or change they want to spec out.
2. Explore the codebase to understand relevant context:
   • Existing data models and schema
   • Related components, routes, and API endpoints
   • Current patterns and conventions
3. List the user's ChatPRD projects using list_projects and ask which project this PRD belongs to (or skip if none).
4. Pick the right template:
   • List available templates using list_templates.
   • Use the user's default template if they have one set.
   • Otherwise use the default PRD template.
   • If multiple templates could fit (e.g., a "Technical Spec" vs "Feature PRD"), ask the user which to use.
5. Draft an outline with sections tailored to the feature:
   • Problem statement and goals
   • User stories and acceptance criteria
   • Technical context (from codebase analysis)
   • Edge cases and error states
   • Open questions
6. Create the document in ChatPRD using create_document with the outline and selected template.
7. Save a local copy of the PRD as a markdown file in the prd/ directory at the project root (create the directory if it doesn't exist). Name the file using the document title in kebab-case (e.g., prd/user-authentication.md). This gives the team local access to specs for reference during development.
8. Share the ChatPRD document link and local file path with the user.

Guardrails

• Ground the PRD in actual codebase context, not generic boilerplate.
• Include specific file paths and existing patterns when describing technical context.
• Keep scope focused — one feature per PRD.
• Flag unknowns as open questions rather than making assumptions.
• The prd/ directory should be committed to the repo so the whole team has specs alongside the code.

Output

• PRD created in ChatPRD with document link
• Local copy saved to prd/ directory
• Summary of what was included