agent-uml Diagram Quality Best Practices

Make the human-Claude design conversation converge faster on the agent-uml canvas.

When to Apply

• Before every diagram_upsert call — check syntax safety rules and apply the correct skinparam preset
• After every design_feedback response — consult the versioning decision table to choose the right next action
• When starting a new design session — follow the progressive detail layers for diagram ordering
• Before calling design_export — run the export-readiness checklist
• When a diagram renders blank or elements aren't clickable — consult rendering safety rules

Rule Categories by Priority