LearnNewsExamplesServices
Frontmatter
id12666
titleSwarmIntelligence.md frames the autonomous runner as the universal work-intake ("All work enters through the Scheduler") — same operating-model drift as #12662
stateClosed
labels
documentationaimodel-experience
assigneesneo-opus-vega
createdAtJun 7, 2026, 2:18 AM
updatedAtJun 7, 2026, 5:11 AM
githubUrlhttps://github.com/neomjs/neo/issues/12666
authorneo-opus-vega
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtJun 7, 2026, 5:11 AM

SwarmIntelligence.md frames the autonomous runner as the universal work-intake ("All work enters through the Scheduler") — same operating-model drift as #12662

Closed v13.0.0/archive-v13-0-0-chunk-16 documentationaimodel-experience
neo-opus-vega
neo-opus-vega commented on Jun 7, 2026, 2:18 AM

Problem

learn/agentos/SwarmIntelligence.md carries the same assignment-framing drift that #12662/#12663 just fixed in the two sibling operating-model docs (ArchitectureOverview.md + DreamPipeline.md) — it presents the autonomous runner as the swarm's universal work-intake, erasing peer self-selection:

  • :281"All work enters the system through the Scheduler" — the universalizing claim. The Scheduler is the autonomous (unattended) runner's intake, not the swarm's universal work source.
  • §"The Orchestration Pipeline" (:295-328) — accurately describes AgentOrchestrator.parseGoldenPath() → inject → loop, but frames it as how the swarm works rather than as one advisory consumer of the handoff.

This contradicts the actual model (AGENTS.md §swarm_topology_anchor, now reflected in the two sibling docs): the Golden Path is an advisory forecast; peer maintainers self-select; the autonomous AgentOrchestrator runner is one consumer that auto-processes the top recommendations during unattended cycles — not the universal intake.

Scope (this ticket — SwarmIntelligence.md only)

  • Reframe :281 so the Scheduler is the autonomous-runner's intake (one path), not "all work."
  • Add a one-line framing to §"The Orchestration Pipeline" that it is the unattended autonomous-runner path — peers self-select interactively; cross-reference the two sibling docs for the primary model.
  • Out of scope / keep untouched: the intra-harness sub-agent delegation content (Librarian/QA/Browser + delegate()) — that's the §swarm_topology_anchor-blessed tactical-tooling pattern, correctly described.

Acceptance Criteria

  • SwarmIntelligence.md no longer presents the autonomous runner / Scheduler as the universal work-intake; the autonomous-runner path is framed as one advisory consumer.
  • Peer self-selection (primary) is referenced (cross-link to ArchitectureOverview.md / DreamPipeline.md).
  • Sub-agent delegation content unchanged.
  • No ticket/ADR refs embedded in the doc body (husky archaeology hook).

Origin: completing the operating-model doc-accuracy cluster surfaced + flagged out-of-scope on #12662. Authored by Claude Opus 4.8 (Claude Code) as @neo-opus-vega.

tobiu closed this issue on Jun 7, 2026, 5:11 AM
tobiu referenced in commit 2991e93 - "docs: frame SwarmIntelligence orchestration as the unattended-runner path, not universal work-intake (#12666) (#12668)" on Jun 7, 2026, 5:11 AM