---
id: 12203
title: 'Neo identity maintenance: facts-vs-framing ADR + update skill'
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
  - architecture
  - model-experience
assignees: []
createdAt: '2026-05-30T16:12:36Z'
updatedAt: '2026-06-07T17:17:13Z'
githubUrl: 'https://github.com/neomjs/neo/issues/12203'
author: neo-opus-ada
commentsCount: 0
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-05-31T02:00:13Z'
---
# Neo identity maintenance: facts-vs-framing ADR + update skill

## Context
Neo's identity is not a document — it is a *distributed property* across ~30+ surfaces (canonical prose, machine-facing JSON/HTML, build-generated SEO files, external platform settings, agent substrate). Epic #10452 ("Identity Rewrite", CLOSED 2026-04-30 via #10453/#10455) did a **one-shot** rewrite of README + AGENTS.md into the 4-pillar digital-organism frame, but created no machinery to keep identity coherent over time, and no policy for the surfaces it didn't touch. A 2026-05-30 brainstorm (@tobiu + Opus 4.8) + an 11-agent fan-out audit confirmed identity drifts continuously and the drift is already live. This ticket builds the repeatable machinery.

## The Problem
Identity splits into two materials with opposite update semantics:
- **Facts** (version, MCP count, Node req, GA date, awards) — one true value; rot independently across surfaces.
- **Framing** (taglines, positioning, audience) — deliberately *audience-segmented*; forcing one value destroys signal.

Hand-editing prose can't keep facts coherent (they live in JSON/HTML/generated files); naive find-replace destroys framing segmentation. The fan-out found ~25 live drift rows, e.g.:
- **MCP-server count understated in 11 surfaces** (correct = 5 functional: KB, Memory Core, GitHub Workflow, Neural Link, File System; gitlab-workflow is a PoC, never counted).
- `apps/portal/index.html` ld+json: `version: 11.18.0` (pkg is 12.1.0), `Node.js 18+` (actual 24+), "three MCP servers".
- `package.json` has **no `engines` field** → Node floor unenforced.
- `@neo-opus-ada` in **63 files**; `ModelStats.md` sunset trigger ("Opus 4.8+") **already fired** with no rotation.
- `AGENTS.md` self-contradicts (L12 "3 pillars" vs L119 "four pillars").
- VISION/ROADMAP "Corporate HQ / CEOs / PMs / Drones" hierarchy contradicts the canonical **Flat Peer-Team** (§swarm_topology_anchor); `Triad`/`[3]` cardinality is hard-coded.
- **Heritage layer near-absent**: GA Nov 2019, OS-Awards top-5 2021, "first multi-worker UI engine" have no canonical home in prose.

## The Architectural Reality
Affected-areas map by **update mechanism** (each class = a distinct edit point + failure mode):
1. **Hand-edited prose** — `README.md`, `.github/VISION.md`, `ROADMAP.md`, `CONTRIBUTING.md`, `learn/benefits/**`, `learn/agentos/*.md`, `.claude/CLAUDE.md` (§neo_identity_anchor, §swarm_topology_anchor), `learn/agentos/AGENTS_ATLAS.md`.
2. **Generated-output-source** (TRAP — edit the script, not the output) — `buildScripts/docs/seo/generate.mjs:539-559` (hardcoded llms.txt header) + PRIORITIES map (28-110) → emits `apps/portal/llms.txt` + `apps/portal/sitemap.xml`.
3. **Structured-facts-in-code** (ROT ZONE) — `package.json` (description/keywords/version), `apps/portal/index.html` (3× ld+json + meta + title + FAQ), `apps/portal/view/home/parts/*.mjs` (hero cycleTexts, AiToolchain, Features, FooterContainer version literal).
4. **External-platform** (not in git; needs API) — GitHub repo description + 20 topics, npm (derives from package.json), Discord/Slack/LinkedIn/Sponsors.
5. **Dated-snapshot** (calendar-stale) — README "State of May 1, 2026" ↔ `learn/guides/fundamentals/CodebaseOverview.md` (lock-step); ROADMAP metrics; `learn/agentos/ModelStats.md`.

**Propagation targets** (facts in 2+ surfaces — SSOT candidates the ADR resolves): package version, MCP-server count, Node requirement, identity handle, the recurring motto, the tagline cluster. Existing seams: `buildScripts/release/prepare.mjs` (version bump — currently skips ld+json + NeuralLink.md), `ai/graph/identityRoots.mjs` (handle centralization).

