Validation Question Framework

Question Categories

Category	Keywords to detect
Architecture	"approach", "pattern", "design", "structure", "database", "API"
Assumptions	"assume", "expect", "should", "will", "must", "default"
Tradeoffs	"tradeoff", "vs", "alternative", "option", "choice", "either/or"
Risks	"risk", "might", "could fail", "dependency", "blocker", "concern"
Scope	"phase", "MVP", "future", "out of scope", "nice to have"

Question Format Rules

Each question must have 2-4 concrete options
Mark recommended option with "(Recommended)" suffix
"Other" option is automatic
Questions should surface implicit decisions

Example Questions

Category: Architecture Question: "How should the validation results be persisted?" Options:

Save to plan.md frontmatter (Recommended)
Create validation-answers.md
Don't persist

Category: Assumptions Question: "The plan assumes API rate limiting is not needed. Is this correct?" Options:

Yes, not needed for MVP
No, add basic rate limiting now (Recommended)
Defer to Phase 2

Validation Log Format

## Validation Log

### Session {N} — {YYYY-MM-DD}
**Trigger:** {what prompted this validation}
**Questions asked:** {count}

#### Questions & Answers

1. **[{Category}]** {full question text}
   - Options: {A} | {B} | {C}
   - **Answer:** {user's choice}
   - **Custom input:** {verbatim "Other" text if applicable}
   - **Rationale:** {why this decision matters}

#### Confirmed Decisions
- {decision}: {choice} — {brief why}

#### Action Items
- [ ] {specific change needed}

#### Impact on Phases
- Phase {N}: {what needs updating and why}

Recording Rules

Full question text: exact question, not summary
All options: every option presented
Verbatim custom input: record "Other" text exactly
Rationale: explain why decision affects implementation
Session numbering: increment from last session
Trigger: state what prompted validation

Section Mapping for Phase Propagation

Change Type	Target Section
Requirements	Requirements
Architecture	Architecture
Scope	Overview / Implementation Steps
Risk	Risk Assessment
Unknown	Key Insights (new subsection)

2.3 KiB Raw Permalink Blame History