Agents design guidelines

Agents that show their work.

The guidelines behind the Agents prototype: the mark, color, type, voice, motion and every component, taken from the working product.

Product
Agent management
Surfaces
12 pages, 1 shell
Type
Inter, two weights
Palette
7 grays, 4 agent hues
01

Introduction

Agents is a workspace for teams who hand real work to AI agents. It shows what each agent did, what it cost and what needs a person. Three rules hold every screen together.

01

Gray carries the interface

Seven grays build every surface, so color always means something.

02

One hue for each agent

An agent keeps its color in the chart, the legend and every row.

03

Square and flat

No radius and no shadows on the page. Depth comes from layered surfaces.

02

Mark

A white tile with one dot: the workspace, and the agent inside it. It sits at the top of the rail and on every export.

Construction28 unit tile, 10 unit dot, 6 units of clear space

28106

ScaleNever smaller than 16px

64pxAgents
40pxAgents
28pxAgents
16pxAgents

VersionsOn the page, on ink and on an agent hue

Page#1A1A1A
Ink#ECECEC
Code review#3B82F6

App iconsFavicon to home screen

Favicon16
Favicon32
Tab48
Apple180
App192
App512
03

Color

Gray does the work and color carries meaning. Click any value to copy it.

Core palette

PageThe field everything sits on
CardEvery block and panel
InkText, primary buttons, the mark

Interface grays

Agent huesOne per agent, everywhere it appears

Support
Invoices
Code review
Research

ProportionsHow much of a screen each color takes

Page62%Card22%Selected and line8%Ink4%Agent hues3%Running1%

Readable combinationsWCAG contrast, measured

AaInk on Page
AaInk on Card
AaMuted on Page
AaFaint on Page
04

Typography

Inter in two weights, Regular and Medium. Figures are Medium with tight tracking, everything else is Regular.

Aa

Inter

ABCDEFGHIJKLM
NOPQRSTUVWXYZ

abcdefghijklm
nopqrstuvwxyz

0123456789 $ % · – ’

Regular 400Medium 500

Type scaleRead from the live components

Page title
Figure
Section
Body
Small
Axis
05

Layout

Five spacing steps and three layers. Cards sit 16px apart and line up with the stat columns.

4Card inset
8Between chips
12Header padding
16Between cards
20Stat padding
Page
Card
Panel with a 1px line
06

Iconography

A 20px grid, a 1.25px stroke, round caps. Real brand marks for connected tools. Click an icon to copy its SVG.

07

Voice

Short, plain and specific. The interface reports what happened the way a colleague would.

01

Say what happened

Labels describe the event in words a person would use, never an ID.

02

Numbers in plain words

One number, one meaning. A projection is called a projection.

03

Name the agent

People talk to Support and Research, never to a model or a job.

Say and avoid

SayAvoid
Running · 2:57Agent is currently executing a task
Nothing waitingNo pending approval requests were found
Research, about $18Estimated cost: approx. $18.00 USD
Hand to a personEscalate to human-in-the-loop
232 more than last week+22.05% WoW
08

Components

The real components, working. Every number is measured from the element.

ControlsHeights in px

Time range
Tabs
Filter
Status
Review
Link
Primary
Secondary
Stepper
Switch
Switch, off
Legend item

DataA value on every bar. Hover a day for the split

OverlaysDetails, search and menus above the page

09

States

Every list and card has four states. Press Try again to watch the error recover.

Default3 runs
EmptyNothing yet
LoadingSame height as the content
ErrorSays what failed, offers a way out

StressLong names truncate, big numbers fit

Long namesTitles end with an ellipsis, columns hold
Big numbersSeven digits, same card
10

Responsive

One layout that folds in three steps, from a wide desk to a phone.

1440Above 1100
1024901 to 1100
820641 to 900
375640 and below
Above 1100Rail, sidebar and page side by side. Charts sit next to their breakdown.
1100The sidebar folds away. Areas and pages become tabs under the top bar, search moves into it.
900Stats go two by two and charts take the full width. The run drawer fills up to 440px.
640The rail becomes a tab bar at the bottom, targets grow to 44px and run rows stack on two lines.
11

Accessibility

Usable with a keyboard, readable at a glance and calm for people who turn motion off.

01

Never color alone

Every agent dot sits next to its name or a number, so color is a second signal.

02

Motion can stop

With reduced motion on, entrances fade in place and bars change without moving.

03

Room for a thumb

Controls are 40px with a mouse and grow to 44px on touch screens.

FocusA 1px ring inside the element, for the keyboard only

ButtonFocused
Navigation rowFocused
FilterFocused

Keyboard

/Open search from anywhere
EnterOpen the highlighted result or row
EscClose search, menus and the run drawer
TabMove through controls in reading order
Right clickRename, recolor, pause or delete an agent
12

Motion

Fast, purposeful and never in the way. Three curves cover everything. Press play to feel each one.

Out200–420ms
Cards, menus, the entrance
Move280ms
Bars and stacks on screen
Drawer280ms
Panels from an edge
Press120msButtons scale to 0.97
Hover120msColor and background only
Bars280msSame data morphs in place
Drawer280msSlides from the right
Entrance420–620msFade with an 8px rise, staggered
13

Do and don't

The mistakes that make a product drift, side by side with the rule.

Support612Code review248

DoUse a hue only for its agent.

1,284 tasksView all runs

Don'tColor text to make it stand out.

PauseDelete

DoKeep red for deleting and for errors.

Credits679 left

Don'tMake a calm number look urgent.

DoUse the tile exactly as drawn.

Don'tRound it, tint it or add a shadow.

Spent$186.40

DoSquare surfaces, depth from layers.

Spent$186.40

Don'tUse rounded cards with drop shadows.

224Fri86Sat255Mon

DoStart bars at zero and label the value.

FriSatMon

Don'tCrop the axis to make a gap look bigger.

Spent$186.40of $250, resets Fri

DoWrite the number people check.

Budget utilization74.56%Δ +3.2pp WoW

Don'tMake people do the math.

14

Applications

Twelve views built from the same parts, and the product itself.

15

Assets

Everything on this page, ready to use.

Tokens as CSS

Every color, size and curve, ready to paste

Tokens as JSON

The same values for Figma or for code

Icon set

Every interface icon in one sprite

Mark

The tile on its own, in vector

16

Assistance

Questions, changes or a system like this for your own product. The people who designed it answer.

Ask about the system

A rule, a component or a decision behind it, in a short call.

Book a call
Request a change

A new component or page, designed inside these rules.

Email us
Get one for your product

Baobun Studio designs and builds systems like this one.

See the studio