2.2 KiB
2.2 KiB
Phase 3: Iterative Refinement
Purpose: Adjust the diagram based on user feedback to achieve optimal clarity and usefulness.
Common Refinement Requests
Layout Adjustments
| Request | Action |
|---|---|
| "Make it wider" | Expand boxes to max 80 chars |
| "More compact" | Reduce padding, combine elements |
| "Add spacing" | Insert blank lines between sections |
| "Align boxes" | Ensure vertical/horizontal alignment |
Content Changes
| Request | Action |
|---|---|
| "Add status indicators" | Include ✓, ✗, ⏳ symbols |
| "Show more detail" | Expand component descriptions |
| "Simplify" | Remove non-essential elements |
| "Add legend" | Include symbol definitions |
Structural Changes
| Request | Action |
|---|---|
| "Split into phases" | Convert to phased migration type |
| "Show both states" | Switch to before/after format |
| "Focus on data flow" | Emphasize arrows and movement |
| "Add dependencies" | Include connecting arrows |
Refinement Process
- Acknowledge request: Confirm understanding of the change
- Make targeted edit: Only modify what was requested
- Preserve context: Keep existing good elements
- Present updated diagram: Show the refined version
- Offer further refinement: "Would you like any other adjustments?"
Quality Checklist
Before finalizing, verify:
- Width: No line exceeds 80 characters
- Alignment: Boxes and arrows properly aligned
- Clarity: Labels are clear and descriptive
- Completeness: All requested elements included
- Legend: Symbols explained if used
- Purpose: Diagram serves stated goal
Final Delivery
Provide the diagram with:
- Usage suggestion: Where to include (PR, docs, wiki)
- Format note: Copy-paste ready for markdown/terminal
- Update reminder: When to refresh the diagram
Example Refinement Dialog
User: "Can you make the boxes wider and add status indicators?"
Response: Updated diagram with:
- Boxes expanded to full 80-character width
- Status indicators (✓, ⏳, ✗) added to each phase
- Legend included at bottom
[Updated diagram here]
Would you like any other adjustments?