AI doesn't need your design system to be perfect. It needs it to be honest.
Why documenting your mess matters more than fixing it
❖ Writing about design, systems, and the organisations that build them.
Processing your application
Please check your inbox and click the link to confirm your subscription.
There was an error sending the email
Popular posts
Slots and the control paradox: Why loosening your design system might save it
How Figma's newest feature exposes an uncomfortable truth about the way we've been building systems
We're still terrible at the people parts
Why teams with perfect systems still build around them instead
The hidden cost of design system entropy
How AI tools surface every shortcut and inconsistency
Your next design system user is an agent
How to structure components for machine readability, semantic clarity, and long-term resilience
Your design system might be AI-ready. Your organisation probably isn't.
The technical preparation is well underway. The organisational questions it creates are a different problem entirely.
Building for coherence, not compliance
Lessons from Baldurs Gate 3 on contracts, governance, and judgment at the edges
We're getting better at the workaround
On Figma's code-to-canvas announcement, and why smoother translation might be making the structural problem harder to fix
What I stole from API documentation
Patterns from Stripe, GitHub, and Twilio that fixed my component architecture
AI doesn't need your design system to be perfect. It needs it to be honest.
Why documenting your mess matters more than fixing it
Your job is on a spreadsheet somewhere
Defending design system work when budgets contract
Recommended
Building for coherence, not compliance
Lessons from Baldurs Gate 3 on contracts, governance, and judgment at the edges
What I stole from API documentation
Patterns from Stripe, GitHub, and Twilio that fixed my component architecture
AI doesn't need your design system to be perfect. It needs it to be honest.
Why documenting your mess matters more than fixing it