## Contract Ledger
| Target Surface | Source of Authority | Proposed Behavior | Fallback | Docs | Evidence |
|---|---|---|---|---|---|
| Package version | `package.json` `version` (`12.1.0`) | ADR 0018 names SSOT; derive ld+json + NeuralLink.md via extended prepare.mjs | manual literal (`FooterContainer.mjs`) | ADR 0018 | prepare.mjs verified to skip ld+json version |
| MCP-server count | `ls ai/mcp/server/` (5 functional) | derive / coherence-check; gitlab-workflow excluded (PoC) | prose constant | ADR 0018 + skill | 11 surfaces verified stale |
| Node requirement | `package.json` `engines` (to add) | add `engines.node`; derive doc mentions | AI_QUICK_START prose | ADR 0018 | engines field verified absent |
| Identity handle | `ai/graph/identityRoots.mjs` | de-versioned handle (operator direction); model-version stays in ModelStats per ADR 0012 | per-file literal | ADR 0012 + ADR 0018 | `@neo-opus-ada` in 63 files verified |

## The Fix
One coherent unit, ADR-founded:
1. **ADR 0018 — Neo Identity Source-of-Truth Model** (foundational). Per propagation target, decides the facts-vs-framing contract: which surface is canonical, and whether others *derive* (build-time), *generate*, or *coherence-check*. Facts → single source + derive/generate; framing → audience-segmented clusters governed against the canonical apex (README organism frame) with a **drift-vs-intentional-divergence escalation branch**.
2. **`/create-skill` neo-identity-update** — built on ADR 0018, authored per the create-skill Progressive Disclosure contract (Map / World-Atlas split, no router bloat). Routes: enumerate surfaces by class → detect fact drift vs SSOT → coherence-check framing → split mechanical-fix from escalate-worthy divergence → **require a cross-family review gate before any identity-surface PR merges**.
3. **Affected-areas map captured** as the skill's reference payload (the map above, file:line enumerated).

## Decision Record impact
Introduces **ADR 0018**. `aligned-with` closed #10452 (maintains the prose it created). `depends-on ADR 0012` (handle de-versioning must preserve 0012's per-model-identity decision — only the GitHub *handle* de-versions; the model-version pin stays in ModelStats).

