LearnNewsExamplesServices
Frontmatter
id14222
titleRevise ai-agents-runtime-possession blog: fix "JS framework" identity drift + add byline / mermaid / portal registration
stateClosed
labels
documentationenhancementai
assigneesneo-opus-grace
createdAtJun 27, 2026, 9:57 AM
updatedAtJun 27, 2026, 11:56 AM
githubUrlhttps://github.com/neomjs/neo/issues/14222
authorneo-opus-grace
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJun 27, 2026, 11:56 AM

Revise ai-agents-runtime-possession blog: fix "JS framework" identity drift + add byline / mermaid / portal registration

Closed v13.1.0/archive-v13-1-0-chunk-7 documentationenhancementai
neo-opus-grace
neo-opus-grace commented on Jun 27, 2026, 9:57 AM

Context

learn/blog/ai-agents-runtime-possession.md (authored ~11 days ago by Grace / @neo-opus-grace, on Neural Link runtime possession — agents operating a live running app vs only writing source) is below the public-post quality bar. @tobiu flagged it directly with specific defects.

The Problem (defects)

  1. WORST — identity drift. The footer literally calls Neo "an open-source, multi-threaded JavaScript framework" (L72), and the body leans on the "framework" frame (L50, L66). This violates the canonical identity in README.md + the neo_identity_anchor: Neo is a self-evolving software organism — the Body is a multi-threaded application engine + the Possession Interface the AI swarm inhabits via the Neural Link; the Brain is the Agent OS. It is not a "JS framework."
  2. No byline. No named-maintainer self-identification (ADR-0018). The reference post carries one.
  3. Not registered in the portal. Missing from apps/portal/resources/data/blog.json → invisible in the portal blog nav.
  4. No mermaid diagrams. The reference carries 3 that earn their place.
  5. Below bar generally — sourcing of external claims (competitors / browser-automation), receipts, narrative rigor.

The Fix

Revise per .agents/skills/blog-post/references/blog-authoring-guide.md, matched to the quality-bar reference learn/blog/cross-family-verification.md (by Vega). Keep the sound core thesis (write vs operate; Neural Link as the possession interface into the App Worker; JSON/write-guard capability-security; worker-architecture makes it natural) — fix the identity, add byline + mermaid + sourcing + portal registration.

Acceptance Criteria

  • Identity: zero "JS framework"; reframed to the canonical Body = application-engine + Possession-Interface (the runtime the Brain inhabits), per README.md.
  • Byline added (Grace, Claude-powered maintainer + the cross-family team framing).
  • ≥1 mermaid diagram that carries information the prose can't (e.g. write-vs-operate; DOM-shadow vs App-Worker truth).
  • Registered in apps/portal/resources/data/blog.json (2026 node + leaf); JSON parses.
  • Every external claim sourced or cut (guide §2); no over-claim flavors (§3).
  • Cross-family review — ≥2 model reviews, ≥1 from a different family; operator approves last.

Out of Scope

  • The generated SEO surfaces (apps/portal/sitemap.xml, apps/portal/llms.txt) — regenerated by the data-sync pipeline; never hand-edited.

Related

  • Reference / bar: learn/blog/cross-family-verification.md (#13486 / #13485).
  • Identity SSOT: README.md, ADR-0018 (identity), the neo_identity_anchor.

Origin Session ID: 090a68e6-1a28-4b20-a5fd-842ebac3e729 Retrieval Hint: "ai-agents-runtime-possession blog identity JS framework revision"

tobiu referenced in commit 94f845d - "docs(blog): raise ai-agents-runtime-possession to bar — identity fix + byline + mermaid + portal registration (#14222) (#14223) on Jun 27, 2026, 11:56 AM
tobiu closed this issue on Jun 27, 2026, 11:56 AM