richkuo/rk-skills/prd-questions

prd-questions

Resolve every open decision in the PRD by asking the user directly, then fold each answer into the section it governs and empty the Open Questions section.

Input

A repo containing PRD.md (or a named PRD file).

Steps

1. Sweep for questions

Collect, in order:

1. Every item in the Open Questions section.
2. Inline ambiguities elsewhere ("TBD", "confirm", "assumed", hedged examples).
3. Decisions embedded in Post-MVP / roadmap sections that were deferred without being decided.

"All questions" means all three groups.

2. Ask in batches

Use the AskUserQuestion tool, max 4 questions per call, sequential calls until done:

• Each question: 2–4 concrete options that name the actual competing designs and their tradeoffs. No bare yes/no options.
• Put your recommended option first, labeled (Recommended), and base the recommendation on reasons (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 <date>" 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 <date> 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