Skip to content

Logo Audit — 8 May 2026

Phase 4a deliverable. Walked every planet (Earth, Guided-as-moon, CMD, Shift, Plain AI, Agentic, Claw) and inventoried every brand mark across every rendering surface. The voice-drift audit's bottom-section scouting notes (8 May) are now superseded by this comprehensive walk — some of those initial calls turned out to be wrong (Plain AI is a speech-bubble, not a "P-square"; Guided has a beautiful purpose-built crescent kit that nothing actually renders).

How to use this doc

  • Phase 4b (logo design) picks up the per-planet verdicts and the family-signal hypothesis test below.
  • Phase 4c (cosmos rail implementation) picks up the Cosmos rail gap section — only 4 of 7 slugs are wired today, all 5 mirror files need expansion to 7 in the same commit.
  • This is a point-in-time capture (8 May 2026, end of day NZST). Re-audit after each material logo change.

Methodology

For each planet I read:

  1. Brand kit on diskpublic/, static/, static/images/ for SVG/WEBP/PNG marks
  2. Masthead/Nav rendering — what the brand link in the header actually shows
  3. Favicon — what <link rel="icon"> points at
  4. OG image / social cards — what og:image references
  5. Cosmos rail icon — how this planet renders in OTHER planets' sibling rails (the 5-mirror planet-icon palette)

And recorded for each:

  • File path(s)
  • Logo type: purpose-built (designed for this planet's identity) / inherited-placeholder (using Earth's lotus or framework default) / missing (nothing rendered)
  • Where it renders (every surface)
  • Family-signal verdict (does it match the unwritten pattern shared by the existing purpose-built marks?)

Verdict summary

# Planet Brand kit on disk Masthead Favicon OG image Cosmos rail Family signal
1 🌍 Earth static/images/logo_agtc_dark_1.webp (lotus) + 2nd variant ✅ Lotus webp 🟡 ☁️ cloud emoji (Hugo OG built per page) ✅ Lotus webp (rendered ON other planets only — Earth filters itself out) 🟡 Soft-emblem — lotus is a brand emblem, not a working interface element. Different category from the other 5 marks.
1a 🌑 Guided ✅ Full kit: public/brand/guided-mark.svg (indigo crescent), -mark-mono.svg, -mark-on-dark.svg, -favicon.svg, -lockup.svg, -lockup-stacked.svg, -apple-touch.svg, -og-image.svg 🔴 Earth's lotus webp (/images/logo_agtc_dark_1.webp — NOT the crescent!) 🔴 Astro framework default (public/favicon.svg is the upside-down "A" Astro placeholder) (presumed default Astro) 🔴 Slug missing from all 5 mirrors — Guided cannot be rendered as a sibling icon today 🟡 Crescent metaphor present (Guided IS Earth's Moon) — but it doesn't function as an interface element. Hypothesis-soft.
2 🪐 CMD brainbar/static/favicon.svg ($_ square, phosphor-on-ink, light/dark adaptive) $_ rendered as text + cmd wordmark ✅ Purpose-built $_ square (Hugo) $_ SVG mirrored across 5 implementations Strong$_ IS the launcher prompt. The brand mark IS a working interface element.
3 🪐 Shift public/favicon.svg (Bloomberg-instrument dial) + inline copy in BaseLayout.astro masthead + inline in og/[slug].astro + inline in og-vertical/[slug].astro ✅ Inline dial SVG (60×60, with breath + needle-sweep animations) + SHIFT wordmark + — THE AI JOB-CHANGE WIRE — strap ✅ Purpose-built dial (32×32, paper bg + red needle) ✅ Dial inline in OG generator ✅ Dial SVG mirrored across 5 implementations Strong — the dial IS the gauge. The pressure-meter IS the planet's metaphor (how much pressure on your role?). Working interface element.
4 🪐 Plain AI Bubble + gradient AI text — defined inline in build-shared.mjs masthead() (not a standalone SVG file). Favicon at public/favicon.svg is a similar but distinct fill-gradient bubble. ✅ Outline speech-bubble + AI gradient + Plain AI wordmark + strap ✅ Purpose-built fill-gradient bubble (Plain AI generates per-card cover SVGs at build time — distinct from masthead mark) ✅ Bubble SVG mirrored across 5 implementations Strong — the speech bubble IS the act of asking AI in plain English. Working interface metaphor for "ask without feeling stupid".
5 🪐 Agentic public/favicon.svg (planet + tilted orbit + cyan dots, dark bg) + a slightly different inline copy in Nav.astro (no bg, no satellite dots) 🟡 Inline 22×22 SVG: small circle + tilted ellipse + centre dot + THE AGENTIC PLANET wordmark 🟡 Generic stroke "planet" mark — no cockpit-register signal (no purpose-built OG yet — verify) 🔴 Slug missing from all 5 mirrors — Agentic cannot render as a sibling icon 🔴 Weak — generic planet-icon-pack-style mark. Doesn't function as anything in the cockpit. Not specific to "agents", "MCP reviews", "vendor honesty". Phase 4b primary target.
6 🪐 Claw public/favicon.svg (Bracket Mark [*] — paper bg + red asterisk) + inline copy in Header.astro (no bg, currentColor brackets, accent asterisk) + reused in OG generator (utils/og-render.ts) ✅ Inline [*] SVG (22×22) + Claw Planet wordmark + reference · v0a · first cut strap ✅ Purpose-built [*] mark (paper bg) ✅ Bracket Mark in OG render 🔴 Slug missing from all 5 mirrors — Claw cannot render as a sibling icon Strong[*] IS the dispute marker (every field note has a dispute link rendered AS the Bracket Mark). Working interface element.
7 MCP Move (no human surface — invisible star) n/a n/a n/a n/a n/a

