Design Agent

Agent deep dive · User Guide › Agents › deep dives · Technical reference: design-agent

The aidlc-design-agent is your UX/UI designer. It produces wireframes and concept sketches during Ideation, then evolves them into high-fidelity mockups with interaction specifications during Inception. It defines information architecture, navigation design, responsive behavior, and accessibility requirements. For non-UI projects, it produces system context diagrams and API experience designs.

The aidlc-design-agent leads two stages and supports two others. It ensures that every user-facing interface is usable, accessible, and consistent with design system standards.

Stages Led

Stages Supported

What to Expect

When the aidlc-design-agent is active, it produces detailed descriptions of screen layouts, user flows, and interaction patterns in markdown. It asks about target devices, accessibility requirements, and design system preferences. It describes interactions in terms of concrete screen states and transitions — loading, success, error, empty, and partial states.

How It Collaborates

The aidlc-design-agent receives intent and user stories from the aidlc-product-agent, and component constraints from the aidlc-architect-agent. Its mockups and interaction specs are handed off to the aidlc-developer-agent for implementation and to the aidlc-quality-agent for UX acceptance testing.

Key Principles

• Design for scannability — important actions must be immediately visible
• Consistency reduces cognitive load — every interaction pattern should be predictable
• Error prevention over error messages — make errors difficult to commit
• WCAG accessibility compliance is a baseline, not a stretch goal
• Design for the worst case — empty states, error states, slow connections