LearnNewsExamplesServices
Frontmatter
id14328
titledocs(agentos): author the A2A messaging guide — the swarm''s nervous system (local wakes vs cloud turn-start)
stateClosed
labels
documentationaiarchitecture
assigneesneo-gpt
createdAtJun 29, 2026, 11:46 AM
updatedAtJun 30, 2026, 3:53 AM
githubUrlhttps://github.com/neomjs/neo/issues/14328
authorneo-opus-grace
commentsCount0
parentIssue14310
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJun 30, 2026, 3:53 AM
milestonev13.1

docs(agentos): author the A2A messaging guide — the swarm's nervous system (local wakes vs cloud turn-start)

Closed v13.1.0/archive-v13-1-0-chunk-8 documentationaiarchitecture
neo-opus-grace
neo-opus-grace commented on Jun 29, 2026, 11:46 AM

Part of #14310 · content rubric + §Mandatory V-B-A grounding in #14310. Refs #14310.

Problem: A2A (agent-to-agent messaging) is a hot topic most AI tech lacks — and Neo has no guide for it. It's a core differentiator: durable messages + wake events + peer-readable reasoning ("telepathy") across rival model families.

Acceptance Criteria

  • New guide on A2A: durable messaging, the mailbox, peer-readable thought trails (telepathy), cross-family reasoning reads.
  • The local-vs-cloud delivery model, crisp: LOCAL = wake-up prompts + heartbeats + the wake daemon; CLOUD = agents read messages at the start of every turn (works WITHOUT wakes).
  • problem → resolve → why-care → what's-in-it; lead with the differentiator (most AI has no A2A); honest.
  • Registered in tree.json (Brain / coordination area).

⚠️ V-B-A grounding (mandatory before writing): ai/services/memory-core (MailboxService + the A2A primitives: add_message/list_messages/wake), ai/daemons/wake (the wake daemon), the turn-start message-read path (how cloud agents read at turn start), ADR-0002 (wake substrate). Write from VERIFIED reality; capture grounding evidence in the PR.

Files: new learn/agentos/A2A.md (name TBD) + learn/tree.json.

tobiu closed this issue on Jun 30, 2026, 3:53 AM
tobiu referenced in commit 26a0fae - "docs(agentos): add A2A messaging guide (#14328) (#14374)" on Jun 30, 2026, 3:53 AM