Headline findings

  1. Five purpose-built marks, two gaps, one inherited-placeholder. Purpose-built: CMD $_, Shift dial, Plain AI bubble, Claw [*], and Guided crescent (kit exists but is not wired anywhere). Gaps: Agentic (generic planet-orbit), Earth (lotus is a soft emblem, not in the same family). Inherited-placeholder: Guided's masthead and favicon both pretend it doesn't have a brand kit.
  2. 🔴 Guided is a major surprise gap. A complete brand kit lives in guided/public/brand/guided-mark.svg (and 7 sister files including OG image, lockup, mono, on-dark) — but Guided's Header.astro masthead renders Earth's lotus webp, and public/favicon.svg is the default Astro framework placeholder (the white-on-black triangular "A"). The crescent kit was designed but never wired in. Phase 4c will need to (a) replace the masthead <img> with the crescent SVG, (b) replace public/favicon.svg with public/brand/guided-favicon.svg, (c) optionally add the wordmark variant.
  3. 🔴 The cosmos rail is wired for 4 slugs only. All 5 mirrors of planet-icon (Hugo Earth, Hugo CMD, Astro Guided, Astro Shift, Plain AI build-shared) handle exactly: earth, brainbar, shift, plainai. The 3 manifest-added slugs — guided, agentic, claw — fall through to the default branch which warns and renders nothing. This means yesterday's manifest expansion gave us data parity but not visual parity: the 7 entries are in the manifest but only 4 will render in any planet's masthead rail today.
  4. 🟡 Plain AI's hardcoded PLAINAI_PLANET_LABELS overrides the manifest. build-shared.mjs:46 has a 3-entry dictionary that overrides p.name with hardcoded labels — including brainbar: 'Brain Bar'. So even though plainai/content/planets.json now says "name": "CMD", the live cosmos chip aria-label still reads Brain Bar — Microsoft jargon decoder. This is a Phase 4c data wiring fix, not a logo fix, but it's caught here because the audit walked every surface.
  5. 🟡 Earth's favicon is a cloud emoji, not the lotus. aguidetocloud-revamp/static/favicon.svg is <text>☁️</text> rendered as SVG — that's the browser-tab favicon. The masthead uses the lotus webp. There's an inconsistency between the tab icon (cloud emoji) and the masthead (lotus brand mark). Not a bug — Earth is the home, can be eclectic — but flag for Sush's call.
  6. 🟢 Voice-drift audit's logo notes were partly inaccurate — superseded by this doc:
    • "Plain AI's P-square gradient" → actually a speech bubble + gradient "AI" text.
    • "Earth's A badge" → actually the lotus webp; there is no "A" badge anywhere.
    • "Guided uses Earth's A" → correct in spirit (uses Earth's lotus, ignores its own crescent kit).

Per-planet detail

1 · 🌍 Earth — aguidetocloud.com

Surface Path / source Rendered as
Masthead aguidetocloud-revamp/layouts/partials/nav.html:5<img src="/images/logo_agtc_dark_1.webp"> 32×32 lotus webp inside circular .site-logo-img-wrap
Favicon aguidetocloud-revamp/static/favicon.svg (<text>☁️</text> cloud emoji) Browser tab cloud emoji
OG image Generated per-page by Hugo (not a single static asset) varies
Cosmos rail (rendered ON other planets) All 5 planet-icon mirrors — branch earth returns <img src="/images/logo_agtc.webp"> (or _dark_1 on Guided) 24×24 circular lotus webp on every sibling planet's rail
Lotus image variants static/images/logo_agtc_dark_1.webp (11.6 KB), logo_agtc_dark_2.webp (9.3 KB)

Logo type: purpose-built (the lotus is the established A Guide to Cloud brand emblem)

Verdict:Cohesive but emblem-class, not interface-class. The lotus is recognisable, soft, on-brand for "patient · giving · hope" — all the Earth values. It does its brand-emblem job perfectly. But it does NOT function as a working UI element on Earth itself (it's not a button, a status indicator, a feature in any tool). That's fine if Earth is the home (homes have crests, not switches) — but it does mean Earth sits in a different category from the 5 purpose-built planet marks. Worth Sush's explicit call.

Sush's verdict input column: - Lotus IS Earth's brand. Should it stay lotus, or get a refined "interface-element" mark to match the family? - Should Earth's favicon move from cloud emoji to lotus to keep tab/masthead consistent?


1a · 🌑 Guided — aguidetocloud.com/guided/ (Earth's Moon)

Surface Path / source Rendered as
Masthead guided/src/components/layout/Header.astro:36<img src="/images/logo_agtc_dark_1.webp"> 🔴 Earth's lotus (NOT the crescent kit)
Favicon guided/public/favicon.svg 🔴 Default Astro framework placeholder (the upside-down triangular "A" from npm create astro)
OG image (presumed default — verify in Phase 4c) (likely Astro default or generic)
Cosmos rail (rendered ON other planets) n/a — slug guided missing from all 5 mirrors 🔴 Renders nothing today — falls through to warning branch
Brand kit on disk guided/public/brand/guided-mark.svg (indigo crescent, 80×80 viewBox, 6366F1) (designed but never used)
Brand kit (full set) guided-favicon.svg (32×32), guided-mark-mono.svg, guided-mark-on-dark.svg, guided-lockup.svg (240×60, "guided" wordmark), guided-lockup-stacked.svg, guided-apple-touch.svg, guided-og-image.svg (1200×630, "practice exams that don't gatekeep" tagline) (all designed, all unused)

Logo type: designed-but-unwired (the crescent kit exists; nothing renders it)

Crescent design notes (read from the SVG): - Mark: <circle cx="40" cy="40" r="32" fill="#6366F1" mask="cut"> where the mask cuts a circle at top-right → creates a crescent moon shape with sharp negative space. - Indigo #6366F1 matches Earth's Zen System accent (the crescent visually says: "I am the Moon of indigo Earth"). - Lockup uses the same crescent + lowercase "guided" wordmark (Inter, weight 600, letter-spacing -0.5). - OG image (1200×630) lays the crescent large left + "guided" wordmark + tagline "practice exams that don't gatekeep." + "$9, not $79. free study guides forever." + URL footer aguidetocloud.com/guided.

Verdict: 🔴 Critical Phase 4c gap. Guided has the most complete brand kit of any planet (8 SVG files vs Earth's 1 webp + 1 emoji favicon) — and absolutely none of it is wired. The masthead silently uses Earth's lotus. The favicon is the framework default (Sush has been shipping the Astro placeholder to production users for months). The crescent design is on-brand (indigo Moon) and on-metaphor (Earth's Moon).

Family signal: 🟡 Crescent is a metaphor mark — it points at "I am the Moon" — but it isn't a working interface element on Guided itself (Guided is study-mode + exam-mode + flashcards; the moon doesn't appear in the UI as a control). If we apply the family-signal hypothesis strictly, the crescent passes on metaphor (Moon-of-Earth) but not on interface-as-mark.

Sush's verdict input column: - Adopt the existing crescent kit as-is for Phase 4c (cheapest, fastest)? - Or refine it to add an interface-element second layer (e.g. a checkmark inside the crescent for "exam passed")? - Or keep crescent purely as a metaphor mark and accept that Guided is "Moon-class, not planet-class" in family-signal terms?


2 · 🪐 CMD — cmd.aguidetocloud.com

Surface Path / source Rendered as
Masthead aguidetocloud-revamp/brainbar/layouts/_default/baseof.html:69<span class="bb-prompt">$_</span><span class="bb-brand-name">cmd</span> Text-rendered $_ (JetBrains Mono, phosphor green) + cmd wordmark — the prompt IS the brand
Favicon brainbar/static/favicon.svg 32×32 phosphor-green $_ on terminal-black square (rx 6); light-mode media query swaps to ivory bg + ink fg
Apple touch brainbar/static/apple-touch-icon.png (referenced in baseof.html:61) (PNG variant)
OG image (Hugo-generated per page — verify) (varies)
Cosmos rail (rendered ON other planets) All 5 planet-icon mirrors — branch brainbar returns <svg>$ <line blink> 24×24 inline $ + animated underscore cursor (SMIL blink)
Theme colour meta name="theme-color" set to #0E1410 (dark) and #D9D1B5 (light) — terminal palette

Logo type: ✅ purpose-built (terminal $_ is the prompt; the prompt is the brand)

Verdict:The exemplar. This is what the family-signal hypothesis was built around. The $_ IS the launcher in the actual UI (the homepage IS a terminal-prompt search). Brand mark = working interface element. Light/dark adaptive favicon. Cosmos rail icon includes a blinking-cursor SMIL animation that nods at the terminal-blink atmosphere.

Sush's verdict input column: Reference standard. No action.


3 · 🪐 Shift — shift.aguidetocloud.com

Surface Path / source Rendered as
Masthead shift/src/layouts/BaseLayout.astro:121-133 → inline 60×60 SVG (dial) + SHIFT wordmark + — THE AI JOB-CHANGE WIRE — strap Animated dial: outer ring + inner ring (60% opacity) + red sweep arc (breath animation, 3s loop) + red needle (sweep ±3° rotation, 4s loop) + centre dot
Favicon shift/public/favicon.svg 32×32 cream-paper bg #F0E9D6 + black ring + red sweep arc + red needle + centre dot — static (no animations in favicon)
OG image shift/src/pages/og/[slug].astro:194 (horizontal) + og-vertical/[slug].astro:215 (vertical) — both inline the same dial SVG at 64×64 dial + SHIFT wordmark on each social card
Cosmos rail (rendered ON other planets) All 5 planet-icon mirrors — branch shift returns the full animated dial SVG 24×24 dial with breath + sweep animations
Theme Newspaper register: cream paper #F8F5EE · orange/red #E25822 accent · Playfair Display

Logo type: ✅ purpose-built (the dial IS the wire's gauge)

Verdict:Strong — second exemplar. The dial is a Bloomberg/instrument-style gauge: it visualises pressure and direction. Shift's whole metaphor is "the wire" + "how much pressure on your role" — the dial is a literal answer to the planet's question, rendered as an icon. SMIL animations (breath + needle sweep) carry the "live signal" feel without being noisy. Mirrored cleanly into the cosmos rail.

Sush's verdict input column: Reference quality. No action.


4 · 🪐 Plain AI — plainai.aguidetocloud.com

Surface Path / source Rendered as
Masthead plainai/build-shared.mjs:135-149 → inline 38×30 SVG (outlined speech bubble + gradient "AI" text inside) + Plain AI (gradient highlight on AI) + strap Speech bubble outline (currentColor stroke) with cyan→purple→pink linear gradient AI text inside
Favicon plainai/public/favicon.svg 64×64 fill-gradient speech bubble (cyan→purple→pink) + white AI text — distinct from masthead (filled, not outlined)
Per-card OG build.mjs:211 — generated per topic with rotating gradient palettes + decorative blur shapes Each topic gets a unique gradient cover (no brand mark on covers)
Cosmos rail (rendered ON other planets) All 5 planet-icon mirrors — branch plainai returns the outlined-bubble + gradient AI SVG (intrinsic 38×30) Bubble at 30×24 to fit the 24px row
Theme colour #0B0D14 charcoal dark default · #67E8F9 cyan accent

Logo type: ✅ purpose-built (speech bubble = "ask AI without feeling stupid" — the planet's whole proposition)

Verdict:Strong — third exemplar. The bubble is a chat-thread / conversation marker; Plain AI's mission is "your mum can ask without feeling stupid". The mark is the interaction. Cyan→purple→pink gradient is Plain AI's signature palette (every topic cover uses the same family). Note: favicon (fill) and masthead (outline) are slightly different treatments — both legitimate, but a Phase 4c sub-fix could harmonise them.

Sush's verdict input column: - Keep favicon-fill vs masthead-outline split, or unify on one treatment? - The voice-drift doc mistakenly called this a "P-square" — proposed correction: rename the family-signal tagline from "P-square gradient" to "speech-bubble gradient".


5 · 🪐 Agentic — agents.aguidetocloud.com

Surface Path / source Rendered as
Masthead agentic-planet/src/components/Nav.astro:31-37 → inline 22×22 SVG: <circle r=4> + <ellipse rx=10 ry=4 rotate=-25> + centre dot Stroke-line planet + tilted orbit + centre dot — generic
Favicon agentic-planet/public/favicon.svg 32×32 dark #0A0E14 bg + same planet+orbit (slightly thicker stroke) + 2 small cyan dots flanking (satellites?)
OG image (no purpose-built OG visible — verify in Phase 4c) (likely default)
Cosmos rail (rendered ON other planets) 🔴 Slug agentic missing from all 5 planet-icon mirrors 🔴 Renders nothing
Theme colour #07090E ink · cyan/green/amber/red/magenta signal palette · JetBrains Mono

Logo type: 🔴 inherited-placeholder-class (generic planet+orbit from a stroke-icon set)

Verdict: 🔴 Phase 4b primary target. The current mark is a generic "planet with an orbit" icon — the kind of thing in any open icon library. It does not signal: - Agents (no agent-shape, no signal-flow, no MCP plug, no decision-tree) - Cockpit register (no instrument, no status LED, no sweep, no gauge) - Honest-take editorial slant (no marker, no scorecard, no flag) - Field-guide-by-engineer-who-deploys-this (no working-interface element)

Compare to Shift's dial: same cockpit-adjacent atmosphere, but Shift's mark IS the gauge. Agentic's mark is ABOUT a planet — meta — and doesn't carry the cockpit metaphor it claims in its register.

Sush's verdict input column: This is where the family-signal investment will pay off. Candidate Phase 4b directions: - A signal/throttle/gauge (cockpit-instrument family with Shift) - An MCP plug shape (literal: the M glyph or a connector) - A decision-tree node / branch (literal: agents make decisions) - A status LED (cockpit register; could blink like CMD's underscore) - A vendor scorecard tally mark (editorial slant)

Recommended: a small status/signal element that earns "cockpit" the way $_ earns "terminal".


6 · 🪐 Claw — claw.aguidetocloud.com

Surface Path / source Rendered as
Masthead claw-planet/src/components/Header.astro:23-31 → inline 24×24 SVG: two [ ] brackets in var(--ink) + asterisk in var(--claw) (OpenClaw red) The Bracket Mark [*][ ] brackets straddle a centred 5-line asterisk
Favicon claw-planet/public/favicon.svg 32×32 paper-cream bg #F0E9D6 + ink ring (decorative) + red sweep arc + red [*] lines + ink centre dot (slight artistic variant)
OG image claw-planet/src/utils/og-render.ts:99 — Bracket Mark + "Claw Planet" wordmark top-left of OG card OG cards have brand mark + wordmark per page
Cosmos rail (rendered ON other planets) 🔴 Slug claw missing from all 5 planet-icon mirrors 🔴 Renders nothing
Theme OpenClaw red #FF2626 (light) / #FF4747 (dark) · Inter + JetBrains Mono

Logo type: ✅ purpose-built (Bracket Mark [*] — square brackets = annotation; asterisk = footnote/source/dispute)

Verdict:Strong — fourth exemplar. From the colophon: "Square brackets in ink, asterisk in OpenClaw red. Reads as 'footnote · annotation · code reference.'" The Bracket Mark is the dispute-here button in the actual UI — every field note has a "click [*] to disagree" mechanism. Brand mark = working interface element + dispute marker + footnote/source semantic. Reuses across masthead, favicon, OG.

Sush's verdict input column: Reference quality. Slug claw needs adding to 5 cosmos-rail mirrors in Phase 4c.


Cosmos rail gap (the 5-mirror palette)

The cosmos rail's planet-icon palette is mirrored across 5 implementations that must stay byte-equivalent (per cosmos-nav-playbook.md):

# File Slugs handled Default branch
1 aguidetocloud-revamp/layouts/partials/planet-icon.html (Hugo Earth) earth · brainbar · shift · plainai warnf + render nothing
2 aguidetocloud-revamp/brainbar/layouts/partials/planet-icon.html (Hugo CMD) earth · brainbar · shift · plainai warnf + render nothing
3 guided/src/components/layout/PlanetIcon.astro (Astro Guided) earth · brainbar · shift · plainai TypeScript Props.slug is a literal union of those 4 — adding guided/agentic/claw is a type change, not just runtime
4 shift/src/components/PlanetIcon.astro (Astro Shift) earth · brainbar · shift · plainai Same as Guided — typed union of 4
5 plainai/build-shared.mjs planetIcon(slug) (Plain AI) earth · brainbar · shift · plainai console.warn + return empty string

🔴 Conclusion: yesterday's manifest expansion gave us data parity (7 entries everywhere) but not visual parity (4 icons rendered, 3 silent). Phase 4c must:

  1. Land 3 new SVG icons for guided, agentic, claw (Phase 4b designs)
  2. Mirror each new icon into all 5 files in the same commit
  3. Update the typed union in the 2 Astro components from 'earth' | 'brainbar' | 'shift' | 'plainai' to include the 3 new slugs
  4. Update the doc-comment "expected: earth, brainbar, shift, plainai" to the 7-slug list
  5. Verify the cosmos-nav-playbook.md "4-icon shared masthead contract" line — it's now 7-icon

🟡 Plain AI label-override gap (related but distinct): plainai/build-shared.mjs:46 PLAINAI_PLANET_LABELS is a 3-entry hardcoded dictionary (earth, brainbar: 'Brain Bar', shift) that overrides the manifest's p.name. Two consequences: - Live cosmos chip aria-label still reads Brain Bar — Microsoft jargon decoder even though manifest says name: "CMD" - 3 new planets (guided, agentic, claw) fall through to p.name from the manifest — which is good — but brainbar is stuck on legacy text

Phase 4c sub-fix: either delete the PLAINAI_PLANET_LABELS override entirely (let manifest drive everything) or update the brainbar entry to 'CMD'.


Family-signal hypothesis — tested

The voice-drift doc's bottom-section scouting note proposed:

"the brand mark IS a working interface element, not a decoration."

"Family signal candidate: each is a typed character or symbol that's also a UI element on the planet itself ($_ is the launcher, [] is the dispute marker, P is on every plate, dial is the gauge)."*

Result of the audit walk: hypothesis holds for 4 of 5 confirmed purpose-built marks. Detailed test:

Planet Mark Working-interface-element verdict Notes
🪐 CMD $_ ✅ Yes — IS the launcher prompt (homepage = terminal) The exemplar.
🪐 Shift dial ✅ Yes — IS the pressure gauge (the planet's whole question is "how much pressure on your role?") Same family.
🪐 Plain AI speech bubble + gradient AI ✅ Yes — IS the asking interaction (your mum's question becomes a plate) Same family.
🪐 Claw [*] ✅ Yes — IS the dispute marker / footnote / source link (every field note clickable on [*]) Same family.
🌑 Guided crescent moon 🟡 No — moon is a metaphor mark (Earth's Moon), not an interface element. Crescent is not a button or status indicator on Guided's UI. Hypothesis-soft. Phase 4b decision needed: refine to add interface element OR accept "Moon-class" carve-out.
🌍 Earth lotus 🟡 No — lotus is an emblem (brand crest for the home), not an interface element. Hypothesis-soft. Earth is the home; arguably homes get crests, not switches.
🪐 Agentic planet+orbit 🔴 No — and not even metaphor-true to "agents" or "cockpit". Generic stroke-icon-set decoration. Hypothesis-fail. Phase 4b primary target.

Hypothesis verdict:Hold the rule for the 5 planet-class marks. Phase 4b should design Agentic to fit (proposed: cockpit-instrument family — gauge / status LED / signal). Earth and Guided can carry a soft carve-out (Earth = emblem-class as the home; Guided = metaphor-class as the Moon) — OR Phase 4b can refine them too. Sush's call.

Restatement for the Phase 4b brief:

Family-signal rule (proposed for Phase 4b): "Each planet's brand mark is a working interface element from that planet's own UI — the icon is also the button, the gauge, the prompt, the marker, the bubble. The mark answers the planet's question, rendered as a glyph."

Carve-outs allowed: Earth as the home gets an emblem-class mark (lotus); Guided as Earth's Moon gets a metaphor-class mark (crescent). All other planets must satisfy the rule.


Phase 4b inputs (logo design)

Sorted by priority. All targets need Sush's design direction before any SVG work.

Pri Planet Action Status
P0 🪐 Agentic Design a purpose-built cockpit-class brand mark. Replace the generic planet+orbit. TODO Phase 4b
P1 🌑 Guided Decision: adopt existing crescent kit as-is, OR refine to add interface-element layer. TODO Phase 4b — Sush decision
P2 🪐 Plain AI Optional: harmonise favicon (fill bubble) with masthead (outline bubble) — pick one treatment. TODO Phase 4b — minor
P2 🌍 Earth Decision: keep lotus emblem, OR refine. Also: align favicon (cloud emoji) with masthead (lotus). TODO Phase 4b — Sush decision

Phase 4c inputs (cosmos rail implementation)

Sorted by dependency on Phase 4b.

Pri Item Files Status
P0 (depends 4b) Add 3 new icons (guided, agentic, claw) to all 5 cosmos-rail mirrors aguidetocloud-revamp/layouts/partials/planet-icon.html · aguidetocloud-revamp/brainbar/layouts/partials/planet-icon.html · guided/src/components/layout/PlanetIcon.astro · shift/src/components/PlanetIcon.astro · plainai/build-shared.mjs TODO Phase 4c
P0 (depends 4b) Wire Guided's masthead to its own crescent (or refined mark), not Earth's lotus guided/src/components/layout/Header.astro:36 TODO Phase 4c
P0 (depends 4b) Replace guided/public/favicon.svg (Astro default) with public/brand/guided-favicon.svg (or refined) guided/public/favicon.svg TODO Phase 4c
P0 (depends 4b) Update cosmos-nav-playbook.md from "4-icon shared masthead contract" to "7-icon" learning-docs/docs/reference/cosmos-nav-playbook.md TODO Phase 4c
P0 (depends 4b) Replace Agentic's generic mark with refined cockpit-class design agentic-planet/src/components/Nav.astro (inline SVG), agentic-planet/public/favicon.svg, agentic-planet OG generator if any TODO Phase 4c
P1 Update typed union in 2 Astro PlanetIcon.astro from 4-slug to 7-slug guided/src/components/layout/PlanetIcon.astro:31, shift/src/components/PlanetIcon.astro:26 TODO Phase 4c
P1 Resolve Plain AI's PLAINAI_PLANET_LABELS override (delete or update brainbar→CMD) plainai/build-shared.mjs:46 TODO Phase 4c
P1 (optional) Align Earth's favicon with its lotus masthead — replace cloud emoji aguidetocloud-revamp/static/favicon.svg TODO Phase 4c
P2 (optional) Harmonise Plain AI favicon vs masthead bubble treatment plainai/public/favicon.svg (fill) vs masthead (outline) TODO Phase 4c

Re-audit cadence

Re-run this audit:

  • After every Phase 4b logo design landing
  • After Phase 4c implementation
  • Whenever a new planet enters the cosmos (the 8th planet's audit becomes section 8 of this doc)
  • Annually if no other trigger fires

The re-audit is mechanical: walk every planet-icon mirror, every <header> brand link, every <link rel="icon">, every og:image, every brand/ directory. Cross-reference against this doc.


Audit complete: 8 May 2026. Build verified clean (mkdocs build --strict to be run after this doc lands). All file paths above are accurate as of this session. Next session: Phase 4b — logo design with Sush's direction on the 4 P0/P1/P2 calls flagged above. Do NOT skip to Phase 4c without finishing 4b — the rail can't render icons that haven't been designed.**