74 lines
2.2 KiB
Markdown
74 lines
2.2 KiB
Markdown
# 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?
|