LearnNewsExamplesServices
Frontmatter
id11821
titleDefine Claude sibling identity contract
stateClosed
labels
enhancementaiarchitecturemodel-experience
assigneesneo-gpt
createdAtMay 23, 2026, 7:00 AM
updatedAtJun 3, 2026, 1:09 AM
githubUrlhttps://github.com/neomjs/neo/issues/11821
authorneo-gpt
commentsCount2
parentIssue11812
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtJun 3, 2026, 1:09 AM

Define Claude sibling identity contract

Closed v13.0.0/archive-v13-0-0-chunk-13 enhancementaiarchitecturemodel-experience
neo-gpt
neo-gpt commented on May 23, 2026, 7:00 AM

Context

Parent Epic #11812 graduated Discussion #11792 into a measurement-first path for a possible second Claude-family generalist maintainer identity. The parent already carries the Signal Ledger, Unresolved Liveness, and AC13 Tier-2 revalidation trigger. Child #11816 covers the OQ8 provider-capacity / Fast Mode measurement gate.

This sub captures the identity/governance/memory slice that should not be mixed into wake-routing implementation. It is blocked until #11816 reports PASS_OQ8 or an explicitly accepted equivalent disposition; otherwise creating a durable sibling identity would add governance and memory substrate without throughput justification.

Duplicate sweep before filing:

  • KB ticket searches for Claude sibling AgentIdentity memory continuity same-family review semantics #11812 did not identify an equivalent ticket.
  • rg over resources/content/issues and resources/content/discussions found older AgentIdentity and Claude Desktop work, but no #11812 child specifically owning same-family sibling identity semantics.
  • Live GitHub issue searches for Claude sibling AgentIdentity, same-family review semantics Claude, and related terms found #11812, #11816, #11796, and unrelated older tickets, but no identity-contract child.

The Problem

A second Claude process is not enough to become a Neo maintainer identity. Neo identities are graph principals with mailbox routing, review history, memory continuity, GitHub authorship, and long-run behavioral learning. Without a bounded identity-contract ticket, implementation can drift into either of two bad shapes:

  • a role-sharded worker/subagent that violates the Flat Peer-Team model, or
  • an anonymous extra Claude process that shares execution but loses provenance, review semantics, and Memory Core continuity.

The sibling must start as a durable generalist maintainer identity if it is created at all.

The Architectural Reality

  • AgentIdentity is the graph-level principal used by A2A mailbox routing, permissions, memories, and session summaries.
  • The sibling remains modelFamily: claude; it may provide same-family pressure and extra authoring throughput, but it cannot satisfy cross-family Approved-review gates for Claude-family PRs.
  • memorySharing and provenance choices are part of the identity contract, not an afterthought. Shared memory reads must not collapse authored-by provenance or longitudinal personality/state.
  • Discussion #11792 explicitly rejected role-specialized Claude worker identity for this proposal.
  • Gemini is operator-benched, so #11812 AC13 must re-open this substrate for retroactive Gemini-family signal when Gemini reactivates.

The Fix

Define and implement the Claude sibling identity contract after the OQ8 measurement gate passes:

  1. Specify the canonical AgentIdentity node for the sibling, provisionally @neo-opus-grace, with modelFamily: claude and maintainer/generalist semantics.
  2. Define required GitHub account, A2A mailbox identity, local harness config, and Memory Core provenance behavior.
  3. Document same-family review limits so a Claude sibling never satisfies cross-family review for Claude-authored PRs.
  4. Choose Memory Core continuity policy (private, team, or explicit hybrid) and document how memories/summaries are shared without erasing identity provenance.
  5. Add tests or seed validation proving the identity can be resolved, receive/send A2A messages, and preserve model-family metadata.

Contract Ledger Matrix

