Skip to content
Humans + AI

Brand reference

Humans + AI, as the application draws it

Generated from @hai/brand at build time, so it cannot drift. Token file 0.10.8 (2026-11-15), snapshot of design-system/tokens/hai-tokens.json at HAI-orgs-OS commit 00d3c627d. The identity belongs to the people who rule on the design system.

5 questions are open for Ross and Dan. Contrast: 62 pairs measured, 0 below their required ratio.

Colour

Spectrum, 8-step, with shade, tint and solid plate

pink

#ED1860

shade 70

#AB1649

tint 20

#FBD1DF

plate (white type 3:1)

#ED1860

magenta

#C3386C

shade 70

#8E2D52

tint 20

#F3D7E2

plate (white type 3:1)

#C3386C

purple

#68318A

shade 70

#4E2867

tint 20

#E1D6E8

plate (white type 3:1)

#68318A

indigo

#4A50A2

shade 70

#393D77

tint 20

#DBDCEC

plate (white type 3:1)

#4A50A2

blue

#2590CF

shade 70

#1F6A97

tint 20

#D3E9F5

plate (white type 3:1)

#2590CF

teal

#08B5A5

shade 70

#0B847A

tint 20

#CEF0ED

plate (white type 3:1)

#09A698

green

#4DB358

shade 70

#3B8344

tint 20

#DBF0DE

plate (white type 3:1)

#48A653

orange

#F47521

shade 70

#B0571D

tint 20

#FDE3D3

plate (white type 3:1)

#EB7120

Spectrum, 12-step

pink

#ED1860

cerise

#D22C68

mulberry

#AA3674

plum

#703287

violet

#584297

cobalt

#435CAA

azure

#2C84C7

turquoise

#18A1BC

jade

#0EB59E

emerald

#3AB46D

olive

#8A9C44

orange

#F47521

Fields, ink and lines

field-dark

#121214

field-dark-panel

#464648

field-white

#FFFFFF

field-light

#FCFCFD

field-light-warm

#F6F5F2

field-light-panel

#F7F7F7

ink-on-dark

#FFFFFF

ink-on-light

#17171A

ink-panel-text

#333333

line-hairline-on-light

#B5B5B6

chart-comparison

#8B8B8C

actor-human

#3B8344

actor-ai

#4A50A2

Roles the components use

Each role names the token it takes its value from. Where the choice of token is the application's, it says so.

