Generic orchestration moves from infra to cc-agents, and Relay runs jobs until cc-agents earns trust

spec:decisions.orchestration-leaves-infra

Decision Record · featuredefined floor ready

Next rung ready: nothing blocks; it waits only for the author's statement.

Packs: none

Design: no design entries · no pinned declarations · no decisions

design/hq/decisions/orchestration-leaves-infra.sdp.md

No open questions and no blocking questions; implementation binding none, verifier binding none, and expected-outcome oracle none.

Intent

outcome: Decide where the inbox, the chain and other generic orchestration live, and what runs harness jobs meanwhile.

Decision

context: The inbox coordination lives in infra because the attempt at bootstrapping HQ needed it there. The owner ruled that all generic orchestration moves to the Relay plugin, and on 30 October named the destination: the rewrite of Relay, cc-agents, built to the official Claude Code mods extension standard and almost done. Relay already carries mission-critical multi-day work.
decision: The inbox, the chain and similar generic orchestration move from infra to cc-agents. Until cc-agents' job runner earns trust it stays off on every machine and Relay runs the harness jobs, while its coordination can already be on. Infra deploys the result to projects as an extension.
rationale: Hard to reverse: every project's sessions will coordinate through it. Surprising without context: the machinery that moves work sits in neither HQ nor infra. A real trade-off: a plugin that must work across harnesses, against one repository's concerns leaking into all fifty projects.
alternatives: Keep orchestration in infra: infra would stay the dependency of all coordination, and it is the repository that has to be most isolated.
Put orchestration in HQ: HQ would become a runtime, and it would lose the quiet the isolation exists for.
Switch to cc-agents now: its earlier cut has not earned trust, and the fleet's work depends on what runs jobs today.
consequences: The owner's recorded order takes over Relay and cc-agents before infra, so the roadmap puts orchestration ahead of infra's takeover.

Verification

Verifier bindings

No verifier binding recorded.

Design view

Requirement drawing

Declared verifying examples: no declared verifying example.
Satisfying or referencing units: no recorded binding.
Test or oracle bindings: no recorded binding.

Requirement drawing for spec:decisions.orchestration-leaves-infra

Arrows: refines (declared).

The diagram as text

spec:decisions.orchestration-leaves-infra: Generic orchestration moves from infra to cc-agents, and Relay runs jobs until cc-agents earns trust · declared Spec
spec:hq.orchestration: Orchestration lives in one plugin, apart from infra and HQ · declared Spec
spec:decisions.orchestration-leaves-infra refines spec:hq.orchestration · declared — settles where generic orchestration lives and what runs jobs until then

Mermaid source

Copyable source; the Studio draws static SVG.

Preferred and chosen syntax: requirementDiagram; exact refines, satisfies and verifies, with claim words in nodes and per-edge comments.

Mermaid source for Requirement drawing for spec:decisions.orchestration-leaves-infra

requirementDiagram
  requirement n0 {
    text: "Generic orchestration moves from infra to cc-agents, and Relay runs jobs until cc-agents earns trust · declared Spec · spec:decisions.orchestration-leaves-infra"
  }
  requirement n1 {
    text: "Orchestration lives in one plugin, apart from infra and HQ · declared Spec · spec:hq.orchestration"
  }
  %% claim: declared; reason: settles where generic orchestration lives and what runs jobs until then
  n0 - refines -> n1

Decisions

No decision record named.

Runtime

No implementation neighborhood recorded.

Runtime observation: not tracked.

Evidence

Runtime observation: not tracked.

Build attestations: not tracked.

Deployments: not tracked.

Bills of materials: not tracked.

Impact

Relations of spec:decisions.orchestration-leaves-infra

The diagram as text

spec:cc-agents.hq-links: The one tie between this repository's Specs and HQ's design
spec:decisions.orchestration-leaves-infra: Generic orchestration moves from infra to cc-agents, and Relay runs jobs until cc-agents earns trust
spec:hq.infra: Infra delivers configuration by projection, under HQ's plan
spec:hq.orchestration: Orchestration lives in one plugin, apart from infra and HQ
spec:decisions.orchestration-leaves-infra refines spec:hq.orchestration · declared — settles where generic orchestration lives and what runs jobs until then
spec:cc-agents.hq-links decidedBy spec:decisions.orchestration-leaves-infra · declared — places the inbox and the chain in cc-agents and keeps the runner off
spec:hq.infra decidedBy spec:decisions.orchestration-leaves-infra · declared — the ruling takes generic orchestration out of infra
spec:hq.orchestration decidedBy spec:decisions.orchestration-leaves-infra · declared — the ruling places generic orchestration in Relay's rewrite

Mermaid source

Copyable source; the Studio draws static SVG.

Preferred syntax: flowchart. Chosen syntax: labelled flowchart, preserving exact relations, claims and folds.

Mermaid source for Relations of spec:decisions.orchestration-leaves-infra

flowchart TB
  n0["Orchestration lives in one plugin, apart from infra and HQ · spec:hq.orchestration"]
  n1["Generic orchestration moves from infra to cc-agents, and Relay runs jobs until cc-agents earns trust · spec:decisions.orchestration-leaves-infra"]
  n2["The one tie between this repository's Specs and HQ's design · spec:cc-agents.hq-links"]
  n3["Infra delivers configuration by projection, under HQ's plan · spec:hq.infra"]
  n2 -->|"decidedBy · declared — places the inbox and the chain in cc-agents and keeps the runner off"| n1
  n1 -->|"refines · declared — settles where generic orchestration lives and what runs jobs until then"| n0
  n3 -->|"decidedBy · declared — the ruling takes generic orchestration out of infra"| n1
  n0 -->|"decidedBy · declared — the ruling places generic orchestration in Relay's rewrite"| n1

Rests on

refines · spec:hq.orchestration · stated defined, floor ready

Rested on by

Distance 1

spec:cc-agents.hq-links
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.infra
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.orchestration
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 2

spec:decisions.coordination-native-first
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.isolated-infra-manages-hq
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.context
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 3

spec:decisions.client-material-deferred
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.environment
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.isolation
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 4

spec:hq.engineering-environment
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.session-handoff
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 5

spec:decisions.design-locked-by-projection
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.delivery-planning
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 6

spec:decisions.sdp-holds-the-plan
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 7

spec:hq.headquarters
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Distance 8

spec:architecture.cc-agents
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:architecture.inbox
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:architecture.relay
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.hq-starts-engineering
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.recovery-closed
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.separate-repositories
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:hq.model
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None

Relations

Relation and direction	Other end	Claim	Reason	Exercised keys
refines · outgoing	Orchestration lives in one plugin, apart from infra and HQ `spec:hq.orchestration` · resolves	declared	settles where generic orchestration lives and what runs jobs until then	None
decidedBy · incoming	The one tie between this repository's Specs and HQ's design `spec:cc-agents.hq-links` · resolves	declared	places the inbox and the chain in cc-agents and keeps the runner off	None
decidedBy · incoming	Infra delivers configuration by projection, under HQ's plan `spec:hq.infra` · resolves	declared	the ruling takes generic orchestration out of infra	None
decidedBy · incoming	Orchestration lives in one plugin, apart from infra and HQ `spec:hq.orchestration` · resolves	declared	the ruling places generic orchestration in Relay's rewrite	None

Bindings

Implementation binding: none

Design reference: none

Verifier binding: none

Expected-outcome oracle: none

Runtime observation: not tracked.

Run results: not recorded in the graph.

Findings

None.

Composing (0)

Composing needs the script.