Adaptive Architect: Refinement & Pivot Handling

[mathaix]

User Story

As a manager
I want to provide feedback on the draft blueprint and have it refined
So that the final design matches my exact requirements

Acceptance Criteria

Single Validation Question Pattern

• After presenting draft, Architect asks one validation question
• "Does this cover what you need, or should I adjust anything?"
• Do NOT present section-by-section for individual approval
• User can provide feedback in natural language

Feedback Processing

• Architect processes feedback and regenerates affected sections
• Changes explained: "I've updated X because you mentioned Y"
• Related sections updated when dependencies exist
• User can reject changes and request alternatives

"What Do You Suggest?" for Refinement

• When user is unsure what to change, offer suggestions
• Architect proposes improvements based on best practices
• User confirms or tweaks the suggestion

Mid-Conversation Pivot Handling

• If user significantly changes direction mid-session
• Architect asks: "Should I start fresh with the new context, or try to adapt what we've discussed so far?"
• If "start fresh": Reset session state, begin new discovery
• If "adapt": Preserve relevant context, adjust design
• Respect user's choice without judgment

Disagreement Handling

• If Architect disagrees with feedback, it explains why
• Offers alternative approaches with tradeoffs
• User can insist, Architect complies with caveat
• Disagreement and resolution logged in rationale

Convergence

• Clear indication when blueprint is ready for finalization
• Prompt: "This looks complete. Ready to validate and save?"
• User confirms to proceed to validation

Technical Notes

• Implement conversation memory for feedback context
• Incremental regeneration (affected sections only, not full blueprint)
• Store iteration history in session for undo capability

Definition of Done

• Single validation question pattern working
• Feedback processing and regeneration tested
• Pivot handling (start fresh vs. adapt) working
• Disagreement handling tested
• Code reviewed and merged

---

🤖 Generated with Claude Code