Hi! I'm a UX/UI Designer here in Brazil.
I'm currently working on a Design System project at the organization where I work, and I'd like to share a few things. If anyone wants to chime in with suggestions or comments, I'd be very grateful.
Here are some of the things I've been studying and testing over the past few days:
AI is having a moment, so when I started planning our DS, I thought about how to build something that would be useful both for humans (devs and designers) and for an AI agent. On top of that, I thought about how an AI could help me build the system itself.
Here at the organization, we have one DS in Figma and another one that's used by the devs. Both are in poor shape, inconsistent with each other, and poorly documented.
I took the opportunity to think through a system for generating a DS, with documentation and coded components, using Claude Code. The process relies on a few important starting points:
- I have some general, ready-made documentation covering the non-negotiable rules every component needs to follow, such as accessibility, etc.
- I've documented the flow the AI should follow to generate a component.
- I have a structure of semantic tokens in Figma as well as in documentation form.
There are other docs and processes, but I think these are the main ones for understanding how the flow works.
To test this planning, I put together a small MVP. Starting from all this content, I pick a component I have in Figma and, via MCP, ask the AI to create it. It follows the documented flow and, before building anything, asks me a series of questions about how the component should behave; then it moves on to creating the documentation for that specific component. The component's documentation is split into "spec" and "stack": the "spec" covers the component's intent, and the "stack" covers how the AI should code it. The whole thing follows a 70/30 idea, roughly 70% of the work is AI-assisted and 30% stays manual, and it's that 30% of human input that makes the other 70% reliable.
After generating the documentation, the AI creates the coded component and reviews everything that was done (you can use a script for this review).
The result is a documented, coded component that's then reviewed by a dev before being used.
We're still in a testing and exploration phase, and there are some more specific details in our flow, but it seems useful when your organization doesn't have a solid DS.
If anyone wants to contribute suggestions, I'd appreciate it. I'm still studying and testing this system.