PRD
Intents
We just discussed the billing system requirements — save that as a PRDUse this Notion doc to draft a PRD for the new onboarding flow: [link]Update the PRD — we're cutting the SSO requirement from v1Let's define what we're building for the payments featureUse our infrastructure knowledge to inform the PRD requirementsReferences
Read references/prd-conventions.md for placement rules and references/prd-template.md for section structure.
Scope
PRDs capture product/business "what and why." Technical architecture belongs in system-design; implementation detail in feature specs.
Input
Synthesize from whatever the user provides: conversation context, user research, local docs, external links (Notion, Google Docs), direct prompts, or docs/knowledge/ entries (when explicitly referenced).
Workflow: Create
- Normalize input into product context: problem, timing, success criteria, user needs, scope.
- Map into template sections from
references/prd-template.md. Align to local convention if one exists. - Place at the repository's existing PRD path, or fallback:
docs/PRD.md. - Mark unknowns in
Open Points— don't guess. - Set status to
draft.
Workflow: Iterate
- Read the existing PRD in full.
- Identify what changed and why.
- Update affected sections in place. Preserve unchanged content.
- Update
Last updateddate. - Transition status when appropriate:
draft→active→decomposed→shipped, or any →deprecated.
Output
- Create: complete PRD at
docs/PRD.mdwith known context populated - Iterate: targeted updates to affected sections only
- Unresolved decisions go in
Open Points - Problem names a specific user segment with concrete pain
- Success criteria are measurable with targets
- No technical architecture detail