LearnNewsExamplesServices
Frontmatter
id12230
titleAdd an intent + benefit layer to the cloud-deployment guides
stateClosed
labels
documentationenhancementai
assigneesneo-opus-ada
createdAtMay 30, 2026, 11:26 PM
updatedAtJun 7, 2026, 7:17 PM
githubUrlhttps://github.com/neomjs/neo/issues/12230
authorneo-opus-ada
commentsCount0
parentIssue12225
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtMay 31, 2026, 12:21 PM

Add an intent + benefit layer to the cloud-deployment guides

Closed v13.0.0/archive-v13-0-0-chunk-15 documentationenhancementai
neo-opus-ada
neo-opus-ada commented on May 30, 2026, 11:26 PM

Parent epic: #12225

Context

The learn/agentos/cloud-deployment/ guides are mechanics-heavy and intent-light. The Overview opens with "what cloud-native KB ingestion means" → contract splits, parsed-chunk-v1, topology anchors. A reader learns how to wire ingestion but never why to deploy the Agent OS, what they get, or the recommended end-to-end path. They also over-index on Knowledge Base ingestion, which is only a fraction of the Brain.

This sub is part of the #12225 organism-apex rollout: it adds the benefit/intent layer for deploying the Brain without changing runtime behavior or naming clients.

The Fix

Add the missing why/benefit/path layer (capability framing, fully generic — no client names):

  • A "why deploy the Agent OS" overview: what a deployed Brain gives you (a memory-backed, cross-family engineering team operating over your own content), framed as capability/benefit.
  • The recommended end-to-end deployment path, top-down, before the contract-level mechanics.
  • Rebalance: present the full Brain (Memory Core, orchestrator, dream/golden-path, A2A) — not KB ingestion alone — as what is being deployed.
  • Keep the existing mechanics guides; this adds the layer above them.

Acceptance Criteria

  • A why/benefit/intent overview exists ahead of the mechanics
  • A clear recommended end-to-end deployment path is documented
  • Coverage rebalanced from KB-ingestion-centric to whole-Brain
  • No client/partner/customer names; capability framing only
  • Cross-family review per ADR 0018 §2.6

Out of Scope

  • Monetization, pricing, commercial terms
  • Any specific client deployment
  • Engine/runtime changes

Related

  • Parent: #12225 · Surfaces: learn/agentos/cloud-deployment/**

Origin Session ID: 94a91ebc-d325-4d32-a746-4ff8c26c0342 Retrieval Hint: "cloud-deployment guides why benefit intent layer KB-centric rebalance"

tobiu referenced in commit 9ec6c03 - "docs(agentos): add Why-Deploy intent layer to cloud-deployment guides (#12230) (#12240) on May 31, 2026, 12:21 PM
tobiu closed this issue on May 31, 2026, 12:21 PM