| name | to-prd |
| description | Synthesize current context into a PRD and file it as a Beads feature/epic issue. |
to-prd
Turn the current conversation and codebase context into a practical PRD without running a long interview.
When to use
- User asks for a PRD, feature brief, or implementation spec.
- You need a structured artifact before creating implementation tasks.
Process
1) Gather context from existing signals
Use what already exists in:
- Current conversation
- Existing issues (
bd show <id>)
- Recent code context in this repo/sub-repo
- Existing knowledge files in
knowledge/
Ask clarifying questions only when a blocker prevents writing a useful PRD.
2) Define deep modules and test surface
Identify major modules likely to be added/changed. Prefer deep modules (simple interface, hidden complexity).
Record:
- Candidate module responsibilities
- Public interfaces (high-level, no file path lock-in)
- Behavior areas that most need tests
3) Write the PRD
Use this template:
## Problem Statement
Describe the user-facing problem in plain language.
Solution
Describe the intended user-facing outcome and core approach.
User Stories
Provide a numbered, comprehensive set of stories:
- As a , I want , so that .
Implementation Decisions
Capture important decisions:
- Modules to build/modify
- Interface and contract decisions
- Architecture and data-shape decisions
- Operational constraints and rollout notes
Do not hard-code exact file paths unless required.
Testing Decisions
Capture testing strategy:
- Behavioral boundaries to test
- Which modules/surfaces require tests
- Relevant prior-art test patterns in repo
Out of Scope
Explicitly list exclusions for this increment.
Further Notes
Any assumptions, risks, migration notes, or open questions.
4) File it in Beads
Create an issue in this harness (or target sub-repo when appropriate):
bd create --type feature --title "<PRD title>" --description "<full PRD markdown>" --priority 2 --repo .
If scope is multi-feature or strategic, use --type epic instead.
5) Link follow-up work
If implementation tasks are obvious, create child beads under the PRD issue:
bd create --type task --parent <prd-id> --title "<slice>" --description "<vertical slice>" --priority 2 --repo .
Add a worklog: comment summarizing key decisions.