Draft UX documentation for teams building on Duo Agent Platform
We are documenting design guidelines in Pajamas. Note that most of this will not be a new component in Pajamas, but rather a description of the pattern - how and where to use it, along with examples for others to use.
Likely location for this is at https://design.gitlab.com/patterns/ under GitLab Duo.
Design solutions and example flows
[Instructions: Add links to Figma files or other documention. Make sure your Figma files follow conventions to indicate their status and link back to issues]
- Vision - the designs and prototypes from July 2025
- Implementation Content
- Panel Architecture @aregnery
- Layout example and key terms (What is a panel, what goes in it, what do we call X panel?)
- Working Figma file for latest designs
- Update layout content for UI updates (gitlab-org/gitlab-services/design.gitlab.com!5010 - merged) • Jeremy Elder • 18.4
- Figma > Project Studio page template (gitlab-org/gitlab-services/design.gitlab.com#2969 - closed) • Dan MH • 18.4
- End to end user flows: Where to see mocks of example user flows
- Create/edit agents @tvanderhelm
- Fix a pipeline
- Issue to MR @Sam_Reiss
- AI Panel @emilybauman / @Sam_Reiss / @jmiocene
- AI Catalog @abacon-gitlab
- how to name agents/flows so they are easy to discover and find
- avatars or other identifiers for agents/flows
- Catalog home page
- CRUD agents
- Testing agents and flows
- Permissions, governance, auditing
- Agent Interaction Methods @emilybauman / @michaelmoyers
- Invoke via Chat
- Invoke via Comments
- Invoke via Assignee
- Invoke via Slash Command
- General Patterns
- building a good conversational flow
- when should you update comments
- how verbose to be
- output in comments and in chat. what's possible.
- user flows @Sam_Reiss
-
View, approve, deny actions
- when to require an approval, when not to
- bulk approval
- notifying users
- to do
- toast
- in comments/chat/sessions screens
-
View, approve, deny actions
- Managing errors @michaelmoyers
- Formating output @michaelmoyers
- building a good conversational flow
- Panel Architecture @aregnery
- Background: Customer research on AI features they want us to build
Edited by Jacki Bauer