Parent epic: #12225
Context
The README opening should lead with the canonical apex (ADR 0018 §2.7 OD-1, graduated via Discussion #12234): Neo.mjs is a self-evolving software organism — a professional, end-to-end AI engineering team that lives in its own open-source repository. The README's current framing ("self-evolving digital organism / Four Pillars") is close on the organism noun but undersells: it misses the institution / Brain-as-headline gloss (the cross-family engineering team) and treats Swarm + Evolution as co-equal pillars rather than capabilities inside the Brain. Body /src/ runtime + Brain /ai/ Agent OS are the two hemispheres beneath the apex (structure, not the lead noun). The Neural Link was historically over-weighted as a headline; it is a flagship capability, not the apex.
The Fix
Rewrite the README opening to lead with the canonical apex:
- Open with the self-evolving-software-organism apex sentence (a professional end-to-end AI engineering team; Body runtime + Brain cross-family engineering team beneath it; human at the merge gate).
- Demote the Neural Link from headline to a supporting capability mention.
- Demote "Four Pillars" from the top-level scaffold to a deeper-doc elaboration of what the Brain contains (Swarm + Evolution live inside the Brain).
- Preserve adoption substrate (badges, quickstart, license); the deeper organism / Four-Pillars framing relocates to VISION / deeper docs, not deleted.
- Keep all numeric facts (version, counts, dated metrics) sourced from their SSOT; the May-2026 proof point (706 merged / 800 closed, merged/closed-only) is proof-layer, not the lead.
Acceptance Criteria
Out of Scope
- VISION.md rewrite (sibling sub)
learn/benefits/ Brain docs (sibling sub)
- Heritage facts (sibling sub)
Related
- Parent: #12225 · Apex: ADR 0018 §2.7 OD-1 (graduated via Discussion #12234)
Origin Session ID: 94a91ebc-d325-4d32-a746-4ff8c26c0342
Retrieval Hint: "README opening canonical apex self-evolving software organism demote Neural Link Four Pillars"
Parent epic: #12225
Context
The README opening should lead with the canonical apex (ADR 0018 §2.7 OD-1, graduated via Discussion #12234): Neo.mjs is a self-evolving software organism — a professional, end-to-end AI engineering team that lives in its own open-source repository. The README's current framing ("self-evolving digital organism / Four Pillars") is close on the organism noun but undersells: it misses the institution / Brain-as-headline gloss (the cross-family engineering team) and treats Swarm + Evolution as co-equal pillars rather than capabilities inside the Brain. Body
/src/runtime + Brain/ai/Agent OS are the two hemispheres beneath the apex (structure, not the lead noun). The Neural Link was historically over-weighted as a headline; it is a flagship capability, not the apex.The Fix
Rewrite the README opening to lead with the canonical apex:
Acceptance Criteria
CodebaseOverview.mdOut of Scope
learn/benefits/Brain docs (sibling sub)Related
Origin Session ID: 94a91ebc-d325-4d32-a746-4ff8c26c0342 Retrieval Hint: "README opening canonical apex self-evolving software organism demote Neural Link Four Pillars"