Roles by aesthetic
RoleLightDarkTaken from (light / dark)
surface #FFFFFF#121214color.field.white / color.field.dark
panel #F7F7F7#464648color.field.light_panel / color.field.dark_panel
ink #17171A#FFFFFFcolor.ink.on_light / color.ink.on_dark
ink-secondary #333333#FFFFFFcolor.ink.panel_text / color.ink.on_dark (rules.dark_type)
line #B5B5B6#6F6F70color.line.hairline_on_light / color.field.dark_panel mixed 22% toward white (line note)
control-line #8B8B8C#8B8B8Ccolor.chart.comparison / color.chart.comparison (application choice)
action #4A50A2#4A50A2color.primary / color.primary (application choice)
action-ink #FFFFFF#FFFFFFcolor.ink.on_dark / color.ink.on_dark
action-hover #393D77#393D77color.spectrum8_shade70 (rules.hover_state) / color.spectrum8_shade70 (rules.hover_state)
link #4A50A2#FFFFFFcolor.primary / color.ink.on_dark (application choice)
link-hover #393D77#FFFFFFcolor.spectrum8_shade70 (rules.hover_state) / color.ink.on_dark (application choice)
focus #4A50A2#FFFFFFcolor.primary / color.ink.on_dark (application choice)
selected #4A50A2#FFFFFFcolor.primary / color.ink.on_dark (application choice)
selected-ink #FFFFFF#121214color.ink.on_dark / color.field.dark (application choice)
status-ink #333333#FFFFFFcolor.ink.panel_text (rules.worksheet_cell_tint.ink) / color.ink.on_dark
error-fill #FBD1DF#AB1649color.spectrum8_tint20_on_light pink (worksheet role problem) / color.spectrum8_shade70 pink (worksheet role problem) (application choice)
error #BB174F#F797B7spectrum pink, least changed to clear 4.5:1 (worksheet role problem) / spectrum pink, least changed to clear 4.5:1 (worksheet role problem) (application choice)
caution-fill #FDE3D3#B0571Dcolor.spectrum8_tint20_on_light orange (worksheet role caution) / color.spectrum8_shade70 orange (worksheet role caution) (application choice)
caution #A3511C#FABD94spectrum orange, least changed to clear 4.5:1 (worksheet role caution) / spectrum orange, least changed to clear 4.5:1 (worksheet role caution) (application choice)
success-fill #DBF0DE#3B8344color.spectrum8_tint20_on_light green (worksheet role aligned) / color.spectrum8_shade70 green (worksheet role aligned) (application choice)
success #37773F#ADDCB2spectrum green, least changed to clear 4.5:1 (worksheet role aligned) / spectrum green, least changed to clear 4.5:1 (worksheet role aligned) (application choice)
actor-human #3B8344#3B8344color.spectrum8_shade70 / color.spectrum8_shade70
actor-ai #4A50A2#4A50A2color.primary / color.primary
actor-human-bar #3B8344#68A06Frules.edge_bar_color on rules.actor_color.human / rules.edge_bar_color on rules.actor_color.human
actor-ai-bar #4A50A2#8B8FC3rules.edge_bar_color on rules.actor_color.ai / rules.edge_bar_color on rules.actor_color.ai

Type

Open Sans, weights 300, 400, 600, 700, 800 from the token file. The scale is measured on the live site; phone sizes shown, larger from 48rem.

Heading 1: decisions with AI

Heading 2: twelve decision levels

Heading 3: rights and safeguards

Body text. A reference library on designing decisions that involve AI.

Small print: helper text, captions and fine detail.

Type scale
RoleValueBasis
text-small0.9375remlive site
text-body1.0625remlive site
text-table0.9375remapplication
text-h31.3remlive site
text-h21.8remlive site
text-h12.2remlive site
text-h2-wide2.6remlive site
text-h1-wide3.5remlive site
text-h3-wide1.55remlive site
text-eyebrow0.84remlive site
text-lead1.15remapplication
text-lead-wide1.4remlive site
text-button1.0625remlive site

Icons

One filled glyph per noun, so a screen can lead with the picture and keep words short. The first set is the design system's space icons (space-icons-lab, one per space, never per level), copied with the token snapshot. The second covers platform nouns and actions in the same glyph language, drawn for the application. An icon beside text is decorative; alone it carries a label.

From the design system: the spaces

  • Start Herestart
  • Decision Characteristicsbars
  • Decision Rolesactors
  • The 12 Decision Levelssteps
  • Supporting Capabilitiesblocks
  • Augmentation Techniquesspark
  • Strategic Framingflag
  • Organizational Implementationarrow
  • Decision auditcheck
  • Compliance guidelinesshield
  • Case libraryfolder
  • Referencesbook

Application: nouns and actions

  • a personmember
  • an organizationorganization
  • the AI guideguide
  • voicevoice
  • searchsearch
  • a content carddocument
  • a tabletable
  • emailemail
  • send a messagesend
  • stop a replystop
  • attachattach
  • open a listchevron
  • homehome

Components and states

Light aesthetic

The page. The header shows the name in text until the logo files arrive; under 48rem the navigation is its own row. The footer shows on public pages only.

A link · hover · focus

As it should appear on your account

Error: Enter an email address, like name@example.com

Anything the guide should know

Send me

Choose any

Who makes the final call?

Choose one

Error: Choose who makes the final call

