Skip to main content
Pattern docs

Per-persona OS pattern

BSS's paid personas each get their own bespoke OS surface — distinct layout primitive, accent, typography, density, and panel set. This page documents the pattern and links to every OS's current state.

All persona OSes are live (open any one)

Each is a bespoke build to the depth bar below — distinct layout primitive, accent, density, and panel set. Founder Operator OS is the reference template for the pattern.

  • Founder Operator OS

    Decide what needs attention today: cadence, money signal, customer signal, and the next owner move.

  • Agency Owner OS

    Decide which client needs attention, what is due, and whether capacity can take the next deal.

  • Ops Leader OS

    Decide which process is overdue, who owns it, and what exception needs the first response.

  • Construction Executive OS

    Review project health, crew capacity, vendor execution, and delivery risk before the next job commitment.

  • Sales Director OS

    Decide which lead, account, follow-up, and pricing question deserves attention before pipeline review.

  • Technical Evaluator OS

    Evaluation console — API surface, deterministic outputs, traces, security posture, JSON-first.

  • Economic Buyer OS

    Decide whether the spend clears ROI, risk, contract, and approval gates.

How the pattern works

Every OS reads its visual language from lib/persona-os/scaffold.ts. The shared PersonaOSChrome component renders distinctly per persona because the scaffold drives the colors, gradient, typography classes, density, and keyboard cheatsheet. No two OSes share an accent and a layout primitive (test-enforced).

Files to know

  • lib/persona-os/scaffold.ts — typed schema, scaffold consts, helpers.
  • components/persona-os/PersonaOSChrome.tsx — shell that reads visual language.
  • components/founder-operator-os/* — reference bespoke build.
  • app/<persona>-os/page.tsx — flat route per persona.
  • docs/persona-os.md — full pattern doc + checklist.

Depth bar (per OS)

  1. Route loads with HTTP 200 at https://brainstackstudio.com/<persona>-os.
  2. Live DOM bodyHTMLLength reaches ≥ 100KB (parity with /rep-os).
  3. All scaffold-declared panels render with their data-testid.
  4. Anonymous, free, and paid states all honest + visually distinct.
  5. Side-by-side with other OSes, a stranger calls them "two different products".
  6. Zero fabricated metrics, zero filler copy.

See docs/persona-os.md in the BSS repo for the full step-by-step on building the next OS.