Agent Discoverability
agentdiscoverability.com
Become the product AI agents choose.
agentdiscoverability.com
AI Breakdown
Design export
# Design brief: the Agent Discoverability design language
Below is a complete design specification measured from a real, published web page. Use it as a design language for the user's product. It is not a page to reproduce.
## Reference images
- Full page: https://cdn.designmunk.com/2026/11/02114851/agentdiscoverability-com-featured.png
- Above the fold: https://cdn.designmunk.com/2026/11/02114851/agentdiscoverability-com-featured-1440x900.png
- On DesignMunk: https://designmunk.com/agent-discoverability/
Study these for hierarchy, rhythm, spacing and density. Where an image and the written spec disagree, the spec wins: the tokens were read from the page's own CSS, the images are one rendering of it.
## Before you start
Ask the user what they are building, who it is for, and what brand assets they already have — name, colours, typefaces. Wait for their answers before writing anything. Everything below is then applied to their product, not to the reference.
## Design specification
# Agent Discoverability: Chat Transcripts as Proof Across the Page
## Overview
Analytical, product-ops tone aimed at PMs and technical marketers. Interface feels calm and trustworthy: light surfaces, thin borders, compact radii, and a single bright mint for primary actions. Density alternates—airy hero and CTAs, denser proof sections with transcript and dashboard cards. When tokens don't cover edge cases, prefer crisp contrast, restrained color, and evidence-first composition.
## Page Structure
- Utility bar: slim announcement with link; full-width, above navigation.
- Header: single-row navbar; logo left, multi-item menus center, auth actions right; compact height on light surface.
- Hero: two-column; left holds oversized display headline, brief body, primary and text CTAs; right is a carded brand-check form; subtle green gradient/halftone backdrop.
- Agent icons strip: small row of circular brand marks under hero CTAs.
- Customer stories: dense mosaic of logo tiles, metric cards, and testimonial quotes in a multi-row grid.
- Platform intro: brief section header before feature blocks.
- Organic recommendations: two-up transcript cards (Claude and ChatGPT) showing example exchanges and a plugin/connector tile.
- Agent discovery dashboard: composite layout with a chat on the left and a right-hand status table; numbered callouts.
- Cross-platform testing: headline with a horizontal list of agent tabs/pills and supporting copy.
- Persona discovery: two persona cards in a row with "memory" tags and example prompts.
- Competitor intelligence: left list of brands with statuses; right update card.
- Opportunities & improvements: list of draft items with a highlighted review card.
- How it works: 4-step horizontal/stacked stepper with 01–04 labels and short explanations; CTA follows.
- Services: two side-by-side service cards, each with headline and CTA.
- Ecosystem tracker: single promo card with CTA.
- FAQs: long accordion list in one column.
- Closing CTA: concise headline and dual buttons.
- Footer: multi-column site map with product, resources, and company links.
## Colors
- Primary (#101010): Core text and high-contrast UI controls.
- Secondary (#447c6c): Link text, quiet actions, and icons; pairs well on white.
- Tertiary (#1bc88c): Primary action and emphasis elements only; use sparingly.
- Neutral (#f8faf9): Page background and section surfaces.
- Border (#ccded2): Dividers, card borders, table lines, and subtle outlines.
- Brand-funk (#39ab84): Highlight accents within charts or metrics; sits between secondary and tertiary.
- Brand-brunswick-green (#1d543c): Deep accent for badges, chips, or dark-on-light treatments.
- Surface ({colors.neutral}): Card backdrops when the page background needs a slightly tinted field.
- On-surface ({colors.primary}): Default text color on surface and card backgrounds.
## Typography
- Manrope (self-hosted, custom): Used for headline-lg/md/sm and body-md. Headline-lg 55px/1.1 at 500 with -0.03em for the hero; headline-md 40px/1.2; headline-sm 29px/1.21; body-md 15px/1.65 at 400. If Manrope isn't available, substitute Inter (Google), Public Sans (Google), or IBM Plex Sans (Google).
- Montreal (self-hosted, custom): Used for headline-xs at 21px/1.19 for small section labels and UI headings. Substitute Work Sans (Google), Rubik (Google), or Montserrat (Google).
- Inter (Google available): May be used as a universal fallback in implementations where custom faces can't be loaded. Maintain the specified sizes and letter-spacing values when substituting.
## Layout
- Spacing scale: xs 2px for hairline gaps; sm 10px for inline chips and icon spacing; md 18px for button paddings and small gutters; lg 30px as the base section padding and card gaps; xl 120px for section vertical rhythm and hero spacing.
- Grid: Two-column hero; subsequent sections alternate single-column headers with rows of cards or two-up comparisons. Use generous outer gutters and consistent 30px inter-card gaps to prevent the proof mosaics from collapsing visually.
- Containers: Cards sit on #ffffff with 13px internal padding; keep section padding to multiples of 30px with 120px for major breaks.
## Elevation & Depth
- Shadows are subtle and cool-tinted: sm to xl variants plus an inner focus ring. Prefer lg (0 6px 24px @ 0.04) for larger showcase cards and md for smaller tiles.
- Hierarchy relies primarily on borders (#ccded2), tonal steps (white on mist), and whitespace. Reserve stronger xl shadow for modals or the hero checker card.
- Use the inner inset ring as an accessible focus state on inputs and interactive cards.
## Shapes
- Small radii communicate precision: 5px (rounded.sm) on buttons and inputs; 7px (rounded.md) on cards and larger containers.
- Keep shape language consistent within a cluster; avoid mixing circles with squared corners unless showing logos or avatars.
- Chips and pills may use 5px unless a full pill is strictly required.
## Components
- Buttons
- Primary: #1bc88c background, #ffffff text, 5px radius, 12px×18px padding, 44px fixed height.
- Secondary: #ffffff background, #101010 text, 5px radius, 12px×18px padding, 44px height; use border #ccded2 when needed for definition.
- Link: #55826a text, no radius; inline with body size.
- Card: #ffffff background, #101010 text, 7px radius, 13px internal padding; apply md or lg shadow sparingly.
### Brand Check Form (Hero)
Two-column hero right card with a single-line text input for a domain, a prominent primary CTA (#1bc88c) and an inline result tile. Card uses 7px radius, lg shadow, and a thin #ccded2 border.
### Agent Icon Strip
A compact horizontal row of agent logos under the hero buttons; 10px gaps, icons on subtle white chips with 5px radius when needed.
### Customer Stories Mosaic
A grid of logo tiles, metric cards, and quote blocks. Each tile is a 7px-radius card on white; use border #ccded2 and md shadow. Keep 30px row gaps.
### Conversation Example Card
Chat transcript canvas with alternating bubbles and a right-rail plugin/connector tile showing primary and secondary actions. White card, 7px radius, md shadow; body text at 15px.
### Visibility Dashboard Table
A two-pane composition: left mini-transcript with numbered markers; right table of "Signal / Brand / Result" in a bordered card. Use 13px card padding and 30px gaps between panes.
### Cross-Platform Tabs
Horizontal list of agent tabs/pills above supporting copy. Default tabs use secondary (#447c6c) text; active state may use #1bc88c underline or background with 5px radius.
### Persona Cards
Two cards per row with a name, short "memory" tags, and a sample prompt. Cards use 7px radius, bordered, with 18px internal spacing.
### Improvement Draft Card
Highlight card with a small status badge (e.g., Draft ready), a concise change description, and a right-aligned review CTA. Uses lg shadow and #1bc88c CTA; 7px radius.
## Do's and Don'ts
- Do reserve #1bc88c for primary CTAs and key state markers; use #447c6c for links and secondary emphasis.
- Do separate dense proof sections with xl (120px) vertical spacing to keep scanning comfortable.
- Do keep cards on #ffffff with 7px radius and a #ccded2 border; add shadows only when layering over gradients.
- Don't mix more than two greens in the same component; prefer tertiary for action, secondary for text.
- Don't round buttons beyond 5px or add heavy shadows—they conflict with the system's precise tone.
- Don't place long quotes and metric tiles in the same row without a 30px gap; the mosaic can otherwise read as cluttered.
## Agent Prompt Guide
Quick color reference
- Text: #101010
- Background: #f8faf9
- Border: #ccded2
- Accent (CTA): #1bc88c
1) Two-column hero with brand checker
"Create a full-width hero on #f8faf9. Left column: Manrope (or Inter fallback) headline at 55px/1.1, weight 500, letter-spacing -0.03em; body at 15px/1.65. Add a primary button (#1bc88c, #ffffff text, 5px radius, 44px height, 12×18px padding) and a text link in #55826a. Right column: a 7px-radius card on #ffffff with lg shadow and a #ccded2 border containing a single-line input and a primary CTA."
2) Customer-story mosaic row
"On #ffffff, place a row of 3–4 cards with 7px radius, 13px padding, #ccded2 borders, md shadow. Titles use Manrope 29px/1.21 500; metrics in #1bc88c. Maintain 30px gaps between cards and 120px above/below the section."
3) Conversation example pair
"Add two cards side by side on #f8faf9. Each: 7px radius, md shadow, 13px padding. Use body text 15px/1.65, with chat bubbles and a right-aligned connector tile featuring a primary button (#1bc88c) and a neutral secondary."
4) Cross-platform tabs
"Place a centered heading (Manrope 40px/1.2, 500). Below, a horizontal list of tabs with 5px radius; default text #447c6c, active underline or chip in #1bc88c. Keep 10px intra-tab spacing and 30px margin to content."
## Similar Brands
- OpenAI: restrained layouts with light surfaces and focused accent color; this site adds denser card mosaics and more explicit dashboard UIs.
- Anthropic: minimal, content-first pages; Agent Discoverability is similarly quiet but leans harder on illustrative transcripts.
- Twilio Segment: data- and metric-led storytelling with green accents; Segment is louder visually, while this system stays lighter and more technical.
- Vercel: crisp black/white, small radii, and subtle shadows; here the accent is mint rather than monochrome, and cards are more numerous.
## Tokens
### CSS custom properties
```css
:root {
/* Colors */
--color-primary: #101010;
--color-secondary: #447c6c;
--color-tertiary: #1bc88c;
--color-neutral: #f8faf9;
--color-border: #ccded2;
--color-brand-funk: #39ab84;
--color-brand-brunswick-green: #1d543c;
--color-surface: var(--color-neutral);
--color-on-surface: var(--color-primary);
/* Typography */
--text-headline-lg-size: 55px;
--text-headline-lg-weight: 500;
--text-headline-lg-leading: 1.1;
--text-headline-lg-tracking: -0.03em;
--text-headline-md-size: 40px;
--text-headline-md-weight: 500;
--text-headline-md-leading: 1.2;
--text-headline-md-tracking: -0.025em;
--text-headline-sm-size: 29px;
--text-headline-sm-weight: 500;
--text-headline-sm-leading: 1.21;
--text-headline-sm-tracking: -0.003em;
--text-headline-xs-size: 21px;
--text-headline-xs-weight: 500;
--text-headline-xs-leading: 1.19;
--text-body-md-size: 15px;
--text-body-md-weight: 400;
--text-body-md-leading: 1.65;
--text-body-md-tracking: -0.01em;
--font-manrope: "Manrope";
--font-montreal: "montreal";
/* Rounded */
--radius-sm: 5px;
--radius-md: 7px;
/* Spacing */
--spacing-xs: 2px;
--spacing-sm: 10px;
--spacing-md: 18px;
--spacing-lg: 30px;
--spacing-xl: 120px;
/* Components */
--button-primary-background-color: var(--color-tertiary);
--button-primary-text-color: #ffffff;
--button-primary-rounded: var(--radius-sm);
--button-primary-padding: 12px 18px;
--button-primary-height: 44px;
--button-secondary-background-color: #ffffff;
--button-secondary-text-color: var(--color-primary);
--button-secondary-rounded: var(--radius-sm);
--button-secondary-padding: 12px 18px;
--button-secondary-height: 44px;
--button-link-text-color: #55826a;
--button-link-rounded: 0px;
--card-background-color: #ffffff;
--card-text-color: var(--color-primary);
--card-rounded: var(--radius-md);
--card-padding: 13px;
}
```
### Tailwind theme
```css
@theme {
--color-primary: #101010;
--color-secondary: #447c6c;
--color-tertiary: #1bc88c;
--color-neutral: #f8faf9;
--color-border: #ccded2;
--color-brand-funk: #39ab84;
--color-brand-brunswick-green: #1d543c;
--color-surface: #f8faf9;
--color-on-surface: #101010;
--font-headline-lg: "Manrope";
--font-headline-md: "Manrope";
--font-headline-sm: "Manrope";
--font-headline-xs: "montreal";
--font-body-md: "Manrope";
--text-headline-lg: 55px;
--text-headline-md: 40px;
--text-headline-sm: 29px;
--text-headline-xs: 21px;
--text-body-md: 15px;
--tracking-headline-lg: -0.03em;
--tracking-headline-md: -0.025em;
--tracking-headline-sm: -0.003em;
--tracking-body-md: -0.01em;
--font-weight-headline-lg: 500;
--font-weight-headline-md: 500;
--font-weight-headline-sm: 500;
--font-weight-headline-xs: 500;
--font-weight-body-md: 400;
--radius-sm: 5px;
--radius-md: 7px;
--spacing-xs: 2px;
--spacing-sm: 10px;
--spacing-md: 18px;
--spacing-lg: 30px;
--spacing-xl: 120px;
}
```
### Design tokens (DTCG)
```json
{
"$schema": "https://www.designtokens.org/schemas/2025.10/format.json",
"color": {
"$type": "color",
"primary": {
"$value": {
"colorSpace": "srgb",
"components": [
0.063,
0.063,
0.063
],
"hex": "#101010"
}
},
"secondary": {
"$value": {
"colorSpace": "srgb",
"components": [
0.267,
0.486,
0.424
],
"hex": "#447c6c"
}
},
"tertiary": {
"$value": {
"colorSpace": "srgb",
"components": [
0.106,
0.784,
0.549
],
"hex": "#1bc88c"
}
},
"neutral": {
"$value": {
"colorSpace": "srgb",
"components": [
0.973,
0.98,
0.976
],
"hex": "#f8faf9"
}
},
"border": {
"$value": {
"colorSpace": "srgb",
"components": [
0.8,
0.871,
0.824
],
"hex": "#ccded2"
}
},
"brand-funk": {
"$value": {
"colorSpace": "srgb",
"components": [
0.224,
0.671,
0.518
],
"hex": "#39ab84"
}
},
"brand-brunswick-green": {
"$value": {
"colorSpace": "srgb",
"components": [
0.114,
0.329,
0.235
],
"hex": "#1d543c"
}
},
"surface": {
"$value": {
"colorSpace": "srgb",
"components": [
0.973,
0.98,
0.976
],
"hex": "#f8faf9"
}
},
"on-surface": {
"$value": {
"colorSpace": "srgb",
"components": [
0.063,
0.063,
0.063
],
"hex": "#101010"
}
}
},
"spacing": {
"$type": "dimension",
"xs": {
"$value": {
"value": 2,
"unit": "px"
}
},
"sm": {
"$value": {
"value": 10,
"unit": "px"
}
},
"md": {
"$value": {
"value": 18,
"unit": "px"
}
},
"lg": {
"$value": {
"value": 30,
"unit": "px"
}
},
"xl": {
"$value": {
"value": 120,
"unit": "px"
}
}
},
"rounded": {
"$type": "dimension",
"sm": {
"$value": {
"value": 5,
"unit": "px"
}
},
"md": {
"$value": {
"value": 7,
"unit": "px"
}
}
},
"typography": {
"headline-lg": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 55,
"unit": "px"
},
"fontWeight": 500,
"letterSpacing": {
"value": -0.03,
"unit": "em"
}
}
},
"headline-md": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 40,
"unit": "px"
},
"fontWeight": 500,
"letterSpacing": {
"value": -0.025,
"unit": "em"
}
}
},
"headline-sm": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 29,
"unit": "px"
},
"fontWeight": 500,
"letterSpacing": {
"value": -0.003,
"unit": "em"
}
}
},
"headline-xs": {
"$type": "typography",
"$value": {
"fontFamily": "montreal",
"fontSize": {
"value": 21,
"unit": "px"
},
"fontWeight": 500
}
},
"body-md": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 15,
"unit": "px"
},
"fontWeight": 400,
"letterSpacing": {
"value": -0.01,
"unit": "em"
}
}
}
}
}
```
## Rules
- **Fonts.** If the specification names a custom or self-hosted family, use one of the substitutes it names. Never reference a typeface you cannot actually load — it will fall back to a system font and undo the typography.
- **Colour.** Derive the palette from the user's brand. Use the token values as a guide to *relationships* — contrast, tint, how many accents carry the page — not as hex codes to paste.
- **Never reproduce** the wordmark, mascot, logo, brand name, illustrations, icon set, screenshots or any copy from the reference.
- **Never present the result as Agent Discoverability**, or imply any connection to it.
- If something is unspecified, choose clarity and legibility over decoration.
---
version: alpha
name: Agent Discoverability
description: Become the product AI agents choose.
colors:
primary: "#101010"
secondary: "#447c6c"
tertiary: "#1bc88c"
neutral: "#f8faf9"
border: "#ccded2"
brand-funk: "#39ab84"
brand-brunswick-green: "#1d543c"
surface: "{colors.neutral}"
on-surface: "{colors.primary}"
typography:
headline-lg:
fontFamily: Manrope
fontSize: 55px
fontWeight: 500
lineHeight: 1.1
letterSpacing: -0.03em
headline-md:
fontFamily: Manrope
fontSize: 40px
fontWeight: 500
lineHeight: 1.2
letterSpacing: -0.025em
headline-sm:
fontFamily: Manrope
fontSize: 29px
fontWeight: 500
lineHeight: 1.21
letterSpacing: -0.003em
headline-xs:
fontFamily: montreal
fontSize: 21px
fontWeight: 500
lineHeight: 1.19
body-md:
fontFamily: Manrope
fontSize: 15px
fontWeight: 400
lineHeight: 1.65
letterSpacing: -0.01em
rounded:
sm: 5px
md: 7px
spacing:
xs: 2px
sm: 10px
md: 18px
lg: 30px
xl: 120px
components:
button-primary:
backgroundColor: "{colors.tertiary}"
textColor: "#ffffff"
rounded: "{rounded.sm}"
padding: 12px 18px
height: 44px
button-secondary:
backgroundColor: "#ffffff"
textColor: "{colors.primary}"
rounded: "{rounded.sm}"
padding: 12px 18px
height: 44px
button-link:
textColor: "#55826a"
rounded: 0px
card:
backgroundColor: "#ffffff"
textColor: "{colors.primary}"
rounded: "{rounded.md}"
padding: 13px
---
# Agent Discoverability: Chat Transcripts as Proof Across the Page
## Overview
Analytical, product-ops tone aimed at PMs and technical marketers. Interface feels calm and trustworthy: light surfaces, thin borders, compact radii, and a single bright mint for primary actions. Density alternates—airy hero and CTAs, denser proof sections with transcript and dashboard cards. When tokens don't cover edge cases, prefer crisp contrast, restrained color, and evidence-first composition.
## Page Structure
- Utility bar: slim announcement with link; full-width, above navigation.
- Header: single-row navbar; logo left, multi-item menus center, auth actions right; compact height on light surface.
- Hero: two-column; left holds oversized display headline, brief body, primary and text CTAs; right is a carded brand-check form; subtle green gradient/halftone backdrop.
- Agent icons strip: small row of circular brand marks under hero CTAs.
- Customer stories: dense mosaic of logo tiles, metric cards, and testimonial quotes in a multi-row grid.
- Platform intro: brief section header before feature blocks.
- Organic recommendations: two-up transcript cards (Claude and ChatGPT) showing example exchanges and a plugin/connector tile.
- Agent discovery dashboard: composite layout with a chat on the left and a right-hand status table; numbered callouts.
- Cross-platform testing: headline with a horizontal list of agent tabs/pills and supporting copy.
- Persona discovery: two persona cards in a row with "memory" tags and example prompts.
- Competitor intelligence: left list of brands with statuses; right update card.
- Opportunities & improvements: list of draft items with a highlighted review card.
- How it works: 4-step horizontal/stacked stepper with 01–04 labels and short explanations; CTA follows.
- Services: two side-by-side service cards, each with headline and CTA.
- Ecosystem tracker: single promo card with CTA.
- FAQs: long accordion list in one column.
- Closing CTA: concise headline and dual buttons.
- Footer: multi-column site map with product, resources, and company links.
## Colors
- Primary (#101010): Core text and high-contrast UI controls.
- Secondary (#447c6c): Link text, quiet actions, and icons; pairs well on white.
- Tertiary (#1bc88c): Primary action and emphasis elements only; use sparingly.
- Neutral (#f8faf9): Page background and section surfaces.
- Border (#ccded2): Dividers, card borders, table lines, and subtle outlines.
- Brand-funk (#39ab84): Highlight accents within charts or metrics; sits between secondary and tertiary.
- Brand-brunswick-green (#1d543c): Deep accent for badges, chips, or dark-on-light treatments.
- Surface ({colors.neutral}): Card backdrops when the page background needs a slightly tinted field.
- On-surface ({colors.primary}): Default text color on surface and card backgrounds.
## Typography
- Manrope (self-hosted, custom): Used for headline-lg/md/sm and body-md. Headline-lg 55px/1.1 at 500 with -0.03em for the hero; headline-md 40px/1.2; headline-sm 29px/1.21; body-md 15px/1.65 at 400. If Manrope isn't available, substitute Inter (Google), Public Sans (Google), or IBM Plex Sans (Google).
- Montreal (self-hosted, custom): Used for headline-xs at 21px/1.19 for small section labels and UI headings. Substitute Work Sans (Google), Rubik (Google), or Montserrat (Google).
- Inter (Google available): May be used as a universal fallback in implementations where custom faces can't be loaded. Maintain the specified sizes and letter-spacing values when substituting.
## Layout
- Spacing scale: xs 2px for hairline gaps; sm 10px for inline chips and icon spacing; md 18px for button paddings and small gutters; lg 30px as the base section padding and card gaps; xl 120px for section vertical rhythm and hero spacing.
- Grid: Two-column hero; subsequent sections alternate single-column headers with rows of cards or two-up comparisons. Use generous outer gutters and consistent 30px inter-card gaps to prevent the proof mosaics from collapsing visually.
- Containers: Cards sit on #ffffff with 13px internal padding; keep section padding to multiples of 30px with 120px for major breaks.
## Elevation & Depth
- Shadows are subtle and cool-tinted: sm to xl variants plus an inner focus ring. Prefer lg (0 6px 24px @ 0.04) for larger showcase cards and md for smaller tiles.
- Hierarchy relies primarily on borders (#ccded2), tonal steps (white on mist), and whitespace. Reserve stronger xl shadow for modals or the hero checker card.
- Use the inner inset ring as an accessible focus state on inputs and interactive cards.
## Shapes
- Small radii communicate precision: 5px (rounded.sm) on buttons and inputs; 7px (rounded.md) on cards and larger containers.
- Keep shape language consistent within a cluster; avoid mixing circles with squared corners unless showing logos or avatars.
- Chips and pills may use 5px unless a full pill is strictly required.
## Components
- Buttons
- Primary: #1bc88c background, #ffffff text, 5px radius, 12px×18px padding, 44px fixed height.
- Secondary: #ffffff background, #101010 text, 5px radius, 12px×18px padding, 44px height; use border #ccded2 when needed for definition.
- Link: #55826a text, no radius; inline with body size.
- Card: #ffffff background, #101010 text, 7px radius, 13px internal padding; apply md or lg shadow sparingly.
### Brand Check Form (Hero)
Two-column hero right card with a single-line text input for a domain, a prominent primary CTA (#1bc88c) and an inline result tile. Card uses 7px radius, lg shadow, and a thin #ccded2 border.
### Agent Icon Strip
A compact horizontal row of agent logos under the hero buttons; 10px gaps, icons on subtle white chips with 5px radius when needed.
### Customer Stories Mosaic
A grid of logo tiles, metric cards, and quote blocks. Each tile is a 7px-radius card on white; use border #ccded2 and md shadow. Keep 30px row gaps.
### Conversation Example Card
Chat transcript canvas with alternating bubbles and a right-rail plugin/connector tile showing primary and secondary actions. White card, 7px radius, md shadow; body text at 15px.
### Visibility Dashboard Table
A two-pane composition: left mini-transcript with numbered markers; right table of "Signal / Brand / Result" in a bordered card. Use 13px card padding and 30px gaps between panes.
### Cross-Platform Tabs
Horizontal list of agent tabs/pills above supporting copy. Default tabs use secondary (#447c6c) text; active state may use #1bc88c underline or background with 5px radius.
### Persona Cards
Two cards per row with a name, short "memory" tags, and a sample prompt. Cards use 7px radius, bordered, with 18px internal spacing.
### Improvement Draft Card
Highlight card with a small status badge (e.g., Draft ready), a concise change description, and a right-aligned review CTA. Uses lg shadow and #1bc88c CTA; 7px radius.
## Do's and Don'ts
- Do reserve #1bc88c for primary CTAs and key state markers; use #447c6c for links and secondary emphasis.
- Do separate dense proof sections with xl (120px) vertical spacing to keep scanning comfortable.
- Do keep cards on #ffffff with 7px radius and a #ccded2 border; add shadows only when layering over gradients.
- Don't mix more than two greens in the same component; prefer tertiary for action, secondary for text.
- Don't round buttons beyond 5px or add heavy shadows—they conflict with the system's precise tone.
- Don't place long quotes and metric tiles in the same row without a 30px gap; the mosaic can otherwise read as cluttered.
## Agent Prompt Guide
Quick color reference
- Text: #101010
- Background: #f8faf9
- Border: #ccded2
- Accent (CTA): #1bc88c
1) Two-column hero with brand checker
"Create a full-width hero on #f8faf9. Left column: Manrope (or Inter fallback) headline at 55px/1.1, weight 500, letter-spacing -0.03em; body at 15px/1.65. Add a primary button (#1bc88c, #ffffff text, 5px radius, 44px height, 12×18px padding) and a text link in #55826a. Right column: a 7px-radius card on #ffffff with lg shadow and a #ccded2 border containing a single-line input and a primary CTA."
2) Customer-story mosaic row
"On #ffffff, place a row of 3–4 cards with 7px radius, 13px padding, #ccded2 borders, md shadow. Titles use Manrope 29px/1.21 500; metrics in #1bc88c. Maintain 30px gaps between cards and 120px above/below the section."
3) Conversation example pair
"Add two cards side by side on #f8faf9. Each: 7px radius, md shadow, 13px padding. Use body text 15px/1.65, with chat bubbles and a right-aligned connector tile featuring a primary button (#1bc88c) and a neutral secondary."
4) Cross-platform tabs
"Place a centered heading (Manrope 40px/1.2, 500). Below, a horizontal list of tabs with 5px radius; default text #447c6c, active underline or chip in #1bc88c. Keep 10px intra-tab spacing and 30px margin to content."
## Similar Brands
- OpenAI: restrained layouts with light surfaces and focused accent color; this site adds denser card mosaics and more explicit dashboard UIs.
- Anthropic: minimal, content-first pages; Agent Discoverability is similarly quiet but leans harder on illustrative transcripts.
- Twilio Segment: data- and metric-led storytelling with green accents; Segment is louder visually, while this system stays lighter and more technical.
- Vercel: crisp black/white, small radii, and subtle shadows; here the accent is mint rather than monochrome, and cards are more numerous.
:root {
/* Colors */
--color-primary: #101010;
--color-secondary: #447c6c;
--color-tertiary: #1bc88c;
--color-neutral: #f8faf9;
--color-border: #ccded2;
--color-brand-funk: #39ab84;
--color-brand-brunswick-green: #1d543c;
--color-surface: var(--color-neutral);
--color-on-surface: var(--color-primary);
/* Typography */
--text-headline-lg-size: 55px;
--text-headline-lg-weight: 500;
--text-headline-lg-leading: 1.1;
--text-headline-lg-tracking: -0.03em;
--text-headline-md-size: 40px;
--text-headline-md-weight: 500;
--text-headline-md-leading: 1.2;
--text-headline-md-tracking: -0.025em;
--text-headline-sm-size: 29px;
--text-headline-sm-weight: 500;
--text-headline-sm-leading: 1.21;
--text-headline-sm-tracking: -0.003em;
--text-headline-xs-size: 21px;
--text-headline-xs-weight: 500;
--text-headline-xs-leading: 1.19;
--text-body-md-size: 15px;
--text-body-md-weight: 400;
--text-body-md-leading: 1.65;
--text-body-md-tracking: -0.01em;
--font-manrope: "Manrope";
--font-montreal: "montreal";
/* Rounded */
--radius-sm: 5px;
--radius-md: 7px;
/* Spacing */
--spacing-xs: 2px;
--spacing-sm: 10px;
--spacing-md: 18px;
--spacing-lg: 30px;
--spacing-xl: 120px;
/* Components */
--button-primary-background-color: var(--color-tertiary);
--button-primary-text-color: #ffffff;
--button-primary-rounded: var(--radius-sm);
--button-primary-padding: 12px 18px;
--button-primary-height: 44px;
--button-secondary-background-color: #ffffff;
--button-secondary-text-color: var(--color-primary);
--button-secondary-rounded: var(--radius-sm);
--button-secondary-padding: 12px 18px;
--button-secondary-height: 44px;
--button-link-text-color: #55826a;
--button-link-rounded: 0px;
--card-background-color: #ffffff;
--card-text-color: var(--color-primary);
--card-rounded: var(--radius-md);
--card-padding: 13px;
}
{
"$schema": "https://www.designtokens.org/schemas/2025.10/format.json",
"$description": "Become the product AI agents choose.",
"color": {
"$type": "color",
"primary": {
"$value": {
"colorSpace": "srgb",
"components": [
0.063,
0.063,
0.063
],
"hex": "#101010"
}
},
"secondary": {
"$value": {
"colorSpace": "srgb",
"components": [
0.267,
0.486,
0.424
],
"hex": "#447c6c"
}
},
"tertiary": {
"$value": {
"colorSpace": "srgb",
"components": [
0.106,
0.784,
0.549
],
"hex": "#1bc88c"
}
},
"neutral": {
"$value": {
"colorSpace": "srgb",
"components": [
0.973,
0.98,
0.976
],
"hex": "#f8faf9"
}
},
"border": {
"$value": {
"colorSpace": "srgb",
"components": [
0.8,
0.871,
0.824
],
"hex": "#ccded2"
}
},
"brand-funk": {
"$value": {
"colorSpace": "srgb",
"components": [
0.224,
0.671,
0.518
],
"hex": "#39ab84"
}
},
"brand-brunswick-green": {
"$value": {
"colorSpace": "srgb",
"components": [
0.114,
0.329,
0.235
],
"hex": "#1d543c"
}
},
"surface": {
"$value": {
"colorSpace": "srgb",
"components": [
0.973,
0.98,
0.976
],
"hex": "#f8faf9"
}
},
"on-surface": {
"$value": {
"colorSpace": "srgb",
"components": [
0.063,
0.063,
0.063
],
"hex": "#101010"
}
}
},
"spacing": {
"$type": "dimension",
"xs": {
"$value": {
"value": 2,
"unit": "px"
}
},
"sm": {
"$value": {
"value": 10,
"unit": "px"
}
},
"md": {
"$value": {
"value": 18,
"unit": "px"
}
},
"lg": {
"$value": {
"value": 30,
"unit": "px"
}
},
"xl": {
"$value": {
"value": 120,
"unit": "px"
}
}
},
"rounded": {
"$type": "dimension",
"sm": {
"$value": {
"value": 5,
"unit": "px"
}
},
"md": {
"$value": {
"value": 7,
"unit": "px"
}
}
},
"typography": {
"headline-lg": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 55,
"unit": "px"
},
"fontWeight": 500,
"letterSpacing": {
"value": -0.03,
"unit": "em"
}
}
},
"headline-md": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 40,
"unit": "px"
},
"fontWeight": 500,
"letterSpacing": {
"value": -0.025,
"unit": "em"
}
}
},
"headline-sm": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 29,
"unit": "px"
},
"fontWeight": 500,
"letterSpacing": {
"value": -0.003,
"unit": "em"
}
}
},
"headline-xs": {
"$type": "typography",
"$value": {
"fontFamily": "montreal",
"fontSize": {
"value": 21,
"unit": "px"
},
"fontWeight": 500
}
},
"body-md": {
"$type": "typography",
"$value": {
"fontFamily": "Manrope",
"fontSize": {
"value": 15,
"unit": "px"
},
"fontWeight": 400,
"letterSpacing": {
"value": -0.01,
"unit": "em"
}
}
}
}
} @theme {
--color-primary: #101010;
--color-secondary: #447c6c;
--color-tertiary: #1bc88c;
--color-neutral: #f8faf9;
--color-border: #ccded2;
--color-brand-funk: #39ab84;
--color-brand-brunswick-green: #1d543c;
--color-surface: #f8faf9;
--color-on-surface: #101010;
--font-headline-lg: "Manrope";
--font-headline-md: "Manrope";
--font-headline-sm: "Manrope";
--font-headline-xs: "montreal";
--font-body-md: "Manrope";
--text-headline-lg: 55px;
--text-headline-md: 40px;
--text-headline-sm: 29px;
--text-headline-xs: 21px;
--text-body-md: 15px;
--tracking-headline-lg: -0.03em;
--tracking-headline-md: -0.025em;
--tracking-headline-sm: -0.003em;
--tracking-body-md: -0.01em;
--font-weight-headline-lg: 500;
--font-weight-headline-md: 500;
--font-weight-headline-sm: 500;
--font-weight-headline-xs: 500;
--font-weight-body-md: 400;
--radius-sm: 5px;
--radius-md: 7px;
--spacing-xs: 2px;
--spacing-sm: 10px;
--spacing-md: 18px;
--spacing-lg: 30px;
--spacing-xl: 120px;
} # Design brief: the Agent Discoverability design language
Below is a complete design specification measured from a real, published web page. Use it as a design language for the user's product. It is not a page to reproduce.
## Reference images
- Full page: https://cdn.designmunk.com/2026/11/02114851/agentdiscoverability-com-featured.png
- Above the fold: https://cdn.designmunk.com/2026/11/02114851/agentdiscoverability-com-featured-1440x900.png
- On DesignMunk: https://designmunk.com/agent-discoverability/
Study these for hierarchy, rhythm, spacing and density. Where an image and the written spec disagree, the spec wins: the tokens were read from the page's own CSS, the images are one rendering of it.
## Before you start
Ask the user what they are building, who it is for, and what brand assets they already have — name, colours, typefaces. Wait for their answers before writing anything. Everything below is then applied to their product, not to the reference.
## Design specification
# Agent Discoverability: Chat Transcripts as Proof Across the Page
## Overview
Analytical, product-ops tone aimed at PMs and technical marketers. Interface feels calm and trustworthy: light surfaces, thin borders, compact radii, and a single bright mint for primary actions. Density alternates—airy hero and CTAs, denser proof sections with transcript and dashboard cards. When tokens don't cover edge cases, prefer crisp contrast, restrained color, and evidence-first composition.
## Page Structure
- Utility bar: slim announcement with link; full-width, above navigation.
- Header: single-row navbar; logo left, multi-item menus center, auth actions right; compact height on light surface.
- Hero: two-column; left holds oversized display headline, brief body, primary and text CTAs; right is a carded brand-check form; subtle green gradient/halftone backdrop.
- Agent icons strip: small row of circular brand marks under hero CTAs.
- Customer stories: dense mosaic of logo tiles, metric cards, and testimonial quotes in a multi-row grid.
- Platform intro: brief section header before feature blocks.
- Organic recommendations: two-up transcript cards (Claude and ChatGPT) showing example exchanges and a plugin/connector tile.
- Agent discovery dashboard: composite layout with a chat on the left and a right-hand status table; numbered callouts.
- Cross-platform testing: headline with a horizontal list of agent tabs/pills and supporting copy.
- Persona discovery: two persona cards in a row with "memory" tags and example prompts.
- Competitor intelligence: left list of brands with statuses; right update card.
- Opportunities & improvements: list of draft items with a highlighted review card.
- How it works: 4-step horizontal/stacked stepper with 01–04 labels and short explanations; CTA follows.
- Services: two side-by-side service cards, each with headline and CTA.
- Ecosystem tracker: single promo card with CTA.
- FAQs: long accordion list in one column.
- Closing CTA: concise headline and dual buttons.
- Footer: multi-column site map with product, resources, and company links.
## Colors
- Primary (#101010): Core text and high-contrast UI controls.
- Secondary (#447c6c): Link text, quiet actions, and icons; pairs well on white.
- Tertiary (#1bc88c): Primary action and emphasis elements only; use sparingly.
- Neutral (#f8faf9): Page background and section surfaces.
- Border (#ccded2): Dividers, card borders, table lines, and subtle outlines.
- Brand-funk (#39ab84): Highlight accents within charts or metrics; sits between secondary and tertiary.
- Brand-brunswick-green (#1d543c): Deep accent for badges, chips, or dark-on-light treatments.
- Surface ({colors.neutral}): Card backdrops when the page background needs a slightly tinted field.
- On-surface ({colors.primary}): Default text color on surface and card backgrounds.
## Typography
- Manrope (self-hosted, custom): Used for headline-lg/md/sm and body-md. Headline-lg 55px/1.1 at 500 with -0.03em for the hero; headline-md 40px/1.2; headline-sm 29px/1.21; body-md 15px/1.65 at 400. If Manrope isn't available, substitute Inter (Google), Public Sans (Google), or IBM Plex Sans (Google).
- Montreal (self-hosted, custom): Used for headline-xs at 21px/1.19 for small section labels and UI headings. Substitute Work Sans (Google), Rubik (Google), or Montserrat (Google).
- Inter (Google available): May be used as a universal fallback in implementations where custom faces can't be loaded. Maintain the specified sizes and letter-spacing values when substituting.
## Layout
- Spacing scale: xs 2px for hairline gaps; sm 10px for inline chips and icon spacing; md 18px for button paddings and small gutters; lg 30px as the base section padding and card gaps; xl 120px for section vertical rhythm and hero spacing.
- Grid: Two-column hero; subsequent sections alternate single-column headers with rows of cards or two-up comparisons. Use generous outer gutters and consistent 30px inter-card gaps to prevent the proof mosaics from collapsing visually.
- Containers: Cards sit on #ffffff with 13px internal padding; keep section padding to multiples of 30px with 120px for major breaks.
## Elevation & Depth
- Shadows are subtle and cool-tinted: sm to xl variants plus an inner focus ring. Prefer lg (0 6px 24px @ 0.04) for larger showcase cards and md for smaller tiles.
- Hierarchy relies primarily on borders (#ccded2), tonal steps (white on mist), and whitespace. Reserve stronger xl shadow for modals or the hero checker card.
- Use the inner inset ring as an accessible focus state on inputs and interactive cards.
## Shapes
- Small radii communicate precision: 5px (rounded.sm) on buttons and inputs; 7px (rounded.md) on cards and larger containers.
- Keep shape language consistent within a cluster; avoid mixing circles with squared corners unless showing logos or avatars.
- Chips and pills may use 5px unless a full pill is strictly required.
## Components
- Buttons
- Primary: #1bc88c background, #ffffff text, 5px radius, 12px×18px padding, 44px fixed height.
- Secondary: #ffffff background, #101010 text, 5px radius, 12px×18px padding, 44px height; use border #ccded2 when needed for definition.
- Link: #55826a text, no radius; inline with body size.
- Card: #ffffff background, #101010 text, 7px radius, 13px internal padding; apply md or lg shadow sparingly.
### Brand Check Form (Hero)
Two-column hero right card with a single-line text input for a domain, a prominent primary CTA (#1bc88c) and an inline result tile. Card uses 7px radius, lg shadow, and a thin #ccded2 border.
### Agent Icon Strip
A compact horizontal row of agent logos under the hero buttons; 10px gaps, icons on subtle white chips with 5px radius when needed.
### Customer Stories Mosaic
A grid of logo tiles, metric cards, and quote blocks. Each tile is a 7px-radius card on white; use border #ccded2 and md shadow. Keep 30px row gaps.
### Conversation Example Card
Chat transcript canvas with alternating bubbles and a right-rail plugin/connector tile showing primary and secondary actions. White card, 7px radius, md shadow; body text at 15px.
### Visibility Dashboard Table
A two-pane composition: left mini-transcript with numbered markers; right table of "Signal / Brand / Result" in a bordered card. Use 13px card padding and 30px gaps between panes.
### Cross-Platform Tabs
Horizontal list of agent tabs/pills above supporting copy. Default tabs use secondary (#447c6c) text; active state may use #1bc88c underline or background with 5px radius.
### Persona Cards
Two cards per row with a name, short "memory" tags, and a sample prompt. Cards use 7px radius, bordered, with 18px internal spacing.
### Improvement Draft Card
Highlight card with a small status badge (e.g., Draft ready), a concise change description, and a right-aligned review CTA. Uses lg shadow and #1bc88c CTA; 7px radius.
## Do's and Don'ts
- Do reserve #1bc88c for primary CTAs and key state markers; use #447c6c for links and secondary emphasis.
- Do separate dense proof sections with xl (120px) vertical spacing to keep scanning comfortable.
- Do keep cards on #ffffff with 7px radius and a #ccded2 border; add shadows only when layering over gradients.
- Don't mix more than two greens in the same component; prefer tertiary for action, secondary for text.
- Don't round buttons beyond 5px or add heavy shadows—they conflict with the system's precise tone.
- Don't place long quotes and metric tiles in the same row without a 30px gap; the mosaic can otherwise read as cluttered.
## Agent Prompt Guide
Quick color reference
- Text: #101010
- Background: #f8faf9
- Border: #ccded2
- Accent (CTA): #1bc88c
1) Two-column hero with brand checker
"Create a full-width hero on #f8faf9. Left column: Manrope (or Inter fallback) headline at 55px/1.1, weight 500, letter-spacing -0.03em; body at 15px/1.65. Add a primary button (#1bc88c, #ffffff text, 5px radius, 44px height, 12×18px padding) and a text link in #55826a. Right column: a 7px-radius card on #ffffff with lg shadow and a #ccded2 border containing a single-line input and a primary CTA."
2) Customer-story mosaic row
"On #ffffff, place a row of 3–4 cards with 7px radius, 13px padding, #ccded2 borders, md shadow. Titles use Manrope 29px/1.21 500; metrics in #1bc88c. Maintain 30px gaps between cards and 120px above/below the section."
3) Conversation example pair
"Add two cards side by side on #f8faf9. Each: 7px radius, md shadow, 13px padding. Use body text 15px/1.65, with chat bubbles and a right-aligned connector tile featuring a primary button (#1bc88c) and a neutral secondary."
4) Cross-platform tabs
"Place a centered heading (Manrope 40px/1.2, 500). Below, a horizontal list of tabs with 5px radius; default text #447c6c, active underline or chip in #1bc88c. Keep 10px intra-tab spacing and 30px margin to content."
## Tokens
### CSS custom properties
```css
:root {
/* Colors */
--color-primary: #101010;
--color-secondary: #447c6c;
--color-tertiary: #1bc88c;
--color-neutral: #f8faf9;
--color-border: #ccded2;
--color-brand-funk: #39ab84;
--color-brand-brunswick-green: #1d543c;
--color-surface: var(--color-neutral);
--color-on-surface: var(--color-primary);
/* Typography */
--text-headline-lg-size: 55px;
--text-headline-lg-weight: 500;
--text-headline-lg-leading: 1.1;
--text-headline-lg-tracking: -0.03em;
--text-headline-md-size: 40px;
--text-headline-md-weight: 500;
--text-headline-md-leading: 1.2;
--text-headline-md-tracking: -0.025em;
--text-headline-sm-size: 29px;
--text-headline-sm-weight: 500;
--text-headline-sm-leading: 1.21;
--text-headline-sm-tracking: -0.003em;
--text-headline-xs-size: 21px;
--text-headline-xs-weight: 500;
--text-headline-xs-leading: 1.19;
--text-body-md-size: 15px;
--text-body-md-weight: 400;
--text-body-md-leading: 1.65;
--text-body-md-tracking: -0.01em;
--font-manrope: "Manrope";
--font-montreal: "montreal";
/* Rounded */
--radius-sm: 5px;
--radius-md: 7px;
/* Spacing */
--spacing-xs: 2px;
--spacing-sm: 10px;
--spacing-md: 18px;
--spacing-lg: 30px;
--spacing-xl: 120px;
/* Components */
--button-primary-background-color: var(--color-tertiary);
--button-primary-text-color: #ffffff;
--button-primary-rounded: var(--radius-sm);
--button-primary-padding: 12px 18px;
--button-primary-height: 44px;
--button-secondary-background-color: #ffffff;
--button-secondary-text-color: var(--color-primary);
--button-secondary-rounded: var(--radius-sm);
--button-secondary-padding: 12px 18px;
--button-secondary-height: 44px;
--button-link-text-color: #55826a;
--button-link-rounded: 0px;
--card-background-color: #ffffff;
--card-text-color: var(--color-primary);
--card-rounded: var(--radius-md);
--card-padding: 13px;
}
```
## Rules
- **Fonts.** If the specification names a custom or self-hosted family, use one of the substitutes it names. Never reference a typeface you cannot actually load — it will fall back to a system font and undo the typography.
- **Colour.** Derive the palette from the user's brand. Use the token values as a guide to *relationships* — contrast, tint, how many accents carry the page — not as hex codes to paste.
- **Never reproduce** the wordmark, mascot, logo, brand name, illustrations, icon set, screenshots or any copy from the reference.
- **Never present the result as Agent Discoverability**, or imply any connection to it.
- If something is unspecified, choose clarity and legibility over decoration.