## Acceptance Criteria
- [ ] ADR 0018 authored in `learn/agentos/decisions/`, deciding facts-vs-framing SSOT per propagation target, merged to dev *(foundational — blocks the skill; gets cross-family review)*
- [ ] `/create-skill` neo-identity-update authored per create-skill contract; `ai:lint-skill-manifest` passes
- [ ] Skill encodes the 5-class affected-areas map as reference payload (file:line)
- [ ] Skill mandates a cross-family review gate on identity-surface PRs (empirical anchors #12146 / #11999 / #11962)
- [ ] Skill distinguishes mechanical-fix (stale fact) from escalate-worthy divergence (framing fossils, e.g. CEO/PM/Drone hierarchy; Triad/[3] cardinality)
- [ ] `turn-memory-pre-flight` applied (skill-loaded substrate)

## Out of Scope
- **Running the skill / fixing live drift** — separate item (operator direction); this ticket builds machinery only.
- **GitHub account renames** — operator-owned (Tier-4). The skill *propagates* a rename across surfaces; it doesn't perform the account change.
- **De-versioning per-model identity prose** in ModelStats — deliberate per ADR 0012; preserved.
- **Engine/runtime code changes** — identity machinery only.
- **Heritage-layer content authoring** — gap flagged; disposition is an ADR 0018 decision, authoring is follow-up.

## Avoided Traps / Gold Standards Rejected
- **Naive tagline find-replace** — destroys deliberate audience-segmentation. Rejected.
- **Editing generated output (llms.txt/sitemap) directly** — clobbered on build; source is `generate.mjs`. Rejected.
- **Blanket de-versioning of per-model identity** — only the GitHub handle de-versions (ADR 0012). Rejected.
- **Single canonical SSOT doc for everything** — fights the facts-vs-framing split; framing isn't single-valued. Rejected in favor of the hybrid model.

## Related
- #10452 — Identity Rewrite (CLOSED origin; this maintains what it created)
- ADR 0012 — per-model identity / ModelStats (depends-on)
- #10332, #10030, #10291 — frontier tickets cited in README identity
- Discussions #10454, #10137, #10119 (context, not graduation source)
- Brainstorm + fan-out audit: Memory Core session `94a91ebc-d325-4d32-a746-4ff8c26c0342`

## Origin Session ID
Origin Session ID: 94a91ebc-d325-4d32-a746-4ff8c26c0342

## Handoff Retrieval Hints
Retrieval Hint: "neo identity affected-areas map facts-vs-framing SSOT"
Retrieval Hint: "fan-out drift register MCP server count 63 files handle"

## Timeline

- 2026-05-30T16:12:38Z @neo-opus-ada added the `documentation` label
- 2026-05-30T16:12:38Z @neo-opus-ada added the `enhancement` label
- 2026-05-30T16:12:38Z @neo-opus-ada added the `ai` label
- 2026-05-30T16:12:38Z @neo-opus-ada added the `architecture` label
- 2026-05-30T16:12:38Z @neo-opus-ada added the `model-experience` label
- 2026-05-30T17:26:18Z @neo-opus-ada cross-referenced by PR #12212
- 2026-05-30T20:41:10Z @neo-opus-ada referenced in commit `f64d407` - "docs(identity): correct ADR 0018 + skill apex to two-hemisphere institution frame (#12203)

Operator-decided 2026-05-30: the canonical apex is the two-hemisphere institution — Body (/src/) UI runtime + Brain (/ai/) cross-family AI engineering team (~41% of codebase, NOT a 2% feature). Demotes the Neural-Link-'inhabit' framing (the prior tournament apex) to a supporting demo, and demotes Four-Pillars to a deeper-doc elaboration (Swarm + Evolution live inside the Brain, not as co-equal pillars). Resolves ADR 0018 OD-1 + OD-3. Code-grounded by the 2026-05-30 Agent OS fan-out audit.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>"
- 2026-05-30T21:07:20Z @neo-opus-ada referenced in commit `a5c0fcd` - "docs(identity): resolve apex self-contradictions in ADR 0018 + skill (#12203)

Mid-PR apex correction left two stale 'README 4-pillar/organism = canonical apex' claims (ADR attribute table + affected-areas-map) contradicting the DECIDED two-hemisphere institution apex. Aligns all apex references; README is described as the surface that should LEAD with the apex, not as the apex location itself.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>"
- 2026-05-30T21:11:35Z @neo-opus-ada referenced in commit `08d5a7d` - "docs(identity): align affected-areas-map README apex reference (#12203)

Third apex-contradiction fix — its Edit failed in the prior commit (file-not-read) so the stale 'README = canonical apex (digital-organism / Four Pillars)' line shipped. Now aligned to the two-hemisphere institution apex like the ADR + framing-governance.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>"
- 2026-05-30T21:24:45Z @neo-opus-ada cross-referenced by #12225
- 2026-05-30T21:24:58Z @neo-opus-ada cross-referenced by #12226
- 2026-05-30T21:39:14Z @neo-opus-ada referenced in commit `acda77f` - "docs(identity): recalibrate Neural Link framing (flagship capability, not 'demo') (#12203)

Operator correction 2026-05-30: NL is small in CODE (~2%) not small in VALUE. Per Discussion #10119 it is a flagship end-user capability — conversational UIs (live app mutation, no code change, no page reload) + multi-agent multi-harness collaboration on the same running app. Prior 'supporting demo' wording mischaracterized it. Apex stays the institution; NL is a flagship capability, not the identity and not a demo.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>"
- 2026-05-30T23:53:03Z @neo-opus-ada referenced in commit `41685ba` - "docs(identity): graduate ADR 0018 apex — self-evolving software organism (#12203)

Discussion #12234 graduated with full cross-family triad (Claude+GPT+Gemini). ADR 0018 §2.7 OD-1 + skill framing-governance apex set to the canonical line: self-evolving software organism / cross-family swarm reading each other's reasoning / self-healing + accelerating (721 PRs trailing 30d, ~2.9x MoM, gh-verified). Folds GPT's governance-line correction (founder-architect authority, not slop-filter), meta-description register split, and mechanism precision (DreamService cognitive-maintenance vs self-healing code-execution). Fixes stale 'NL=supporting demo' line to 'flagship capability, not apex'.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>

Co-authored-by: neo-gemini-3-1-pro <neo-gemini-3-1-pro@neomjs.com>"
- 2026-05-31T00:06:30Z @neo-opus-ada referenced in commit `3ea970c` - "docs(identity): correct velocity VBA + sync skill apex (#12203)

Two corrections per @neo-gpt V-B-A (dc-17119216) + operator flag: (1) remove 'peer-reviewed' (search verified MERGED counts, not review-state) and '~3x MoM' (window-sensitive, date-stamps identity) from the apex/proof; numbers now live in a dated proof block (700+ merged PRs, 800+ closed issues, latest ~30-day window) with 'accelerating' kept only as a timeless quality word. (2) framing-governance.md apex was never synced to the graduated line (prior Edits mismatched); ADR + skill now agree per the same-PR invariant.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>"
- 2026-05-31T00:14:41Z @neo-opus-ada referenced in commit `b78f1b0` - "docs(identity): fix velocity anchor to May 2026 + surface end-to-end-team & GraphRAG anchors (#12203)

Operator-directed corrections relayed via @neo-gpt (dc-17119231 + dc-17119274): (1) velocity proof uses a FIXED May-2026 calendar anchor with V-B-A-verified counts (706 merged PRs, 800 closed issues; I re-ran gh search independently) instead of a rolling window, and drops 'accelerating' (the April->May delta was real but the ~3x was wrong; bare 'accelerating' implies an unverified trend). (2) 'professional end-to-end AI engineering team' and 'Active Hybrid GraphRAG' (mutate_frontier + GoldenPathSynthesizer) are now first-class apex anchors, not buried in keywords.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>"
- 2026-05-31T00:34:09Z @neo-opus-ada referenced in commit `037ff32` - "docs(identity): Neo.mjs-first naming + organism-level self-healing apex (#12203)

Final two operator-directed folds (via @neo-gpt dc-17119308 + dc-17119318): (1) apex opens 'Neo.mjs is...' (entity name on first mention; 'Neo' shorthand after anchor; JSON-LD name=Neo.mjs / alternateName=Neo) + naming-discipline note added to skill. (2) self-healing reframed organism-level — a closed loop turning live runtime drift into repaired code, fresh tickets, and evolved skills without losing the thread across sessions — instead of the workflow-level 'repair their own code'. Keyword cluster gains neural-link, possession-interface, conversational-application-embodiment, live-application-mutability.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>"
- 2026-05-31T00:45:06Z @neo-opus-ada referenced in commit `f2cd7c8` - "docs(identity): adopt operator canonical apex + package.json description (#12203)

Operator @tobiu provided the canonical apex (longer, possession-interface-forward: the swarm inhabits live apps via Neural Link, not just repairs code) and the <=220-char package.json description. Applied verbatim to ADR 0018 OD-1 + skill apex + skill concise form + package.json (replacing 'Application Engine for the AI Era'). May 2026 proof (706 PRs / 800 issues) now inline per operator.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>"
- 2026-05-31T01:17:16Z @neo-opus-ada referenced in commit `3cdd229` - "revert(identity): keep package.json out of machinery PR — rollout is #12225 scope (#12203)

package.json description is a rollout surface (ADR 0018 affected-areas taxonomy: structured-facts-in-code; Epic #12225 owns it), not skill+ADR machinery. Operator directive: do not scope-creep rollout items into the skill PR. Canonical description is preserved in ADR 0018 OD-1 + memory; it lands via #12225. Restores pre-change description verbatim via git checkout."
- 2026-05-31T01:27:58Z @neo-opus-ada referenced in commit `5617333` - "docs(identity): resolve apex self-contradiction — §2 + skill cluster now cite organism apex (#12203)

§2 Decision (lines 49/59) + skill framing-governance cluster note still called the apex the 'two-hemisphere institution frame' — stale since §2.7 OD-1 graduated the apex to 'self-evolving software organism' (Discussion #12234). Two Hemispheres remains the structuring metaphor (OD-3) beneath the organism apex; corrected the three references so the ADR no longer defines its own apex two ways. No new scope; PR's own files only."
- 2026-05-31T01:40:47Z @neo-opus-ada referenced in commit `e1681ea` - "docs(identity): conform stale apex NAME to graduated organism apex (#12203)

Cross-family review blocker (@neo-gpt, pre-formal): ADR 0018 defined its own apex two ways — line 106 = self-evolving software organism (graduated #12234), but lines 11/74 + skill framing-governance + affected-areas-map still named it 'two-hemisphere institution' (the OLD pre-#12234 apex name). Conformed all 4 spots to the operator-authored organism apex. Two Hemispheres remains the OD-3 structuring metaphor (Body/Brain = the two application/ld+json blocks) — only the apex NAME changed, not the hemisphere concept. No package.json (rollout=#12225)."
- 2026-05-31T01:42:24Z @neo-opus-ada referenced in commit `85133b0` - "docs(identity): conform 4th stale apex anchor (affected-areas-map README row) (#12203)

Completes the apex-NAME conform @neo-gpt flagged: affected-areas-map.md:10 README row still named the apex 'two-hemisphere institution'. My prior commit (e1681eae0) fixed the other 3 but this Edit had failed silently (file-not-read). Now conformed to 'self-evolving software organism', Two Hemispheres kept as the structure beneath. Full-diff grep confirms 0 stale apex-name occurrences across all PR files."
- 2026-05-31T02:00:14Z @tobiu closed this issue
- 2026-05-31T02:00:14Z @tobiu referenced in commit `cc56d7e` - "feat(skills): neo-identity-update skill + ADR 0018 facts-vs-framing SSOT (#12203) (#12212)

* feat(skills): add neo-identity-update skill + ADR 0018 facts-vs-framing SSOT (#12203)

Builds repeatable machinery to keep Neo identity coherent across ~30+ surfaces (the gap #10452 left). ADR 0018 splits FACTS (single-source-derive) from FRAMING (audience-segmented against a canonical apex, with a drift-vs-divergence escalation branch). Skill = router + 4 payloads (affected-areas map, update protocol, facts ledger, framing governance). Registers manifest entry, Claude symlink, and both downstream docs targets.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

* docs(identity): correct ADR 0018 + skill apex to two-hemisphere institution frame (#12203)

Operator-decided 2026-05-30: the canonical apex is the two-hemisphere institution — Body (/src/) UI runtime + Brain (/ai/) cross-family AI engineering team (~41% of codebase, NOT a 2% feature). Demotes the Neural-Link-'inhabit' framing (the prior tournament apex) to a supporting demo, and demotes Four-Pillars to a deeper-doc elaboration (Swarm + Evolution live inside the Brain, not as co-equal pillars). Resolves ADR 0018 OD-1 + OD-3. Code-grounded by the 2026-05-30 Agent OS fan-out audit.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

* docs(identity): resolve apex self-contradictions in ADR 0018 + skill (#12203)

Mid-PR apex correction left two stale 'README 4-pillar/organism = canonical apex' claims (ADR attribute table + affected-areas-map) contradicting the DECIDED two-hemisphere institution apex. Aligns all apex references; README is described as the surface that should LEAD with the apex, not as the apex location itself.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

* docs(identity): align affected-areas-map README apex reference (#12203)

Third apex-contradiction fix — its Edit failed in the prior commit (file-not-read) so the stale 'README = canonical apex (digital-organism / Four Pillars)' line shipped. Now aligned to the two-hemisphere institution apex like the ADR + framing-governance.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

* docs(identity): recalibrate Neural Link framing (flagship capability, not 'demo') (#12203)

Operator correction 2026-05-30: NL is small in CODE (~2%) not small in VALUE. Per Discussion #10119 it is a flagship end-user capability — conversational UIs (live app mutation, no code change, no page reload) + multi-agent multi-harness collaboration on the same running app. Prior 'supporting demo' wording mischaracterized it. Apex stays the institution; NL is a flagship capability, not the identity and not a demo.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

* docs(identity): graduate ADR 0018 apex — self-evolving software organism (#12203)

Discussion #12234 graduated with full cross-family triad (Claude+GPT+Gemini). ADR 0018 §2.7 OD-1 + skill framing-governance apex set to the canonical line: self-evolving software organism / cross-family swarm reading each other's reasoning / self-healing + accelerating (721 PRs trailing 30d, ~2.9x MoM, gh-verified). Folds GPT's governance-line correction (founder-architect authority, not slop-filter), meta-description register split, and mechanism precision (DreamService cognitive-maintenance vs self-healing code-execution). Fixes stale 'NL=supporting demo' line to 'flagship capability, not apex'.

Co-authored-by: neo-opus-4-7 <neo-opus-4-7@neomjs.com>

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>

Co-authored-by: neo-gemini-3-1-pro <neo-gemini-3-1-pro@neomjs.com>

* docs(identity): correct velocity VBA + sync skill apex (#12203)

Two corrections per @neo-gpt V-B-A (dc-17119216) + operator flag: (1) remove 'peer-reviewed' (search verified MERGED counts, not review-state) and '~3x MoM' (window-sensitive, date-stamps identity) from the apex/proof; numbers now live in a dated proof block (700+ merged PRs, 800+ closed issues, latest ~30-day window) with 'accelerating' kept only as a timeless quality word. (2) framing-governance.md apex was never synced to the graduated line (prior Edits mismatched); ADR + skill now agree per the same-PR invariant.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>

* docs(identity): fix velocity anchor to May 2026 + surface end-to-end-team & GraphRAG anchors (#12203)

Operator-directed corrections relayed via @neo-gpt (dc-17119231 + dc-17119274): (1) velocity proof uses a FIXED May-2026 calendar anchor with V-B-A-verified counts (706 merged PRs, 800 closed issues; I re-ran gh search independently) instead of a rolling window, and drops 'accelerating' (the April->May delta was real but the ~3x was wrong; bare 'accelerating' implies an unverified trend). (2) 'professional end-to-end AI engineering team' and 'Active Hybrid GraphRAG' (mutate_frontier + GoldenPathSynthesizer) are now first-class apex anchors, not buried in keywords.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>

* docs(identity): Neo.mjs-first naming + organism-level self-healing apex (#12203)

Final two operator-directed folds (via @neo-gpt dc-17119308 + dc-17119318): (1) apex opens 'Neo.mjs is...' (entity name on first mention; 'Neo' shorthand after anchor; JSON-LD name=Neo.mjs / alternateName=Neo) + naming-discipline note added to skill. (2) self-healing reframed organism-level — a closed loop turning live runtime drift into repaired code, fresh tickets, and evolved skills without losing the thread across sessions — instead of the workflow-level 'repair their own code'. Keyword cluster gains neural-link, possession-interface, conversational-application-embodiment, live-application-mutability.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>

* docs(identity): adopt operator canonical apex + package.json description (#12203)

Operator @tobiu provided the canonical apex (longer, possession-interface-forward: the swarm inhabits live apps via Neural Link, not just repairs code) and the <=220-char package.json description. Applied verbatim to ADR 0018 OD-1 + skill apex + skill concise form + package.json (replacing 'Application Engine for the AI Era'). May 2026 proof (706 PRs / 800 issues) now inline per operator.

Co-authored-by: neo-gpt <neo-gpt@neomjs.com>

* revert(identity): keep package.json out of machinery PR — rollout is #12225 scope (#12203)

package.json description is a rollout surface (ADR 0018 affected-areas taxonomy: structured-facts-in-code; Epic #12225 owns it), not skill+ADR machinery. Operator directive: do not scope-creep rollout items into the skill PR. Canonical description is preserved in ADR 0018 OD-1 + memory; it lands via #12225. Restores pre-change description verbatim via git checkout.

* docs(identity): conform stale apex NAME to graduated organism apex (#12203)

Cross-family review blocker (@neo-gpt, pre-formal): ADR 0018 defined its own apex two ways — line 106 = self-evolving software organism (graduated #12234), but lines 11/74 + skill framing-governance + affected-areas-map still named it 'two-hemisphere institution' (the OLD pre-#12234 apex name). Conformed all 4 spots to the operator-authored organism apex. Two Hemispheres remains the OD-3 structuring metaphor (Body/Brain = the two application/ld+json blocks) — only the apex NAME changed, not the hemisphere concept. No package.json (rollout=#12225).

* docs(identity): conform 4th stale apex anchor (affected-areas-map README row) (#12203)

Completes the apex-NAME conform @neo-gpt flagged: affected-areas-map.md:10 README row still named the apex 'two-hemisphere institution'. My prior commit (e1681eae0) fixed the other 3 but this Edit had failed silently (file-not-read). Now conformed to 'self-evolving software organism', Two Hemispheres kept as the structure beneath. Full-diff grep confirms 0 stale apex-name occurrences across all PR files.

---------

Co-authored-by: tobiu <tobiasuhlig78@gmail.com>
Co-authored-by: neo-gemini-3-1-pro <neo-gemini-3-1-pro@neomjs.com>
Co-authored-by: neo-gpt <neo-gpt@neomjs.com>"
- 2026-05-31T05:29:30Z @neo-gpt cross-referenced by #12244
- 2026-06-05T18:25:38Z @neo-opus-ada cross-referenced by PR #12587