Card

Text on a panel, in the primary ink.

Table, outlined cells
LevelNameNote
1PinkBody in the secondary ink
12OrangeScrolls sideways on a phone
Notice: Your subscription renews on 1 December.
Done: Saved.
Check: Your access ends in 30 days.
Working…

Agent panel

  1. Human

    We want an AI to draft supplier risk summaries. Where do we start?

  2. AI

    Start by deciding who owns the final call. At the level you describe, a person approves each summary before it is used.

    Sources: Decision levels, Decision rights

While a reply streams, send becomes stop; while listening, voice is pressed:

  1. Human

    Summarize the audit checklist for level 4.

Thinking…
    Listening…

    Dark aesthetic (opt-in)

    The page. The header shows the name in text until the logo files arrive; under 48rem the navigation is its own row. The footer shows on public pages only.

    A link · hover · focus

    As it should appear on your account

    Error: Enter an email address, like name@example.com

    Anything the guide should know

    Send me

    Choose any

    Who makes the final call?

    Choose one

    Error: Choose who makes the final call

    Card

    Text on a panel, in the primary ink.

    Table, outlined cells
    LevelNameNote
    1PinkBody in the secondary ink
    12OrangeScrolls sideways on a phone
    Notice: Your subscription renews on 1 December.
    Done: Saved.
    Check: Your access ends in 30 days.
    Working…

    Agent panel

    1. Human

      We want an AI to draft supplier risk summaries. Where do we start?

    2. AI

      Start by deciding who owns the final call. At the level you describe, a person approves each summary before it is used.

      Sources: Decision levels, Decision rights

    While a reply streams, send becomes stop; while listening, voice is pressed:

    1. Human

      Summarize the audit checklist for level 4.

    Thinking…
      Listening…

      Measured contrast (WCAG 2.2)

      Computed from the resolved role values on every build. The build fails if a gated pair is below its required ratio. Pairs with no requirement are reported with the reason.

      Documented pairs
      AestheticPairUseMeasuredRequiredResult
      lightink on surfacebody text on the page (1.4.3)17.89:14.50:1pass
      lightink on paneltext on a card or table head (1.4.3)16.70:14.50:1pass
      lightink-secondary on surfacetable body and secondary text (1.4.3)12.63:14.50:1pass
      lightink-secondary on panelsecondary text on a card (1.4.3)11.79:14.50:1pass
      lightaction-ink on actionbutton label (1.4.3)7.09:14.50:1pass
      lightaction-ink on action-hoverbutton label on hover (1.4.3)9.96:14.50:1pass
      lightlink on surfacelink text on the page (1.4.3)7.09:14.50:1pass
      lightlink on panellink text on a card (1.4.3)6.62:14.50:1pass
      lightlink-hover on surfacelink text on hover (1.4.3)9.96:14.50:1pass
      lightcontrol-line on surfacefield boundary (1.4.11)3.40:13.00:1pass
      lightfocus on surfacefocus indicator on the page (1.4.11)7.09:13.00:1pass
      lightfocus on panelfocus indicator on a card (1.4.11)6.62:13.00:1pass
      lightline on surfacetable and card hairline (1.4.11). Ruled by Dan at about 2:1 (line.hairline_on_light). Decorative divider, not the boundary of a control, so 3:1 is not required; reported so the ruling is visible.2.05:1nonereported
      darkink on surfacebody text on the page (1.4.3)18.71:14.50:1pass
      darkink on paneltext on a card or table head (1.4.3)9.42:14.50:1pass
      darkink-secondary on surfacesecondary text (pure white by rules.dark_type) (1.4.3)18.71:14.50:1pass
      darkaction-ink on actionbutton label (1.4.3)7.09:14.50:1pass
      darkaction-ink on action-hoverbutton label on hover (1.4.3)9.96:14.50:1pass
      darklink on surfacelink text on the page (1.4.3)18.71:14.50:1pass
      darkcontrol-line on surfacefield boundary (1.4.11)5.50:13.00:1pass
      darkfocus on surfacefocus indicator on the page (1.4.11)18.71:13.00:1pass
      darkfocus on panelfocus indicator on a card (1.4.11)9.42:13.00:1pass
      darkline on paneltable and card hairline (1.4.11). Computed off the panel by the token file's own rule; decorative divider.1.88:1nonereported
      darkaction on surfacebutton fill against the page (1.4.11). Primary indigo on the dark field is below 3:1. The label inside the button carries the meaning (1.4.11 does not require a boundary the text already identifies); reported so the ruling is visible.2.64:1nonereported
      lightaction-ink on actor-humanHuman chip label (rules.actor_color) (1.4.3)4.65:14.50:1pass
      lightaction-ink on actor-aiAI chip label (rules.actor_color) (1.4.3)7.09:14.50:1pass
      lightactor-human-bar on panelHuman edge bar on a message panel (1.4.11)4.34:13.00:1pass
      lightactor-ai-bar on panelAI edge bar on a message panel (1.4.11)6.62:13.00:1pass
      darkaction-ink on actor-humanHuman chip label (rules.actor_color) (1.4.3)4.65:14.50:1pass
      darkaction-ink on actor-aiAI chip label (rules.actor_color) (1.4.3)7.09:14.50:1pass
      darkactor-human-bar on panelHuman edge bar on a message panel (1.4.11)3.07:13.00:1pass
      darkactor-ai-bar on panelAI edge bar on a message panel (1.4.11)3.06:13.00:1pass
      lightstatus-ink on error-filltext on a error notice (1.4.3)9.20:14.50:1pass
      lighterror on surfaceerror text and field border on the page (1.4.3)6.27:14.50:1pass
      lighterror on panelerror text on a card (1.4.3)5.85:14.50:1pass
      lighterror on error-fillerror edge bar on its notice (1.4.11)4.57:13.00:1pass
      lightstatus-ink on caution-filltext on a caution notice (1.4.3)10.29:14.50:1pass
      lightcaution on surfacecaution text and field border on the page (1.4.3)5.60:14.50:1pass
      lightcaution on panelcaution text on a card (1.4.3)5.23:14.50:1pass
      lightcaution on caution-fillcaution edge bar on its notice (1.4.11)4.56:13.00:1pass
      lightstatus-ink on success-filltext on a success notice (1.4.3)10.55:14.50:1pass
      lightsuccess on surfacesuccess text and field border on the page (1.4.3)5.42:14.50:1pass
      lightsuccess on panelsuccess text on a card (1.4.3)5.06:14.50:1pass
      lightsuccess on success-fillsuccess edge bar on its notice (1.4.11)4.53:13.00:1pass
      darkstatus-ink on error-filltext on a error notice (1.4.3)7.14:14.50:1pass
      darkerror on surfaceerror text and field border on the page (1.4.3)8.97:14.50:1pass
      darkerror on panelerror text on a card (1.4.3)4.51:14.50:1pass
      darkerror on error-fillerror edge bar on its notice (1.4.11)3.42:13.00:1pass
      darkstatus-ink on caution-filltext on a caution notice (1.4.3)4.97:14.50:1pass
      darkcaution on surfacecaution text and field border on the page (1.4.3)11.38:14.50:1pass
      darkcaution on panelcaution text on a card (1.4.3)5.73:14.50:1pass
      darkcaution on caution-fillcaution edge bar on its notice (1.4.11)3.02:13.00:1pass
      darkstatus-ink on success-filltext on a success notice (1.4.3)4.65:14.50:1pass
      darksuccess on surfacesuccess text and field border on the page (1.4.3)12.17:14.50:1pass
      darksuccess on panelsuccess text on a card (1.4.3)6.12:14.50:1pass
      darksuccess on success-fillsuccess edge bar on its notice (1.4.11)3.02:13.00:1pass
      lightselected on surfacea checked box, radio or switch, and the current-page bar in the navigation (1.4.11)7.09:13.00:1pass
      lightselected on panela checked box, radio or switch on a card (1.4.11)6.62:13.00:1pass
      lightselected-ink on selectedthe tick in a checked box and the thumb of a switch that is on (1.4.11)7.09:13.00:1pass
      darkselected on surfacea checked box, radio or switch, and the current-page bar in the navigation (1.4.11)18.71:13.00:1pass
      darkselected on panela checked box, radio or switch on a card (1.4.11)9.42:13.00:1pass
      darkselected-ink on selectedthe tick in a checked box and the thumb of a switch that is on (1.4.11)18.71:13.00:1pass

      Each spectrum colour against the surfaces

      Spectrum contrast
      ColourOn whiteOn the dark field
      pink #ED18604.29:14.37:1
      magenta #C3386C5.12:13.66:1
      purple #68318A8.77:12.13:1
      indigo #4A50A27.09:12.64:1
      blue #2590CF3.52:15.32:1
      teal #08B5A52.57:17.27:1
      green #4DB3582.66:17.04:1
      orange #F475212.83:16.61:1

      Decisions

      Colour is led by Ross and Dan's design system. The application layer is decided in this package. Full record: packages/brand/DECISIONS.md.

      Taken from the design system

      Taken from the design system
      ColourThe spectrum (8 and 12 step), each hue's shade and tint, the fields, inks, hairline and comparison grey, as CSS variables and data. HAI Indigo is the primary. No colour is entered anywhere else; the build fails on a hand-entered one
      Computed colour rulesHover is the hue's shade (rules.hover_state). A colour that must carry text or meaning is the hue moved the least that clears its contrast floor (the mechanism of rules.marker_color, edge_bar_color and solid_plate_type)
      The contrast gateEvery colour pair the application draws is measured on each build against WCAG 2.2 and fails the build below its ratio (rules.contrast_gate)
      TypefaceOpen Sans (type.family, ratified), in the weights the token file lists. The live site uses the same
      Human and AI coloursHuman in shade green, AI in indigo, white type on the chip (rules.actor_color), in the agent panel
      Status huesError, caution and success take Dan's role mapping from rules.worksheet_cell_tint (problem pink, caution orange, aligned green): the hue's tint as the fill on light, its shade on dark
      Space iconsThe twelve space glyphs and their disc-plate form, copied from space-icons-lab at the pinned commit
      Eight-colour ruleThe wordmark's underline order (color.spectrum8_titlebar_order) under the hero and in the working indicator

      Decided for the application

      Decided for the application
      Type scaleMeasured on the live site humansplus.ai: body 17px at 1.65, headings at weight 800 with tight tracking (h1 35px rising to 56px, h2 29px to 42px), h3 at 700, eyebrow and lead styles. Phone sizes first
      Spacing and layoutSeven spacing steps (0.25rem to 3rem); a 72.5rem page, 5.5rem between sections and 1.875rem card padding from the live site; 48rem breakpoint; 2.75rem minimum touch target
      Rounded corners6px on controls (buttons, fields, icon buttons, chips) and surfaces (cards, notices, tables, the agent panel). The live site rounds its buttons at 6px
      FocusA 3px outline, 2px offset: indigo on light, white on dark, measured at 3:1 or better
      LinksIndigo and underlined on light, hover to indigo shade; white and underlined on dark, because indigo is 2.64:1 on the dark field
      ButtonsPrimary (indigo, white label, bold) and neutral (outlined); icon and icon-only forms; disabled is a quiet panel fill
      FieldsA 2px boundary in the comparison grey (3.40:1 on white), because the hairline is 2:1 and a control needs 3:1; errors in the error colour with the word Error
      NoticesTinted fill, edge bar in the status colour, and the kind always said in a word, never by colour alone
      Dark aestheticBuilt from field.dark and field.dark_panel, opt-in with data-aesthetic="dark". Light on field.white is the default
      Agent panelThe person's turn is a bubble, the guide's reply bare text; the composer is one frame of glyph controls (attach, voice, send that becomes stop). Pattern from the Helikona chat reference
      IconsThe design system's glyph language extended to platform nouns and actions (member, organization, guide, voice, search, content card, table, email, send, stop, attach, open a list, home); three sizes
      Motion120ms transitions on the site's easing curve; the working indicator steps through the eight colours in 1.4s; all motion stops under reduced-motion
      TablesReal tables with hairline cells, heads on the panel, sideways scroll on a phone
      Form controlsText area and select share the field's label, hint and error. Checkbox, radio and switch are the native inputs restyled, so keyboard and assistive technology behave as standard; the whole row is the touch target; checked is the primary colour on light and white on dark (the primary is 2.64:1 on the dark field), with the design system's tick glyph. An unchecked control keeps the page surface as its fill, so its boundary is 3:1 wherever it sits. Groups are a fieldset with a legend. In a text field the control sits directly under its label, with the hint and error beneath, so controls in neighbouring columns line up; fields are spaced by one even gap (hai-form)
      Navigation and shellSized on the Helikona client: a 56px header that stays at the top, on the page surface with a hairline beneath; 36px controls in it. The name is text until the logo files arrive (M1). Signed out, the right side is a sign-in button; signed in, the member's profile picture as a round button (a grey head-and-shoulders placeholder when there is none) that opens a menu without script. Primary navigation takes a glyph per item and marks the current page with a bar in the selected colour and aria-current; under the breakpoint it is its own row and scrolls sideways. A skip link comes first. The footer shows only on public pages, never once signed in. Single-column form pages such as sign-in are 28rem wide

      Not carried over

      Not carried over
      Square cornersgeometry.corners is ratified square (Ross, 2026-08-18) for graphics and Circle tiles. In an interactive product it reads as dated, and the live site already rounds its buttons. Derek Laney's instruction, 2026-11-16
      Colour only on the edge barThe Corporate Neutral style keeps colour off panels. Application notices need a status a person sees at once, so they take a tinted fill from the same tokens
      The hairline as a control boundaryline.hairline_on_light is ruled at about 2:1 for table and panel outlines and stays there; it is too faint for a form field under WCAG 2.2
      Graphics type conventionsThe frame-class scale, the 1600px master sizes and the 32px content-type tiebreaker are for rendered graphics and do not apply to live text
      The live site's off-token coloursThe site's blue button fill, its greys (#111111, #5C5C66, #E4E4EA, #F6F6FA), header shadow and indigo-to-purple gradient are not in the token file, so they are not used: colour is led by the token file

      Not built yet

      Not built yet
      Logo, wordmark and application iconsThe files from Ross's team (only a PNG sample is in the repository); then favicon, touch icons and a web manifest
      Primary navigation and legal pagesThe header carries no navigation items yet because the application has no sections to link to; the footer has no terms or privacy links because those pages do not exist
      Overlays and feedbackDialog, menu, tabs, toast, empty and loading states
      EmailAn email layout and components on the token data (generated/tokens.json is ready for it)
      ElevationNo shadow tokens exist; none are used

      To confirm with Ross and Dan

      To confirm with Ross and Dan
      Rounded corners (N1)May the application be rounded, and should geometry.corners record it? Built rounded
      NeutralsShould the site's cooler greys become tokens, so the site and the application share them (N5)? Built on the token file's neutrals
      Dark modeDoes the application ship the dark aesthetic, and follow the device setting? Built opt-in
      The application's glyphs (A11)Approve or redraw the thirteen glyphs added here
      Status colours (S6)Confirm the worksheet's problem, caution and aligned hues may also mark errors, warnings and success