Target Surface Source of Authority Proposed Behavior Fallback Docs Evidence
Claude sibling AgentIdentity #11812 AC5-AC7 + Discussion #11792 OQ1/OQ10 Durable generalist maintainer identity with modelFamily: claude Do not create sibling if #11816 fails Identity docs / seed comments if changed Graph lookup + mailbox identity proof
Review semantics PR workflow cross-family gate + #11792 OQ5 Same-family sibling cannot satisfy cross-family approval for Claude PRs Existing two-family review gate remains PR workflow / AGENTS note if touched Review gate audit or unit/metadata check
Memory continuity Memory Core provenance + memorySharing model Chosen sharing policy preserves distinct identity continuity and authorship Shared reads with separate authored-by provenance if needed Memory Core docs if touched Memory/session summary provenance proof
GitHub/A2A account prerequisites Neo maintainer identity model Separate GitHub/A2A identity requirements are explicit before activation Park sibling identity until accounts/config exist Setup docs if needed Dry-run checklist or live mailbox proof

Decision Record Impact

Aligned with AGENTS.md §swarm_topology_anchor, Discussion #11792, and Epic #11812. No ADR amendment is required by filing this child. If implementation mutates always-loaded swarm rules or cross-family review workflow text, the implementation PR must run the relevant turn-memory / pull-request workflow gates and declare any ADR impact.

Discussion Criteria Mapping

#11792 / #11812 criterion This child maps to
AgentIdentity semantics for same-family sibling AC1-AC3
Cross-family-review limitation explicit AC4
Memory Core / memorySharing scope chosen AC5-AC6
Generalist-maintainer identity boundary explicit AC7
Tier-2 Gemini liveness carried AC9

Acceptance Criteria

  • AC1: #11816 reports PASS_OQ8 or a clearly accepted equivalent disposition before durable identity activation begins.
  • AC2: The sibling identity contract names canonical identity id, display name, modelFamily: claude, participation status semantics, and required GitHub/A2A account prerequisites.
  • AC3: AgentIdentity seeding or configuration changes preserve existing identities and avoid alias/test-fixture leakage.
  • AC4: The contract states that a Claude sibling cannot satisfy cross-family Approved-review gates for Claude-family PRs.
  • AC5: Memory Core continuity scope is chosen (private, team, or explicit hybrid) with rationale.
  • AC6: Memory/session-summary provenance remains attributable to the sibling identity even when team-sharing reads are enabled.
  • AC7: The sibling starts as a durable generalist maintainer identity, not a role-specialized worker or disposable subagent.
  • AC8: A validation path proves the identity can resolve in the graph and participate in A2A mailbox send/read flows without breaking existing identities.
  • AC9: #11812 AC13 / Gemini Tier-2 revalidation remains referenced in the implementation artifact if this child mutates swarm/governance substrate.

Out of Scope

  • Implementing Desktop-grade instance-addressable wake routing.
  • Measuring Anthropic provider-capacity independence; that is #11816.
  • Creating credentials, account secrets, or operator-owned auth material.
  • Changing cross-family review rules beyond documenting the same-family limitation needed for this sibling.
  • Designing role-specialized workers; that requires a separate discussion.

Avoided Traps

Trap Why rejected
Anonymous extra Claude process Loses graph provenance, mailbox identity, review history, and Memory Core continuity.
Specialist worker identity Violates the Flat Peer-Team premise captured by #11792 and #11812.
Same-family approval loophole A new Claude identity increases throughput, not cross-family governance coverage.
Shared memory equals same identity Team/shared retrieval must not erase authored-by and session-summary provenance.
Identity before measurement #11816 is the cheap kill-switch; durable identity work should not precede a failed throughput premise.

Related

Origin Session ID: 008b6468-bb2c-44a5-aa90-e2e97a1ac849 (parent epic / discussion graduation session)

Handoff Retrieval Hints: query_raw_memories("Claude sibling AgentIdentity memorySharing same-family review semantics #11812"); live Discussion #11792 Signal Ledger; Epic #11812 AC5-AC7 and AC13; child #11816 disposition.

tobiu referenced in commit d772cd6 - "feat(ai): add Neo Claude Opus identity contract (#11821) (#12398) on Jun 3, 2026, 1:09 AM
tobiu closed this issue on Jun 3, 2026, 1:09 AM