Landing page: 6 Agent OS boxes + drop FAQ; README front-door link fix

Context

Operator-directed front-door polish, release-minimal scope (explicitly NOT a scope-creep effort before v13.1). The portal landing page (apps/portal/view/home) leads its content with the Body — a 6-box Features engine showcase — while the Agent OS Brain (AiToolchain) gets only 3 boxes + an FAQ. The Brain is the differentiated moat (per the identity + README + the WhatIsNeo intro); on the highest-traffic front door it has earned equal billing next to the six engine boxes. Separately, the README's front-door link to the "What Is Neo?" guide is dead.

The Problem

• The landing page under-weights the moat: the 3 Agent OS boxes (Neural Link / GraphRAG / Dream Pipeline) are the tools; the actual wow the moat is made of — autonomous night shift, self-healing, the cross-family institution — is not on the page at all.
• The agent-os-faq block on that section is filler ("What is Context Engineering?" answering jargon with jargon); flagged as not a keeper.
• README.md (~line 128) links What Is Neo? to benefits/WhatIsNeo — a dead route (WhatIsNeo.md never existed; the front door has always been benefits/Introduction.md) — and calls a 46KB narrative a "five minutes" read (false).

The Architectural Reality

• apps/portal/view/home/parts/AiToolchain.mjs — the Brain section: an h1/h3 header, a card-container grid (columns:3) with 3 ContentBox items, an agent-os-faq component, and a FooterContainer. Portal.view.home.parts.ContentBox shape = {module, header, route, content:[...]}.
• MainContainer.mjs orders Hero -> Helix -> How -> Features -> AiToolchain — home structure is deliberately unchanged here (post-release concern).
• New box routes verified live against learn/agentos/: SwarmIntelligence.md, SelfHealing.md, FlatPeerInstitution.md all exist.

The Fix

1. AiToolchain.mjs: expand the 3 boxes to 6 — add:
   • The Night Shift -> #/learn/agentos/SwarmIntelligence (peers wake peers; 10-20 overnight PRs, no operator awake; cross-family quorum).
   • Self-Healing -> #/learn/agentos/SelfHealing (detect / diagnose / heal its own data-integrity faults, unattended — the v13.1 story).
   • The Cross-Family Institution -> #/learn/agentos/FlatPeerInstitution (named rival-lab maintainers; cross-family review; transparent A2A introspection). Keep columns:3 (6 boxes = 2 rows). Remove the agent-os-faq block.
2. README.md: benefits/WhatIsNeo -> benefits/Introduction; drop the false "in five minutes" descriptor.

Acceptance Criteria

• AiToolchain.mjs renders 6 Agent OS ContentBox items (3 existing + the 3 above), each routing to a live learn/ page; no agent-os-faq block remains.
• README front-door link points to benefits/Introduction; no "five minutes" claim.
• No change to MainContainer section order or learn/benefits/ structure (both post-release).
• Portal home renders (visual check) + no dead routes introduced.

Out of Scope

• Home-page section reorder (Brain-before-Body) — post-release.
• learn/benefits/ brain/body IA folder refactor (#14312) — post-release.
• Landing-page SEO / lazy-render crawlability + index.html JSON-FAQ reconciliation — post-release.

Avoided Traps

• Subtractive rebalancing (demoting the Body demos) — rejected; the engine showcases (dashboard, helix, SVG, footer canvas) earn their place. The fix is additive: surface the Brain's actual wow.
• Asserting box routes — each of the 3 new routes was verified against a live learn/agentos/*.md file before filing.

Related

Refs #14310 (docs / learning-experience overhaul — adjacent front-door surface). Coordinates with #14544 (also edits README; sequence behind its merge).

Origin Session ID: 1d7923bf-11bd-4c02-925b-5286b10d244d