artifacts
AI-ready content design system
#InsurTech #content design system #AI #content patterns
Situation
At QIC, we already had detailed UX writing guidelines. They worked well for individual insurance products.
But QIC was growing from an insurance app into an ecosystem. We needed a way to keep microcopy consistent across more products and flows.
The idea was to turn our guidelines into a structured knowledge base that could power an AI assistant or Figma plugin.
But QIC was growing from an insurance app into an ecosystem. We needed a way to keep microcopy consistent across more products and flows.
The idea was to turn our guidelines into a structured knowledge base that could power an AI assistant or Figma plugin.
Task
My goal was to prepare our UX writing guidelines for AI.
The assistant would help UX writers create and review microcopy. It needed to follow our content standards and align with the existing design system.
The assistant would help UX writers create and review microcopy. It needed to follow our content standards and align with the existing design system.
Action
1. Built a three-level content structure
I organized the guidelines around three levels:
2. Identified reusable content patterns
We already had strong examples of microcopy across the app. But the rules weren't always documented or applied consistently.
I reviewed existing UI copy, identified recurring patterns, and turned them into reusable guidelines.
I also aligned the content structure with our more mature design system.
3. Standardized guidelines for each element
For each UI element, I documented:
I organized the guidelines around three levels:
- UI elements: buttons, toggles, input fields
- Screens: empty states, error screens
- Flows: authentication, onboarding
2. Identified reusable content patterns
We already had strong examples of microcopy across the app. But the rules weren't always documented or applied consistently.
I reviewed existing UI copy, identified recurring patterns, and turned them into reusable guidelines.
I also aligned the content structure with our more mature design system.
3. Standardized guidelines for each element
For each UI element, I documented:
- When to use it
- How to write its copy
- Recommended content patterns
- Parts of speech and word limits
- Good and bad examples
4. Prepared the guidelines for AI
I restructured the content into an AI-ready format.
Each UI element had its own document with specific writing rules and examples.
This would allow UX writers to ask the assistant to write or review a specific element, rather than search through a large style guide.
I restructured the content into an AI-ready format.
Each UI element had its own document with specific writing rules and examples.
This would allow UX writers to ask the assistant to write or review a specific element, rather than search through a large style guide.
Result
The project was not completed due to layoffs.
However, I established a structured approach to making our UX writing guidelines reusable and AI-ready. The work received positive feedback from colleagues.
The next step would have been to connect the guidelines to an AI assistant or Figma plugin and test them on real writing tasks.
However, I established a structured approach to making our UX writing guidelines reusable and AI-ready. The work received positive feedback from colleagues.
The next step would have been to connect the guidelines to an AI assistant or Figma plugin and test them on real writing tasks.
