prd-questions

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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

| 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 each AskUserQuestion call by theme (pricing, privacy, lifecycle) |
| 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 |

From richkuo/rk-skills, MIT.

More from richkuo/rk-skills