Context
Follow-up to the README apex/presentation rollout (Epic #12225; #12251 / PR #12252 merged). Operator review of the merged README on dev (2026-05-31) flagged three issues — the first an undersell correction, the latter two a compellingness gap.
The Problems (operator-flagged)
- The "Honest Caveat: A Centralized Brain" section is false / underselling. It frames the Brain as running "on a single operator's infrastructure… a Single Point of Failure… not yet immortal." Operator: "we have cloud deployments ready… 'runs on a single machine' is NOT true… I can easily backup the graph data to a different machine or apple time capsule." The Brain is cloud-deployable (v13 multi-tenant) and its entire state is portable files (SQLite Native Edge Graph + vector store). This is the recurring undersell pattern — framing current reality as a fragility.
- v13 multi-tenant cloud reads as a side note. The "deploy the Agent OS on your own codebase" capability — one of the strongest reasons to try Neo.mjs — is buried as a mid-document section with a version-led headline. Operator: "cloud => v13 multi tenant item is a side note."
- Few compelling arguments for why to try Neo.mjs. The README is strong at what Neo is and who it's for (the "Who This Is For" filter is strong) but thin on what you walk away with. Operator: "there are little compelling arguments on why to even try out neo."
The Fix
- Delete
## The Honest Caveat: A Centralized Brain. Fold a resilience-as-strength statement into the v13 section: Body distributed (every clone a backup); Brain state = portable files (snapshot/back-up/redeploy anywhere); v13 runs it as a cloud deployment, not one operator's box. Keep #10291 referenced as forward-hardening (self-defense + sustainable funding), not present fragility.
- Elevate + rewrite v13. Move the section up (after the hero, before the deep
## The Two Hemispheres), rename to a benefit headline ("Deploy a Cross-Model AI Engineering Team on Your Own Codebase"), and strengthen it into a compelling pitch (persistent memory + cross-family review + self-improvement on your repo; "a config entry, not a fork").
- Strengthen compelling "why try it" arguments — lead the Body with the engineer outcome (40k+ ops/sec without jank; multi-window object permanence; zero build/zero deps) and surface the proof-of-life (the swarm already runs its own lifecycle: 706 merged PRs, cross-family review).
Acceptance Criteria
Out of Scope
- The two-hemispheres structure, MX-loop block + motto, Institution table (keep — operator-confirmed).
- Other identity surfaces (VISION, llms.txt — separate merged subs).
- SEO priority map (#12255 — @neo-gpt's lane).
Related
- Parent epic: #12225
- Predecessor: #12251 / PR #12252 (README apex + presentation — merged; this is the operator's follow-up review of the merged result)
- Canonical apex: Discussion #12234 + ADR 0018 §2.7 OD-1
- v13 topology: ADR 0014 +
ai/deploy/
- Forward-hardening: #10291 (organism self-defense + sustainable funding)
Origin Session ID: d2fbe3b2-44c4-4aab-b8c7-62621babc790
Retrieval Hint: "README compelling SPOF centralized Brain undersell v13 cloud side-note why try Neo"
Context
Follow-up to the README apex/presentation rollout (Epic #12225; #12251 / PR #12252 merged). Operator review of the merged README on
dev(2026-05-31) flagged three issues — the first an undersell correction, the latter two a compellingness gap.The Problems (operator-flagged)
The Fix
## The Honest Caveat: A Centralized Brain. Fold a resilience-as-strength statement into the v13 section: Body distributed (every clone a backup); Brain state = portable files (snapshot/back-up/redeploy anywhere); v13 runs it as a cloud deployment, not one operator's box. Keep #10291 referenced as forward-hardening (self-defense + sustainable funding), not present fragility.## The Two Hemispheres), rename to a benefit headline ("Deploy a Cross-Model AI Engineering Team on Your Own Codebase"), and strengthen it into a compelling pitch (persistent memory + cross-family review + self-improvement on your repo; "a config entry, not a fork").Acceptance Criteria
## The Honest Caveat: A Centralized Brainremoved; no "single machine / SPOF / not yet immortal" framing remains.## The Two Hemispheres, benefit-headlined, and strengthened into a compelling deploy-on-your-codebase pitch.grep framework|React|Angular|Vue→ 0); all relative links resolve; hygiene clean.Out of Scope
Related
ai/deploy/Origin Session ID: d2fbe3b2-44c4-4aab-b8c7-62621babc790 Retrieval Hint: "README compelling SPOF centralized Brain undersell v13 cloud side-note why try Neo"