# 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

1. **Acknowledge request**: Confirm understanding of the change
2. **Make targeted edit**: Only modify what was requested
3. **Preserve context**: Keep existing good elements
4. **Present updated diagram**: Show the refined version
5. **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?