richkuo prd-questions
Resolve every open decision in the PRD by asking the user directly, then fold the answers into the spec so no reader ever needs the Q&A transcript. The deliverable is a PRD whose Open Questions section is empty because the answers live in the sections they govern.
Input
A repo containing PRD.md (or a named PRD file). No other input needed.
Steps
1. Sweep for questions
Collect, in order:
- Every item in the Open Questions section.
- Inline ambiguities elsewhere ("TBD", "confirm", "assumed", hedged examples).
- Decisions embedded in Post-MVP / roadmap sections that were deferred without being decided.
"All questions" means all three groups — not just the numbered list.
2. Ask in batches
Use the AskUserQuestion tool, max 4 questions per call, sequential calls until done:
- Each question: 2–4 concrete options with real tradeoff descriptions — not "yes/no" but the actual competing designs.
- Put your recommended option first, labeled
(Recommended), and make the recommendation genuinely reasoned (privacy-preserving, simplest-correct, matches the PRD's stated priorities). - One question per decision. Never bundle two decisions into one option.
- Post-MVP questions are fair game but mark them as such in the question text, and offer "Defer to scoping" as a legitimate recommended option when deciding now has no benefit.
3. Fold answers into the spec
For every answer:
- Edit the owning section — pricing answers into the pricing tables/rules, privacy answers into the privacy section, failure-handling into billing/lifecycle. The spec text states the decision plainly; no "per user decision on " hedging inside the rule itself.
- Update worked examples to match (and remove "unverified" hedges once confirmed).
- Cross-reference where a rule spans sections (§-refs).
4. Close out
- Replace the Open Questions list with a one-paragraph note: "None — all prior open questions resolved and folded into the spec:" followed by a decision → section map.
- Commit and push (same PRD PR if still open; footer verb
Updated).
Output
One reply listing each decision in a compact sentence series, plus where it landed. Note the PRD PR is ready to merge if this was the last blocker.
Failure modes
| Situation | Do this |
|---|---|
| User picks "Other" with free text | Treat as the answer; fold it in verbatim, ask one follow-up only if it's internally contradictory |
| An answer contradicts existing spec text elsewhere | Update every affected section; call out the ripple in your reply |
| More than ~12 questions found | Still ask them all — batch by theme (pricing, privacy, lifecycle) so each AskUserQuestion call is coherent |
| A "question" is really a research task, not a user decision | Don't ask it; note it as a scoping task in the roadmap section |