Initial commit

skills/planning/ascii-diagram-creator/workflow/phase-3-refinement.md

@@ -0,0 +1,73 @@
+# 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?