diff --git a/plugins/compounding-engineering/.claude-plugin/plugin.json b/plugins/compounding-engineering/.claude-plugin/plugin.json
index b3776e8..4bb9b17 100644
--- a/plugins/compounding-engineering/.claude-plugin/plugin.json
+++ b/plugins/compounding-engineering/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "compounding-engineering",
- "version": "2.0.1",
+ "version": "2.0.2",
"description": "AI-powered development tools. 24 agents (organized by category: review, research, design, workflow, docs), 15 commands, 11 skills for code review, research, design, and workflow automation.",
"author": {
"name": "Kieran Klaassen",
diff --git a/plugins/compounding-engineering/CHANGELOG.md b/plugins/compounding-engineering/CHANGELOG.md
index 2204b75..19509e8 100644
--- a/plugins/compounding-engineering/CHANGELOG.md
+++ b/plugins/compounding-engineering/CHANGELOG.md
@@ -5,6 +5,12 @@ All notable changes to the compounding-engineering plugin will be documented in
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [2.0.2] - 2024-11-24
+
+### Changed
+
+- `design-iterator` agent - Updated description to emphasize proactive usage when design work isn't coming together on first attempt. Added examples showing how to suggest 5x or 10x iterations when initial changes don't fully resolve design issues.
+
## [2.0.1] - 2024-11-24
### Added
diff --git a/plugins/compounding-engineering/agents/design/design-iterator.md b/plugins/compounding-engineering/agents/design/design-iterator.md
index deeaee0..d76dc05 100644
--- a/plugins/compounding-engineering/agents/design/design-iterator.md
+++ b/plugins/compounding-engineering/agents/design/design-iterator.md
@@ -1,6 +1,6 @@
---
name: design-iterator
-description: Use this agent when you need to iteratively refine and improve UI components through systematic design iterations. This agent takes screenshots, identifies improvements, implements changes, and repeats the process N times to progressively enhance any visual element. Perfect for landing pages, feature sections, hero components, or any UI that needs polish. Context: User has a features section that feels boring and wants iterative improvements. user: "The features section looks a bit boring, can you iterate on it 10 times to make it better?" assistant: "I'll use the design-iterator agent to systematically refine your features section through 10 iterations of visual improvements" Since the user wants iterative UI refinement with multiple rounds of improvements, use the design-iterator agent to systematically enhance the component. Context: User wants to polish a hero section with multiple design passes. user: "Can you do 5 design iterations on the hero component?" assistant: "Let me use the design-iterator agent to progressively improve the hero through 5 rounds of refinement" The user explicitly wants multiple design iterations, which is the core function of the design-iterator agent. Context: User wants research-driven improvements to a landing page section. user: "Look at how Stripe and Linear do their pricing pages and iterate on mine 8 times" assistant: "I'll launch the design-iterator agent to research competitor designs and apply those insights across 8 iterations" The user wants competitor research combined with iterative refinement, a key capability of the design-iterator agent.
+description: Use this agent PROACTIVELY when design work isn't coming together on the first attempt. If you've made 1-2 design changes and the result still feels off, suggest using this agent with 5x or 10x iterations for deeper refinement. This agent takes screenshots, analyzes what's not working, implements improvements, and repeats N times to systematically fix design issues. Perfect when colors feel wrong, layouts aren't balanced, or the overall aesthetic needs work that single changes can't achieve. Context: User asks to change button color but result still looks off. user: "Change the button to blue" assistant: [makes change, takes screenshot] "The button is now blue, but I notice the overall color balance still feels off. Would you like me to use the design-iterator agent with 5 iterations to systematically improve the color harmony and visual balance?" PROACTIVE USE: After a simple change doesn't fully resolve the design issue, suggest the design-iterator to do deeper work. Context: User's design request leads to something that doesn't look right. user: "Make the hero section more modern" assistant: [makes initial changes] "I've added some modern elements, but the result isn't quite coming together. This looks like it needs iterative refinement. Let me use the design-iterator agent with 10 iterations to systematically improve typography, spacing, colors, and visual hierarchy until it feels polished." PROACTIVE USE: When initial design work produces mediocre results, automatically suggest or use the design-iterator for comprehensive improvement. Context: User wants explicit iterative refinement. user: "The features section looks boring, iterate on it 10 times" assistant: "I'll use the design-iterator agent to systematically refine your features section through 10 iterations of visual improvements" User explicitly requests iteration, use design-iterator directly. Context: Design task requires research and multiple passes. user: "Look at how Stripe does their pricing page and make mine better" assistant: "I'll launch the design-iterator agent with 8 iterations to research Stripe's design patterns and progressively apply those insights to your pricing page" Competitor research combined with iterative refinement benefits from the systematic approach.
color: violet
---