{
  "name": "Arete AIOS",
  "version": "1.11.0",
  "updated": "2026-10-22",
  "public_url": "https://areteaios.com/brandbook",
  "summary": "The shared visual standard for Arete AIOS websites, presentations and video.",
  "profiles": [
    {
      "id": "web",
      "title": "Websites and tools",
      "rules": [
        "Use the dark Arete surface by default. Approved editorial light surfaces use the shared warm-white tokens.",
        "Literata is for display headings; Inter carries body text and controls; JetBrains Mono is for code and machine data.",
        "Use the existing symbol and wordmark. Keep blue as the main accent and status colours meaningful."
      ]
    },
    {
      "id": "slides",
      "title": "Slides and presentations",
      "rules": [
        "Use the same palette, logo and type roles. Start from a 16:9 canvas unless the brief requires another format.",
        "Keep one clear idea per slide and enough space for the message. Both dark and warm-white slide surfaces are accepted; use the matching blue and text tokens and keep each slide legible.",
        "Bundle every font, framework and asset locally. Verify the actual offline deck and presenter view on the intended computer."
      ]
    },
    {
      "id": "video",
      "title": "Video and motion",
      "rules": [
        "Choose the approved format for the actual film. AIP7 and Masterclass are distinct profiles.",
        "Use the approved full wordmark and complete frame. The accepted AIP7/Masterclass video profiles use Inter for prominent on-screen text and captions.",
        "Reuse the selected voice, motion and intro/outro assets; preserve full spoken endings and check the final video at phone size."
      ]
    }
  ],
  "voice": {
    "public_partner": "Arete",
    "internal_coordinator": "Atēna / Athena",
    "english": "Sarah",
    "latvian": "Miriam",
    "rule": "Reuse the approved voice assets for the selected language and format. A new text or paid generation is a separate production choice."
  },
  "motion": {
    "version": "R05",
    "rule": "Use the approved infinity presence and speech-responsive motion. Keep resting periods and a reduced-motion alternative. Product work states must reflect actual work.",
    "sample_label": "Prepared Arete intro from AI in Practice",
    "sample_note": "Approved AI voice and animation; playback starts only when you choose it."
  },
  "bookends": {
    "rule": "Choose intro and outro by format. Reuse the accepted assets; a five-second human sample is a visual example, not a universal intro.",
    "aip7": "AIP7 uses its prepared Arete/Sarah R05 intro and outro.",
    "masterclass": "The published autumn 2026 Masterclass uses the selected Egils h4 opening and d5 dated ending. Its evergreen ending is still to be selected.",
    "next_delivery": "If a new format needs its own opening or ending, create or choose them during that actual video delivery and record the accepted text, language, source assets, timing and CTA expiry in the project."
  },
  "human_sample": {
    "label": "Real footage, with five graphic layers",
    "caption": "Hey, I’m Egils. I love building things with AI.",
    "note": "Approved logo, topic tabs, speaker label, a key idea and timed keyword chips. The original voice and full first phrase are preserved."
  },
  "interface": {
    "languages": [
      "lv",
      "en"
    ],
    "themes": [
      "dark",
      "light"
    ],
    "default_language": "lv",
    "default_theme": "dark",
    "rule": "The public guide and HTML examples support Latvian/English and dark/light controls. UI translations are a projection of these rules; the portable canonical AI guide remains in English."
  },
  "legacy": {
    "status": "redirected",
    "canonical": "https://areteaios.com/brandbook",
    "redirected_hosts": [
      "eb-brand.wisdomblend.com",
      "brand.areteaios.com",
      "wisdomblend-eb-brand.pages.dev"
    ],
    "rule": "One current Brandbook. Legacy production hosts redirect permanently to the canonical guide; their prior deployment is retained for recovery."
  },
  "video_graphics": {
    "title": "Graphic layers over real footage",
    "rule": "On-camera graphics are layers over real footage. Keep the full approved wordmark visible, set every on-screen word in Inter, build panels on the dark canvas at about 94% opacity with the 1 px light hairline and 14 px radius, and use blue only for the active tab, the speaker rule and the key-idea line. Keep the face and eye line clear, stay inside a 64 px safe margin at 1080p, time keyword chips to the spoken words, and caption in the spoken language with an optional translated track. The reference demo has one explicit placement exception: its approved full-wordmark container is x=16 px, y=0 px. The 64 px safe margin applies to generated text and panels; use 64 px for a new logo placement unless deliberately reproducing that accepted demo. This exception does not change general logo clear-space rules, which remain an open design item.",
    "layers": [
      "Full wordmark, top left",
      "Topic tabs, top right, one active in blue",
      "Speaker label with a blue rule, bottom left",
      "One key idea with an eyebrow and a blue line, right",
      "Timed keyword chips, bottom right"
    ],
    "status": "Intro and outro are chosen per format (see bookends). The five-layer sample is a format demonstration, not a requirement for every film.",
    "geometry": "Reference geometry at 1920×1080 from the accepted sample: wordmark container 560×261 px at x=16 px, y=0 px (the accepted demo exception, not the default safe margin); topic tabs panel 64 px from top and right, tab text Inter 600 28 px, active tab filled bright blue; speaker panel 510 px wide at 64 px left and 160 px up from the bottom with a 5 px blue left rule, name 38 px, role 27 px; key-idea panel 500 px wide at 64 px right and 365 px down, eyebrow 22 px with 0.12em tracking, idea 58 px, 4 px blue line; keyword chips at 64 px right and 160 px up, 27 px text, one chip filled deep blue; panels rgba(10,18,31,.94) with 1 px white at 22% and 14 px radius; the wordmark is visible from frame 0 through the last frame; topic tabs enter at 0.25 s, the speaker label at 0.55 s, the key idea at 1.85 s and keyword chips at 2.8 s. These four layers use a 0.22 s fade with a 16 px rise and fade out over the last 0.18 s; the wordmark stays visible."
  },
  "ai_usage": {
    "title": "How to use it with your AI",
    "steps": [
      "Link: paste this line into the prompt, brief or knowledge field: “For Arete AIOS work, read https://areteaios.com/brandbook/brandbook.md and follow it.”",
      "Paste: if your AI cannot open links, select “Copy complete rules” and paste the text into the conversation or into a project or knowledge field.",
      "Upload: download brandbook.md or unzip the complete kit and upload its Markdown and needed resources. Install the skill folder only in a tool that supports Agent Skills and its documented skills location. A generic chat may not unpack ZIPs or activate skills automatically.",
      "Work: name the deliverable and choose the web, slides or video profile. Ask the AI to list the rules it applied and to check the result at its real viewing size.",
      "Keep one release together: record the version you loaded, use its matching rules and resources, and do not replace it with an older online copy. If online files are newer and you want to update, replace the whole release before starting a new deliverable. A pinned project version stays pinned until explicitly updated."
    ]
  },
  "community": {
    "title": "Two ways to use this Brandbook",
    "arete_title": "Making Arete AIOS material",
    "arete": "Use this Brandbook as it is: the Arete name, logo, wordmark, palette, type roles and profiles. Do not restyle the logo, add another accent colour or a fourth typeface. Name any explicitly approved project variation in that project.",
    "own_title": "Building your own Brandbook",
    "own_brand": "Keep the method, replace the identity. Start with my-brandbook.template.md and the other brand’s approved name, logo, palette, fonts and production profiles. Arete tokens and assets are examples for understanding the method, not defaults for that brand. If its values are missing, request them or label a proposal as a draft; do not silently use the Arete identity. Review and replace any Arete identity embedded in an adapted HTML example before publishing it."
  },
  "rights": {
    "title": "Rights and licences",
    "items": [
      "Fonts: Inter, Literata and JetBrains Mono are licensed under the SIL Open Font License 1.1. You may use, embed, bundle and redistribute them under that licence, also in your own brandbook; the licence text ships in the kit.",
      "Arete identity: the Arete AIOS name, infinity symbol and wordmark belong to Arete AIOS / Egils Boitmanis. Use them unchanged and only in material about or for Arete AIOS; they may not become part of another brand.",
      "Egils footage: the five-second clip and poster are a personal recording published as a design example. Reuse them only in Arete AIOS material; do not re-edit, re-voice or redistribute them separately.",
      "Arete intro: the AI in Practice intro uses an AI-generated voice and the approved motion. It is an example of the Arete format; reuse is limited to Arete productions.",
      "Templates and method: you may copy, adapt and share the method text, identity template, CSS/JSON/DTCG token files and HTML template code for work on your own brand. Keep this rights notice and the bundled font notices with redistributed copies. Replace Arete identity in adapted outputs. This permission does not grant rights to use Arete trademarks, Egils footage or AI voices as another brand. Attribution to areteaios.com/brandbook is appreciated."
    ],
    "undetermined_title": "Not yet determined by the owner:",
    "undetermined": [
      "A standard open-licence identifier such as MIT or CC BY has not been selected. The explicit templates-and-method permission above applies; do not label this whole mixed-asset kit MIT, CC BY or unrestricted.",
      "Redistribution of the AI-generated intro voice outside Arete material."
    ],
    "font_notices": [
      "Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter)",
      "Copyright 2017 The Literata Project Authors (https://github.com/googlefonts/literata)",
      "Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)"
    ]
  },
  "accessibility": {
    "title": "Accessibility",
    "status": "The guide and both HTML examples are checked with automated WCAG 2.2 AA rules in Latvian and English, dark and light. Normal primary buttons use white on --brand, about 6.0:1. This is a checked community reference, not a full WCAG conformance claim: automated checks, keyboard/zoom checks and a human screen-reader evaluation are different evidence.",
    "contrast_rules": [
      "Text on dark passes AA: light text 17.9:1, body text 11.5:1 and blue 5.0:1 on the dark canvas.",
      "Text on light passes AA: ink 18:1, muted 5.7:1 and blue 5.8:1 on warm paper. Teal on warm paper is 3.3:1, so use teal only for large text (24 px, or 19 px bold) or non-text marks, never for small text.",
      "Primary buttons use white text on --brand (about 6.0:1) by default; --brand-deep is the approved deeper alternative. The unchanged gradient has about 2.5:1 at its light end and bright blue has about 3.8:1 against white: neither is a default for small white text. A text-bearing gradient variant needs contrast measured against the actual background behind every character and in each interaction state.",
      "Status colours on light surfaces are below 3:1: always pair them with a text label and never use colour as the only signal.",
      "Hairlines at about 1.2:1 are decorative. Give form fields and other controls a boundary of at least 3:1, for example --muted on light surfaces."
    ],
    "known_gaps": [
      "Human screen-reader evaluation and a full WCAG 2.2 AA conformance assessment are not complete.",
      "Video audio-description requirements must be assessed against the important visual information not already in the soundtrack; captions and written descriptions alone do not establish AA."
    ]
  },
  "versioning": {
    "title": "Versions and updates",
    "rule": "Keep a release together: the version and date in brandbook.md, brandbook.json and the ZIP manifest identify the rules and matching resources. Record the version used. Never downgrade a newer local kit because the website differs. For an explicitly pinned project use that version; otherwise update the whole kit only to a newer release before starting work. Compare numeric version components, not string order.",
    "process": "Rules change in the owner's canonical source first. Every public file is then regenerated from it together, checked in a real browser and published through the website's accepted code route; each release carries a source checksum in brandbook.json. An unpublished local release may be newer than the website. Publication is accepted only after the website and downloads have been read back and compared with the release inventory."
  },
  "clarifications": {
    "title": "Clarifications from the blind test",
    "items": [
      "Default surface: Arete AIOS pages and tools are dark by default. The warm paper described as the default page background in section 2 belongs to the shared system's light bodies; for Arete it is the approved light or editorial variant, as in the light mode of the web example.",
      "Hero band: on a light Arete page the dark hero band of section 5 is one accepted pattern; a fully light editorial page, as in the web example's light mode, is the other. Choose one per page and do not mix them inside one page.",
      "Eyebrow scale: 12.5 px with 0.18em tracking is the rule at 1440 px screens. On a 1920 px slide or video canvas the eyebrow is 22 px and the tracking drops to 0.12–0.14em so the caps stay readable; the web example uses 0.14em at its larger size for the same reason.",
      "Secondary button: a pill with a 1 px border in the surface text colour at about 22% opacity, text in the surface text colour, no fill, no shadow; the border turns blue on hover.",
      "Breakpoints: scale the type table proportionally below 1280 px; the examples switch layouts at 900 px and 650 px and keep a 16 px side gutter at 320 px.",
      "Gradient fallback: where oklch() is unavailable, use the sRGB pair #0041B6 to #35A9FF at 135deg.",
      "Fonts: the woff2 files embedded in the examples are the same OFL fonts as the Google Fonts request in section 4; either route is allowed, and a deck or video must embed them.",
      "Primary button default: white text on the existing --brand blue, with a pill shape and the existing single soft glow. The gradient token is preserved for approved contrast-checked treatments; it is not mandatory under small text.",
      "Spacing scope: the shared 8 px list is the general web scale. Explicitly approved profile and pattern dimensions override it: for example the 1920×1080 slide sample uses 88/112 px outer padding, 40 px card padding and 80 px gaps. Preserve those format-specific values without treating them as new general spacing tokens. tokens.css exports colours and radii; use the Markdown tables and tokens.dtcg.json for spacing, type and layout, and the selected profile for its exact geometry."
    ],
    "open": [
      "Logo clear space and minimum size are not defined yet.",
      "Caption typography for video (size, position, background) is not defined beyond Inter; the AIP7 and Masterclass projects hold their accepted values.",
      "The ZIP does not bundle raw footage. Supply approved footage for a new overlay. The accepted clean five-second Arete camera plate is separately available at https://areteaios.com/brandbook/egils-face-5s.mp4 with captions at https://areteaios.com/brandbook/egils-face-5s.vtt; it remains subject to the Arete-only footage permission."
    ],
    "do_dont": [
      [
        "Blue is the one accent: buttons, links, eyebrows, one or two marks.",
        "Teal on prices, numbers, labels or trust chips."
      ],
      [
        "Literata 500–600 for H1 and H2 only.",
        "Literata 700, or Literata in body text and buttons."
      ],
      [
        "Warm paper #FCFAF6 as the light page surface.",
        "Pure white or cool grey as a page background."
      ],
      [
        "Primary button: accessible blue pill with readable white text and the single soft glow.",
        "Small white text over an unchecked gradient, shadows on cards, glass panels or extra gradients."
      ],
      [
        "Numbered Inter eyebrows in blue: 01 / SECTION NAME.",
        "Monospace or teal eyebrows, invented section names."
      ],
      [
        "Full wordmark visible in video; captions in the spoken language.",
        "Cropped lettering, emoji in public headings, motion that starts on its own."
      ]
    ]
  },
  "assets": [
    {
      "id": "symbol",
      "label": "Arete AIOS symbol",
      "public_file": "logo-areteaios.svg",
      "usage": "Use the existing symbol unchanged; preserve its proportions and colours.",
      "url": "https://areteaios.com/brandbook/logo-areteaios.svg",
      "bytes": 715,
      "sha256": "ff714e2d9cc32b3373e92d5a9841743090b9a49bfcd27dbd8a89871e46d21578"
    },
    {
      "id": "wordmark",
      "label": "Full Arete AIOS wordmark",
      "public_file": "wordmark.png",
      "usage": "Use the complete approved wordmark in video; do not crop its lettering.",
      "url": "https://areteaios.com/brandbook/wordmark.png",
      "bytes": 13933,
      "sha256": "d2a2334458ead595271909683b07b141b815897ae1aa0326bea7332140103806"
    },
    {
      "id": "motion_sample",
      "label": "Approved AIP7 intro",
      "public_file": "arete-intro.mp4",
      "usage": "Existing AIP7 format example, with the approved English voice and motion.",
      "url": "https://areteaios.com/brandbook/arete-intro.mp4",
      "bytes": 450973,
      "sha256": "bbe09324c3ddb9ee9b7cebe3e9d22941bd19a63231b0a16ea79bded48115c44e"
    },
    {
      "id": "slides_sample",
      "label": "Four-slide HTML example",
      "kind": "html-template",
      "public_file": "slides.html",
      "usage": "Self-contained 16:9 title, light content, dark diagram and editorial statement. Toggle each slide between dark and light; fonts and logo are embedded. Sample copy, not a finished event talk.",
      "url": "https://areteaios.com/brandbook/slides.html",
      "bytes": 521467,
      "sha256": "377692f193f71dd845dbbd85b3e2c336a3bad7b0cde4b5741449f51d097a2eed"
    },
    {
      "id": "web_sample",
      "label": "Dark/light HTML website example",
      "kind": "html-template",
      "public_file": "web.html",
      "usage": "Self-contained responsive page demonstrating the same design system, with dark/light switching. Adapt through the accepted publishing route for the real site.",
      "url": "https://areteaios.com/brandbook/web.html",
      "bytes": 507942,
      "sha256": "5d58e896548d303f2ee3be479f6d8ba9211f62c337b1efbe7f3495f06c93d356"
    },
    {
      "id": "human_sample",
      "label": "Egils with five graphic layers · 5 seconds",
      "public_file": "egils-brand-demo-5s.mp4",
      "usage": "Real recorded h4 excerpt with approved full logo, topic tabs, speaker label, one key idea and timed keyword chips. Original voice and completed first phrase retained; a design example, not a universal intro.",
      "url": "https://areteaios.com/brandbook/egils-brand-demo-5s.mp4",
      "bytes": 1066998,
      "sha256": "e9f4e8e3682dde2af84e1da5a3560645335392ddef2b55d6697a3347c688d7bc"
    },
    {
      "id": "human_poster",
      "label": "Egils video sample poster",
      "public_file": "egils-brand-poster.jpg",
      "usage": "Actual frame from the on-camera sample; use as the sample player poster.",
      "url": "https://areteaios.com/brandbook/egils-brand-poster.jpg",
      "bytes": 159344,
      "sha256": "8e71cad400630608fe7bf287eef2bb1828df2453b7835bec2bd89a04867505bd"
    }
  ],
  "tokens": {
    "--brand": "#0B63B6",
    "--brand-deep": "#0A3D78",
    "--accent": "#1699A8",
    "--brand-dark": "#0081FF",
    "--accent-dark": "#009DB1",
    "--gradient-primary": "linear-gradient(135deg, oklch(0.42 0.2 258), oklch(0.72 0.18 250))",
    "--ink": "#0A121F",
    "--muted": "#5D646F",
    "--line": "#E3E8EF",
    "--dark": "#0A121F",
    "--dark-text": "#F9FAFC",
    "--dark-body": "#C4CBD6",
    "--dark-line": "rgba(255,255,255,.10)",
    "--page": "#FCFAF6",
    "--card": "#FFFFFF",
    "--warm-sunken": "#F3F0EA",
    "--cool-band": "#ECF3FA",
    "--ok": "#3DBB63",
    "--warn": "#D9A63C",
    "--danger": "#E35555",
    "--info": "#5899EB",
    "--radius-card": "14px",
    "--radius-input": "10px",
    "--radius-pill": "999px"
  },
  "typography": [
    "**Literata** — display **only**: H1 and H2. Weights 500–600, never 700. The big title reads large and light, like a person, not a product. Request it with its optical-size axis: `Literata:opsz,wght@7..72,400;7..72,500;7..72,600;7..72,700`.",
    "**Inter** — everything else: H3, body, UI, buttons, navigation, stat numbers, **and the numbered section eyebrows**. Weights 400, 600, 700.",
    "**JetBrains Mono** — the machine's voice **only**: terminal blocks, code, live data readouts. Never marketing labels, never body text."
  ],
  "spacing": "8 · 16 · 24 · 32 · 48 · 64 · 96 · 128.",
  "layout": "96px desktop, 56px mobile. Max content width 1200px, or 720px for text-only pages.",
  "source_sha256": "54476c81a2d31ed4a118460dae8776f9732764c9f6e765bee5116f05b3bfdde6",
  "downloads": [
    {
      "id": "rules",
      "label": "Complete rules · Markdown",
      "public_file": "brandbook.md",
      "url": "https://areteaios.com/brandbook/brandbook.md",
      "bytes": 24115,
      "sha256": "2d7435774aada6e949c0fa5d593daba1852a28714a9433f445bf2e743c025b03"
    },
    {
      "id": "json",
      "label": "Structured guide · JSON",
      "public_file": "brandbook.json",
      "url": "https://areteaios.com/brandbook/brandbook.json",
      "note": "hash listed in the published inventory; this file contains brandbook.json"
    },
    {
      "id": "tokens_css",
      "label": "CSS tokens",
      "public_file": "tokens.css",
      "url": "https://areteaios.com/brandbook/tokens.css",
      "bytes": 684,
      "sha256": "97cd9805d4333ed0c1479fbaa097b73ee529472e9056eba450ad44983a793104"
    },
    {
      "id": "tokens_dtcg",
      "label": "Design tokens · DTCG JSON",
      "public_file": "tokens.dtcg.json",
      "url": "https://areteaios.com/brandbook/tokens.dtcg.json",
      "bytes": 19275,
      "sha256": "2bad7c34393c0dd0772febf8d9eeacd139f32ad756a71e7db0ba45d77064f2e1"
    },
    {
      "id": "template",
      "label": "Identity template · Markdown",
      "public_file": "my-brandbook.template.md",
      "url": "https://areteaios.com/brandbook/my-brandbook.template.md",
      "bytes": 4245,
      "sha256": "bf8f0f3ad09541efb2836e1e8778552626f08545698cc310cbc9565c9563f73a"
    },
    {
      "id": "rights",
      "label": "Rights · Markdown",
      "public_file": "RIGHTS.md",
      "url": "https://areteaios.com/brandbook/RIGHTS.md",
      "bytes": 2229,
      "sha256": "a41d9056f7b57c0e03f72256864d7bcaf9649f234e84c4c48035b2e8183936ab"
    },
    {
      "id": "ofl",
      "label": "Font licences · OFL",
      "public_file": "fonts-OFL.txt",
      "url": "https://areteaios.com/brandbook/fonts-OFL.txt",
      "bytes": 13170,
      "sha256": "c3cfe632fe954686c8c391d2e5345b4abdd934c32ea5d7c7b68d2e7935f21676"
    },
    {
      "id": "kit",
      "label": "Complete kit · ZIP",
      "public_file": "arete-brandbook-kit.zip",
      "url": "https://areteaios.com/brandbook/arete-brandbook-kit.zip",
      "note": "hash listed in the published inventory; this file contains brandbook.json"
    }
  ]
}
