{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"meta": {
"name": "Us and Them",
"domain": "usandthem.work",
"version": "1.0",
"date": "2026-10-31",
"owner": "Us and Them (usandthem.work)",
"faceless": "Faceless for now: no personal names or bylines on public surfaces.",
"language": "en-GB",
"sourceOfTruth": [
"docs/brand/brand-and-style-guide.md (v0.1)",
"site/styles.css"
],
"liftedFrom": {
"site": "https://trolleyproblems.work/",
"checked": "2026-10-31",
"note": "Palette, type pairing, boxed mono labels and isometric diagrams lifted from the live site's styles.css, favicon.svg and og.png. The two trolley GitHub repos use a different palette, so the live site is followed."
},
"relationship": "Sibling of trolleyproblems.work (AI Trolley Experiments). Credit it as a sibling; never present the two as the same product.",
"elaborations": [
"Preferred-term swaps (e.g. users → people) are derived from the guide's “We aren't” column; the guide lists the banned words but not every replacement.",
"Spacing scale is read from site/styles.css values in use (4–44 px); the v0.1 guide does not define a named spacing scale.",
"Radius tokens: 0 for all UI. The logo mark's 6/32 rounded square is the only radius, as built in favicon.svg.",
"Board conventions (bar, footer, accent strip, 6 px frame, 1600×1100 px) are documented from tools/render_boards.py, not from the v0.1 guide.",
"Sample copy and example outputs are written for this document in the guide's voice; they are not published brand lines.",
"File-naming convention generalises the names already used in the repo (kebab-case, prefix by type).",
"The ⌖ crosshair glyph used in figure headers is not in Inter or IBM Plex Mono, so it falls back to a system font and can show as a box on some systems; the guidelines images draw it as a small SVG. Recommendation only: swap the glyph for an inline SVG on the site.",
"The FrameVR intro boards created by the API use Frame's Poppins text-area font (framevr/build_areas.py), not Inter. Treat this as a platform limitation; image boards use Inter and IBM Plex Mono."
],
"openQuestions": [
"Name clearance: “Us and Them” is also the title of a 1973 Pink Floyd song and other works. Check UK IPO / EUIPO marks in classes 41 and 42 before printing.",
"Byline: faceless for now. The bar carries “Us and Them” and the strapline; revisit if a named author is wanted later.",
"Manifesto licence: CC BY 4.0 suggested, not yet confirmed."
],
"companionFiles": [
"usandthem-brand-guidelines.docx",
"usandthem-brand-system-prompt.md"
]
},
"identity": {
"fullName": "Us and Them",
"wordmark": "US & THEM",
"domainLockup": "US & THEM · USANDTHEM.WORK",
"strapline": "A manifesto for working with Autopilots, Agents & Humans.",
"questionLine": "What if there was a better way of working together?",
"framework": "The Shared Floor",
"habitsLine": "Name it. Place it. Bound it. Meter it. Teach it. Share it.",
"bigIdea": "Three tracks, Humans, Agents and Autopilots, run in from different directions and meet on one square shared floor, drawn isometrically like a trolley-problem diagram. No lever, no casualties: everything arrives in the same place and is visible.",
"contrastWithSibling": {
"trolleyProblems": "Pull the lever, or leave it.",
"usAndThem": "Bring it onto the floor, where everyone can see it."
},
"footerLine": "NO AGENTS WERE LEFT UNSUPERVISED IN THE MAKING OF THIS SITE",
"launch": {
"name": "Open Floor",
"date": "2027-04-22",
"display": "Thursday 22 April 2027"
},
"manifesto": [
{
"n": 1,
"line": "There is no “them” without “us”.",
"detail": "Every agent and autopilot exists because a person asked for it. A person stays answerable for it."
},
{
"n": 2,
"line": "If you can’t see it, you can’t trust it.",
"detail": "Every agent has a name, a purpose, an owner and a place you can visit."
},
{
"n": 3,
"line": "Autonomy is earned, not assumed.",
"detail": "Agents start by suggesting. They act alone only when they’ve shown they can, inside a boundary we’ve written down."
},
{
"n": 4,
"line": "Every agent has a meter.",
"detail": "We know what it costs, what it saves and who sees the bill."
},
{
"n": 5,
"line": "Make it visible, then make it fast.",
"detail": "Speed without visibility is how small mistakes become big ones."
},
{
"n": 6,
"line": "Learn together, in the open.",
"detail": "Nobody should learn to work with agents alone in a chat window."
},
{
"n": 7,
"line": "Teach the people before you scale the agents.",
"detail": "Enablement is the first budget line, not the last."
},
{
"n": 8,
"line": "Redesign the work, then add the AI.",
"detail": "Don’t automate a broken process. Fix it, then hand the dull parts to the machines."
},
{
"n": 9,
"line": "Humans keep the judgement calls.",
"detail": "Agents do the steps; people make the decisions that need values, context and care."
},
{
"n": 10,
"line": "Mistakes are shared, not hidden.",
"detail": "When an agent gets it wrong, we say so, fix it and tell everyone what we learned."
},
{
"n": 11,
"line": "Retire what we don’t need.",
"detail": "An agent nobody owns or uses gets switched off. Fewer, better agents beat many forgotten ones."
},
{
"n": 12,
"line": "We’re building this together.",
"detail": "The manifesto is a living document. Anyone can propose a change."
}
],
"habits": [
{
"n": "01",
"name": "Name it",
"question": "What is it, what is it for, and who owns it?",
"theme": "risk"
},
{
"n": "02",
"name": "Place it",
"question": "Where can I see it working?",
"theme": "risk"
},
{
"n": "03",
"name": "Bound it",
"question": "What may it do on its own?",
"theme": "risk"
},
{
"n": "04",
"name": "Meter it",
"question": "What does it cost and what does it return?",
"theme": "cost"
},
{
"n": "05",
"name": "Teach it",
"question": "Do the people around it know how to work with it?",
"theme": "enablement"
},
{
"n": "06",
"name": "Share it",
"question": "What have we learned?",
"theme": "enablement"
}
],
"autonomyLadder": [
{
"level": "A0",
"name": "Assist",
"agentDoes": "Answers when asked"
},
{
"level": "A1",
"name": "Suggest",
"agentDoes": "Proposes actions"
},
{
"level": "A2",
"name": "Act with approval",
"agentDoes": "Prepares and executes after a yes"
},
{
"level": "A3",
"name": "Act and report",
"agentDoes": "Acts inside a boundary, reports after"
},
{
"level": "A4",
"name": "Autopilot",
"agentDoes": "Runs a whole process on a trigger"
}
],
"rooms": [
{
"room": "Front Door",
"habit": "NAME"
},
{
"room": "The Floor",
"habit": "PLACE"
},
{
"room": "Control Room",
"habit": "BOUND"
},
{
"room": "Meter Room",
"habit": "METER"
},
{
"room": "Classroom",
"habit": "TEACH"
},
{
"room": "Assembly",
"habit": "SHARE"
}
],
"tracks": [
{
"track": "Humans",
"colour": "rust"
},
{
"track": "Agents",
"colour": "sky"
},
{
"track": "Autopilots",
"colour": "hl"
}
],
"trackOrderRule": "When naming all three with colour, keep rust (Humans), sky (Agents), highlighter (Autopilots). The strapline reads Autopilots, Agents & Humans."
},
"logo": {
"mark": {
"name": "the floor",
"description": "Rounded square in sky blue with three tracks (rust) meeting at a paper tile; small rust (Humans), agent-blue (Agents) and highlighter (Autopilots) blocks at the track ends.",
"files": [
"site/favicon.svg",
"site/assets/logo-mark.svg"
],
"viewBox": "0 0 32 32",
"cornerRadius": "6 of 32",
"minSizePx": 16,
"dont": [
"Recolour the tracks",
"Rotate the mark",
"Add a shadow"
]
},
"wordmark": {
"text": "US & THEM",
"font": "IBM Plex Mono",
"weight": 600,
"case": "upper",
"letterSpacing": "0.14em",
"ampersand": "On the site the & sits in a highlighter box with a 1 px ink border (.brand .amp).",
"clearSpace": "At least the height of the capital U on all sides.",
"onDark": {
"text": "paper #f3f1ea",
"ampersand": "highlighter #e9f06a allowed"
},
"dont": [
"Set it in Inter",
"Set it in italics",
"Set it in a script face",
"Use “Us & Them” in running text"
]
},
"lockups": [
"Mark + wordmark (masthead)",
"US & THEM · USANDTHEM.WORK (domain lock-up)",
"US & THEM · (FrameVR board bar)"
]
},
"colour": {
"tokens": {
"paper": {
"hex": "#f3f1ea",
"rgb": [
243,
241,
234
],
"name": "Paper",
"role": "Background; the shared floor",
"track": null,
"liftedFrom": "TP --paper",
"usage": "Page and board background. About 70% of any layout.",
"cssVar": "--paper"
},
"card": {
"hex": "#fbfaf6",
"rgb": [
251,
250,
246
],
"name": "Card",
"role": "Cards, buttons, label boxes",
"track": null,
"liftedFrom": "TP button/card fill",
"usage": "Fill for cards, buttons, tables and boxed labels.",
"cssVar": "--card"
},
"ink": {
"hex": "#161616",
"rgb": [
22,
22,
22
],
"name": "Ink",
"role": "Text, rules, outlines, byline bar",
"track": null,
"liftedFrom": "TP --ink",
"usage": "All primary text, borders and the byline bar. About 20%.",
"cssVar": "--ink"
},
"ink-2": {
"hex": "#3a3a3a",
"rgb": [
58,
58,
58
],
"name": "Ink 2",
"role": "Secondary text",
"track": null,
"liftedFrom": "TP --ink-2",
"usage": "Body copy in prose and card descriptions.",
"cssVar": "--ink-2"
},
"muted": {
"hex": "#6c6a63",
"rgb": [
108,
106,
99
],
"name": "Muted",
"role": "Captions, meta, footers",
"track": null,
"liftedFrom": "TP --muted",
"usage": "Captions at 12 px and above only.",
"cssVar": "--muted"
},
"line": {
"hex": "#2b2b2b",
"rgb": [
43,
43,
43
],
"name": "Line",
"role": "1 px rules and borders",
"track": null,
"liftedFrom": "TP --line",
"usage": "Rules, borders and hard button shadows.",
"cssVar": "--line"
},
"sky": {
"hex": "#b7d3f6",
"rgb": [
183,
211,
246
],
"name": "Sky",
"role": "Diagram panels; Agents",
"track": "Agents",
"liftedFrom": "TP --sky",
"usage": "Figure panels and the hero. Not for page backgrounds.",
"cssVar": "--sky"
},
"rust": {
"hex": "#a4472b",
"rgb": [
164,
71,
43
],
"name": "Rust",
"role": "Tracks, focus rings, emphasis; Humans",
"track": "Humans",
"liftedFrom": "TP --rust",
"usage": "Tracks in diagrams, focus rings, risk accents.",
"cssVar": "--rust"
},
"hl": {
"hex": "#e9f06a",
"rgb": [
233,
240,
106
],
"name": "Highlighter",
"role": "Highlighter tags, result headers; Autopilots",
"track": "Autopilots",
"liftedFrom": "TP --hl",
"usage": "One highlighter tag per screen or board at most.",
"cssVar": "--hl"
},
"agent-blue": {
"hex": "#9fb4d8",
"rgb": [
159,
180,
216
],
"name": "Agent blue",
"role": "Agent blocks in diagrams",
"track": null,
"liftedFrom": "TP favicon trolley",
"usage": "Agent blocks in diagrams; cost card top rule. No small text on it.",
"cssVar": "--agent-blue"
},
"amber": {
"hex": "#e9a54a",
"rgb": [
233,
165,
74
],
"name": "Amber",
"role": "Small accents in diagrams only",
"track": null,
"liftedFrom": "TP favicon",
"usage": "Diagram accents only. No text on it.",
"cssVar": "--amber"
},
"tint-sky": {
"hex": "#eef5fe",
"rgb": [
238,
245,
254
],
"name": "Tint sky",
"role": "Soft panel (\"in the real world\")",
"track": null,
"liftedFrom": "TP result block",
"usage": "Callouts and soft panels.",
"cssVar": "--tint-sky"
},
"tint-rust": {
"hex": "#fff3ef",
"rgb": [
255,
243,
239
],
"name": "Tint rust",
"role": "Soft alert panel",
"track": null,
"liftedFrom": "TP taken card",
"usage": "Warning callouts, with a rust border.",
"cssVar": "--tint-rust"
}
},
"proportions": {
"paper": 0.7,
"ink": 0.2,
"accents": 0.1,
"notes": [
"One highlighter tag per screen at most.",
"Sky is for diagrams and the hero panel, not page backgrounds."
]
},
"contrast": [
{
"foreground": "ink",
"background": "paper",
"ratio": 16.0,
"wcag": "AAA",
"use": "Default text"
},
{
"foreground": "ink-2",
"background": "paper",
"ratio": 10.1,
"wcag": "AAA",
"use": "Secondary text"
},
{
"foreground": "muted",
"background": "paper",
"ratio": 4.8,
"wcag": "AA",
"use": "Captions and meta at 12 px and above only"
},
{
"foreground": "rust",
"background": "paper",
"ratio": 5.3,
"wcag": "AA",
"use": "Emphasis, links, focus ring"
},
{
"foreground": "ink",
"background": "sky",
"ratio": 11.8,
"wcag": "AAA",
"use": "Labels on diagram panels"
},
{
"foreground": "ink",
"background": "hl",
"ratio": 14.8,
"wcag": "AAA",
"use": "Highlighter tags"
},
{
"foreground": "#ffffff",
"background": "rust",
"ratio": 6.0,
"wcag": "AA",
"use": "White text on rust"
},
{
"foreground": "paper",
"background": "ink",
"ratio": 16.0,
"wcag": "AAA",
"use": "Byline bar, wordmark on dark"
},
{
"foreground": "ink",
"background": "card",
"ratio": 17.3,
"wcag": "AAA",
"use": "Cards and buttons"
}
],
"noTextOn": [
"amber",
"agent-blue (at small sizes)"
],
"cardAccents": {
"risk": "rust",
"cost": "agent-blue",
"enablement": "hl"
}
},
"typography": {
"families": {
"sans": {
"name": "Inter",
"stack": "\"Inter\", \"Helvetica Neue\", Arial, system-ui, sans-serif",
"weights": [
400,
500,
700,
800
],
"licence": "SIL Open Font Licence",
"source": "Google Fonts"
},
"mono": {
"name": "IBM Plex Mono",
"stack": "\"IBM Plex Mono\", ui-monospace, SFMono-Regular, Menlo, monospace",
"weights": [
400,
500,
600
],
"licence": "SIL Open Font Licence",
"source": "Google Fonts"
}
},
"googleFontsUrl": "https://fonts.googleapis.com/css2?family=Inter:wght@400;500;700;800&family=IBM+Plex+Mono:wght@400;500;600&display=swap",
"scale": [
{
"role": "display",
"family": "Inter",
"weight": 800,
"size": "clamp(34px, 6vw, 58px)",
"lineHeight": "1.02",
"letterSpacing": "-0.025em",
"case": "sentence",
"notes": "H1 and hero title"
},
{
"role": "h2",
"family": "Inter",
"weight": 800,
"size": "clamp(24px, 3.4vw, 34px)",
"lineHeight": "1.1",
"letterSpacing": "-0.02em",
"case": "sentence",
"notes": "Section headings (site uses clamp(26px,4vw,36px) on home blocks)"
},
{
"role": "h3",
"family": "Inter",
"weight": 700,
"size": "20px",
"lineHeight": null,
"letterSpacing": "-0.01em",
"case": "sentence",
"notes": "Card and sub-section headings"
},
{
"role": "body",
"family": "Inter",
"weight": 400,
"size": "16-17px",
"lineHeight": "1.5",
"letterSpacing": null,
"case": "sentence",
"notes": "Max line length 44em; site base 16.5px"
},
{
"role": "lead",
"family": "Inter",
"weight": 700,
"size": "clamp(19px, 2.6vw, 24px)",
"lineHeight": "1.35",
"letterSpacing": null,
"case": "sentence",
"notes": "Strapline under H1"
},
{
"role": "eyebrow",
"family": "IBM Plex Mono",
"weight": 600,
"size": "11.5px",
"lineHeight": null,
"letterSpacing": "0.16em",
"case": "upper",
"notes": "Above every heading, e.g. FIG 2 · THE SHARED FLOOR"
},
{
"role": "button",
"family": "IBM Plex Mono",
"weight": 600,
"size": "12px",
"lineHeight": null,
"letterSpacing": "0.12em",
"case": "upper",
"notes": "Buttons and highlighter tags"
},
{
"role": "diagram-label",
"family": "IBM Plex Mono",
"weight": 600,
"size": "10.5-11px",
"lineHeight": null,
"letterSpacing": "0.06em",
"case": "upper",
"notes": "Boxed labels with leader lines"
},
{
"role": "wordmark",
"family": "IBM Plex Mono",
"weight": 600,
"size": "12px (masthead)",
"lineHeight": null,
"letterSpacing": "0.14em",
"case": "upper",
"notes": "US & THEM"
},
{
"role": "footer",
"family": "IBM Plex Mono",
"weight": 400,
"size": "11px",
"lineHeight": null,
"letterSpacing": "0.14em",
"case": "upper",
"notes": "Muted dry one-liner"
}
],
"rules": [
"Mono caps for every eyebrow, label, button, tag and footer.",
"Inter for headings and body.",
"Use the same pair for print and slides.",
"No italics for the wordmark."
]
},
"layout": {
"maxWidth": {
"reading": "880px",
"home": "1080px",
"prose": "44em"
},
"gutterPx": {
"desktop": 20,
"mobile": 14
},
"breakpoints": {
"tablet": "860px",
"mobile": "640px"
},
"grid": {
"columns": [
2,
3
],
"gapPx": 16,
"notes": "Hero grid 1fr / 1.15fr, gap 32px; stacks below 860px. Card grids go 3 → 2 → 1."
},
"spacingScalePx": [
4,
6,
8,
10,
12,
14,
16,
18,
20,
24,
28,
32,
40,
44
],
"spacingNote": "Elaboration: values in use in site/styles.css, not a named scale in the guide.",
"radii": {
"ui": 0,
"logoMark": "6/32"
},
"borders": {
"rule": "1px solid ink (--line)",
"button": "1.5px solid ink",
"cardAccentTop": "4px",
"board": "2px rules, 6px frame"
},
"shadows": {
"allowed": "2px 2px 0 ink (hard offset, buttons only)",
"banned": "blurred or soft drop shadows"
},
"pageStructure": [
"Byline bar (ink, mono, 'Us and Them' + strapline; faceless for now)",
"Masthead (wordmark left, mono caps nav right, 1 px rule below)",
"Page head (eyebrow, H1, strap)",
"Sections with top rule and eyebrow",
"Footer (mono caps, muted, dry one-liner)"
]
},
"components": {
"bylineBar": {
"background": "ink",
"text": "#f3f1ea mono 11.5px, 0.06em",
"name": "Us and Them, white, underlined; hover highlighter (no personal names: faceless for now)"
},
"masthead": {
"wordmark": "left",
"nav": "right, mono caps, 12px, 0.14em; current page underlined in ink",
"rule": "1px below"
},
"eyebrow": {
"class": ".eyebrow",
"examples": [
"FIG 2 · THE SHARED FLOOR",
"HABIT 03 · BOUND IT"
]
},
"button": {
"class": ".btn",
"fill": "card",
"border": "1.5px ink",
"shadow": "2px 2px 0 ink",
"pressed": "translate(2px,2px), shadow 0",
"primary": {
"class": ".btn-ink",
"fill": "ink",
"text": "#fbfaf6"
},
"text": "mono 600 12px caps 0.12em"
},
"card": {
"class": ".card",
"fill": "card",
"border": "1px ink",
"radius": 0,
"shadow": "none",
"padding": "18px",
"variants": {
"risk": "4px rust top",
"cost": "4px agent-blue top",
"enable": "4px highlighter top",
"hl": "highlighter fill",
"sky": "tint-sky fill"
}
},
"highlighterTag": {
"class": ".tag",
"fill": "hl",
"border": "1px ink",
"text": "mono caps 12px 0.12em",
"rule": "One per screen; the one thing that matters, e.g. LAUNCH · THURSDAY 22 APRIL 2027"
},
"figurePanel": {
"class": ".fig",
"background": "sky",
"border": "1px ink",
"header": "mono caps bar, corner mark top-left, crosshair ⌖ top-right",
"status": "paper bar at bottom, corner mark bottom-right",
"numbering": "FIG 1, FIG 2 … like a manual"
},
"manifestoList": {
"class": ".manifesto",
"numbering": "01–12 in boxed mono labels",
"layout": "two columns, one on mobile"
},
"autonomyLadder": {
"class": ".ladder",
"rungs": 5,
"lastRung": "highlighter fill"
},
"callout": {
"class": ".callout",
"default": "tint-sky",
"warn": "tint-rust with rust border"
},
"footer": {
"class": ".foot",
"text": "mono caps 11px muted",
"line": "NO AGENTS WERE LEFT UNSUPERVISED IN THE MAKING OF THIS SITE"
},
"focus": "3px rust outline, 2px offset"
},
"imagery": {
"style": "Isometric technical drawings on a sky panel: pale slab (the floor), rust tracks, small blocks for people (rust), agents (agent-blue, ink outline) and autopilots (highlighter). Boxed mono labels with thin leader lines.",
"hero": {
"file": "site/assets/hero-floor.svg",
"title": "FIG 1 · THE SHARED FLOOR",
"status": [
"3 TRACKS · 1 FLOOR",
"0 HIDDEN AGENTS"
],
"generator": "tools/hero_svg.py"
},
"socialCard": {
"file": "site/og.png",
"size": "1200x630"
},
"rules": [
"Number figures like a manual: FIG 1, FIG 2.",
"Agents are blocks, cards or tokens.",
"People are simple figures or named cards; never photos without consent."
],
"banned": [
"Stock photos of robots",
"Glowing brains",
"Blue circuit faces",
"Handshakes with androids",
"Humanoid robots of any kind"
]
},
"framevr": {
"frame": "forza",
"entry": "https://framevr.io/forza#usandthem",
"areaPrefix": "usandthem",
"note": "conference-2 is a separate build; never touch it.",
"boardSizesPx": {
"standard": "1600x1100",
"manifesto": "1600x1300",
"banner": "2400x600"
},
"boardAnatomy": {
"frame": "6px ink border",
"bar": "mark + US & THEM · left, #USANDTHEM-<AREA> right, mono caps 0.16em, 2px rule below",
"accentStrip": "14px under the bar on area boards: sky (Microsoft areas), highlighter (System 1), rust (System 2)",
"body": "eyebrow, Inter 800 heading, Inter body in ink-2",
"footer": "USANDTHEM.WORK left, area URL or dry line right, mono caps, 2px rule above"
},
"rules": [
"Paper boards with ink type.",
"Sky panels for diagrams.",
"One highlighter tag per board.",
"Board text at least 60 pt equivalent, ink on paper.",
"Assets grab-locked and tagged managed-by-builder, usandthem."
],
"files": {
"png": "framevr/assets/*.png (also published at /framevr/)",
"html": "framevr/src/*.html",
"renderer": "tools/render_boards.py"
}
},
"voice": {
"persona": "A practical colleague who has done this before, explains it plainly, and is a bit dry about the hype. Curious, never alarmist. Plain speaking. UK spelling. Writes as “we”, never as a named person.",
"faceless": "Faceless for now: no personal names or bylines on public surfaces.",
"weAre": [
"Plain: “agents need an owner”",
"Honest: “we don’t know yet”",
"Hopeful and practical",
"Specific: “15 minutes, weekly, in the team zone”",
"Sourced: every number linked",
"Inclusive: “us” means everyone at work"
],
"weArent": [
"Jargon: “operationalise agentic accountability frameworks”",
"Certain about the future",
"Doom-laden or utopian",
"Vague: “regular touchpoints”",
"“Studies show…”",
"“Users”, “resources”, “headcount”"
],
"writingRules": [
"Sentences under 25 words where possible. Short paragraphs.",
"Lead with the point. Then the reason. Then the example.",
"One idea per heading.",
"Numbers: figures for 10 and above, words below, except in tables.",
"Currency as £ for UK offers, USD where the source uses it.",
"Dates as “22 April 2027”. Times with a zone, e.g. “13:00 BST”.",
"UK spelling throughout (organisation, colour, licence as a noun, programme).",
"In running text write “Us and Them”; the ampersand only in the wordmark and in “Autopilots, Agents & Humans”."
],
"vocabulary": {
"preferred": [
"people",
"teams",
"agents",
"autopilots",
"the floor",
"owner",
"boundary",
"meter",
"show and tell",
"retire"
],
"banned": [
"synergy",
"unleash",
"revolutionise",
"game-changer",
"digital workforce (unless quoting)",
"the robots are coming"
],
"swaps": [
{
"avoid": "users",
"use": "people"
},
{
"avoid": "resources",
"use": "people / teams"
},
{
"avoid": "headcount",
"use": "people"
},
{
"avoid": "regular touchpoints",
"use": "a named ritual with a time, e.g. “15 minutes, weekly, in the team zone”"
},
{
"avoid": "studies show",
"use": "name and link the source"
},
{
"avoid": "operationalise",
"use": "do / run / set up"
},
{
"avoid": "digital workforce",
"use": "agents and autopilots"
},
{
"avoid": "robot / bot army",
"use": "agents"
}
],
"swapsNote": "Elaboration from the guide's “We aren't” column."
},
"citation": {
"rule": "Every number links to its source (see docs/sources.md, S1–S19). Never invent, extrapolate or round up a statistic. If there is no source, write it as our view or leave it out.",
"markers": [
"[S1] style source tags in mono",
"OUR VIEW tag for opinion"
]
},
"doDont": [
{
"do": "Use the mono eyebrow above every heading",
"dont": "Use Inter for labels or buttons"
},
{
"do": "Keep borders 1 px ink, corners square",
"dont": "Round corners or add soft drop shadows"
},
{
"do": "Use one highlighter tag per screen",
"dont": "Highlight several things at once"
},
{
"do": "Draw agents as blocks or cards",
"dont": "Use humanoid robot imagery"
},
{
"do": "Cite a source for every number",
"dont": "Invent or round up statistics"
},
{
"do": "Say “Humans, Agents & Autopilots” in that colour order: rust, sky, highlighter",
"dont": "Swap the colour roles"
},
{
"do": "Keep copy UK English",
"dont": "Mix US spelling"
},
{
"do": "Credit Trolley Problems as a sibling project",
"dont": "Present the two as the same product"
}
]
},
"accessibility": {
"minBodyPx": 16,
"focusRing": "3px solid rust, 2px offset",
"diagrams": "Every diagram has an aria-label or a text description next to it.",
"motion": "Respect prefers-reduced-motion.",
"frameVR": "Board text at least 60 pt equivalent, high contrast (ink on paper).",
"language": "html lang=en-GB",
"skipLink": "Skip to content link, highlighter on focus",
"standard": "WCAG 2.2 AA"
},
"files": {
"naming": {
"rule": "Elaboration: lower-case kebab-case, prefixed by type.",
"patterns": {
"board": "board-<topic>.png",
"area": "area-<area-slug>.png",
"banner": "banner-<name>.png",
"brandImage": "docs/brand/img/<topic>.png",
"page": "<page>.html",
"blogPost": "blog/<slug>.html",
"doc": "docs/NN-<topic>.md"
}
},
"assets": {
"site/styles.css": "Design tokens and components (source of truth for web)",
"site/favicon.svg": "Logo mark",
"site/assets/logo-mark.svg": "Logo mark",
"site/assets/hero-floor.svg": "FIG 1 hero illustration",
"site/og.png": "Social card 1200×630",
"framevr/assets/*.png": "Banners and boards for FrameVR"
}
}
}