HQ plans and designs across every project, and starts the engineering work

spec:hq.headquarters

Use Case / Behavior · epicdefined floor ready

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

Packs: none

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

design/hq/hq/headquarters.sdp.md

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

HQ is the owner's headquarters for about fifty projects. It works at the altitude of long-term planning, core design and cross-project context, away from the noise of detailed work. When a piece of the plan settles, HQ starts the detailed planning and the execution as sessions in the engineering environment, and reads back what they delivered.

The owner names three aspects and this design adds what connects them. Infra delivers configuration to machines and manages HQ's isolated environment. Delivery planning uses SDP across projects, with projections over them. An assistant capability handles the owner's recurring work outside engineering. Orchestration moves work between harnesses and models, the session handoff carries a settled piece into engineering, and the private context in Kontrapunkt stands behind all of them. Each is a feature that refines this Spec, and spec:hq.model holds their vocabulary. The systems behind them are component designs under specs/architecture/; the Studio's word planned means that no code in this repository realizes them, and several run today in their own repositories.

Intent

actor: The owner, running about fifty projects from one place.
problem: Planning spread across projects and sessions grows into master plans, briefs and status copied everywhere, with little delivered, and a session doing detailed work carries context its task does not need.
outcome: One isolated HQ holds the long-term plan, the core design and the cross-project context, and starts detailed planning and execution in the engineering environment once a piece settles.
value: The owner reads one plan from one graph, and each engineering session starts with only what its work needs.

Behavior

rule.altitude line 32 · design/hq/hq/headquarters.sdp.md:32: HQ plans and designs at the altitude of the plan and the core design; detailed planning, detailed design and execution happen in sessions HQ starts in the engineering environment.
no example exercises it
rule.settleFirst line 33 · design/hq/hq/headquarters.sdp.md:33: HQ starts a detailed session only for a piece of the plan that has settled: the decisions it rests on are made and its blocking questions are answered.
no example exercises it
rule.crossProject line 34 · design/hq/hq/headquarters.sdp.md:34: HQ holds the context that spans projects, and each project's repository holds that project's detail.
no example exercises it
rule.graphIsTruth line 35 · design/hq/hq/headquarters.sdp.md:35: What comes next, what each entry needs and what waits on the owner are read from this corpus's graph each time, and no status file, brief or plan document copies them.
no example exercises it

0 unkeyed rules.

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:hq.headquarters

Arrows: refines (declared).

The diagram as text

spec:hq.headquarters: HQ plans and designs across every project, and starts the engineering work · declared Spec · no satisfying binding
spec:architecture.cc-agents: cc-agents · declared Spec · no satisfying binding
spec:architecture.inbox: The inbox · declared Spec · no satisfying binding
spec:architecture.relay: Relay · declared Spec · no satisfying binding
spec:decisions.hq-starts-engineering: HQ does the core design and starts detailed work in the engineering environment · declared Spec
spec:decisions.recovery-closed: The recovery chain stops and this corpus replaces its master plan · declared Spec
spec:decisions.separate-repositories: Repositories stay separate, and the plan names work in them in prose · declared Spec
spec:hq.context: HQ's private context stays in one place and stays clean · declared Spec · no satisfying binding
spec:hq.delivery-planning: SDP carries delivery planning across projects · declared Spec · no satisfying binding
spec:hq.engineering-environment: The engineering environment runs apart from HQ · declared Spec · no satisfying binding
spec:hq.environment: HQ runs in an isolated environment that infra manages · declared Spec · no satisfying binding
spec:hq.infra: Infra delivers configuration by projection, under HQ's plan · declared Spec · no satisfying binding
spec:hq.model: HQ's vocabulary · declared Spec · no satisfying binding
spec:hq.orchestration: Orchestration lives in one plugin, apart from infra and HQ · declared Spec · no satisfying binding
spec:hq.session-handoff: HQ hands a settled piece to a detailed session · declared Spec · no satisfying binding
spec:cc-agents.hq-links: The one tie between this repository's Specs and HQ's design · declared Spec
spec:decisions.client-material-deferred: HQ holds everything until a per-project review screens client material · declared Spec
spec:decisions.coordination-native-first: Coordination is built on Claude Code's own messaging, and cc-agents adds only what that lacks · declared Spec
spec:decisions.design-locked-by-projection: An approved part of the graph reaches engineering as a read-only projection · declared Spec
spec:decisions.isolated-infra-manages-hq: Infra is super isolated and manages the isolated HQ · declared Spec
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:decisions.sdp-holds-the-plan: HQ's plan for all software delivery is an SDP corpus in a small repository of its own · declared Spec
spec:architecture.cc-agents refines spec:hq.headquarters · declared — one of the systems HQ's design names
spec:architecture.inbox refines spec:hq.headquarters · declared — one of the systems HQ's design names
spec:architecture.relay refines spec:hq.headquarters · declared — one of the systems HQ's design names
spec:cc-agents.hq-links refines spec:architecture.cc-agents · declared — the job runner and the coordination design are the parts of this component that exist in this repository
spec:cc-agents.hq-links refines spec:hq.orchestration · declared — this repository's coordination design answers the rules that HQ's orchestration states
spec:decisions.client-material-deferred refines spec:hq.context · declared — settles what HQ holds until per-project review
spec:decisions.coordination-native-first refines spec:hq.orchestration · declared — settles what coordination is built from once it leaves infra
spec:decisions.design-locked-by-projection refines spec:hq.session-handoff · declared — settles how a settled design reaches the engineering repository and stays locked
spec:decisions.hq-starts-engineering refines spec:hq.headquarters · declared — settles HQ's altitude and where detailed work happens
spec:decisions.isolated-infra-manages-hq refines spec:hq.infra · declared — records how infra and HQ stand towards each other
spec:decisions.orchestration-leaves-infra refines spec:hq.orchestration · declared — settles where generic orchestration lives and what runs jobs until then
spec:decisions.recovery-closed refines spec:hq.headquarters · declared — settles what of the recovery's master plan HQ's plan keeps
spec:decisions.sdp-holds-the-plan refines spec:hq.delivery-planning · declared — settles what carries HQ's plan and where it sits
spec:decisions.separate-repositories refines spec:hq.headquarters · declared — settles how HQ's plan touches other repositories
spec:hq.context refines spec:hq.headquarters · declared — names where HQ's context lives and how it stays clean
spec:hq.delivery-planning refines spec:hq.headquarters · declared — one of the aspects the owner names
spec:hq.engineering-environment refines spec:hq.headquarters · declared — the place HQ's work goes to be executed
spec:hq.environment refines spec:hq.headquarters · declared — gives HQ's isolation its home
spec:hq.infra refines spec:hq.headquarters · declared — one of the aspects the owner names
spec:hq.model refines spec:hq.headquarters · declared — names what the HQ design speaks of
spec:hq.orchestration refines spec:hq.headquarters · declared — names how work moves between harnesses, models and machines
spec:hq.session-handoff refines spec:hq.headquarters · declared — realizes how HQ starts the work it does not do itself

Mermaid source

Copyable source; the Studio draws static SVG.

Preferred syntax: requirementDiagram. Chosen syntax: flowchart TB because folds require exact labels unavailable in requirement syntax.

Mermaid source for Requirement drawing for spec:hq.headquarters

flowchart TB
  n0["14 refining Specs · declared, folded"]
  %% folded diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0: spec:architecture.cc-agents, spec:architecture.inbox, spec:architecture.relay, spec:decisions.hq-starts-engineering, spec:decisions.recovery-closed, spec:decisions.separate-repositories, spec:hq.context, spec:hq.delivery-planning, spec:hq.engineering-environment, spec:hq.environment, spec:hq.infra, spec:hq.model, spec:hq.orchestration, spec:hq.session-handoff
  n1["HQ plans and designs across every project, and starts the engineering work · declared Spec · no satisfying binding · spec:hq.headquarters"]
  n2["The one tie between this repository's Specs and HQ's design · declared Spec · spec:cc-agents.hq-links"]
  n3["HQ holds everything until a per-project review screens client material · declared Spec · spec:decisions.client-material-deferred"]
  n4["Coordination is built on Claude Code's own messaging, and cc-agents adds only what that lacks · declared Spec · spec:decisions.coordination-native-first"]
  n5["An approved part of the graph reaches engineering as a read-only projection · declared Spec · spec:decisions.design-locked-by-projection"]
  n6["Infra is super isolated and manages the isolated HQ · declared Spec · spec:decisions.isolated-infra-manages-hq"]
  n7["Generic orchestration moves from infra to cc-agents, and Relay runs jobs until cc-agents earns trust · declared Spec · spec:decisions.orchestration-leaves-infra"]
  n8["HQ's plan for all software delivery is an SDP corpus in a small repository of its own · declared Spec · spec:decisions.sdp-holds-the-plan"]
  n0 -->|"refines · declared (14 unit edges)"| n1
  %% count: 14; diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0 to spec:hq.headquarters
  n2 -->|"refines · declared (2 unit edges)"| n0
  %% count: 2; spec:cc-agents.hq-links to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0
  n3 -->|"refines · declared — settles what HQ holds until per-project review"| n0
  %% count: 1; spec:decisions.client-material-deferred to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0
  n4 -->|"refines · declared — settles what coordination is built from once it leaves infra"| n0
  %% count: 1; spec:decisions.coordination-native-first to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0
  n5 -->|"refines · declared — settles how a settled design reaches the engineering repository and stays locked"| n0
  %% count: 1; spec:decisions.design-locked-by-projection to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0
  n6 -->|"refines · declared — records how infra and HQ stand towards each other"| n0
  %% count: 1; spec:decisions.isolated-infra-manages-hq to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0
  n7 -->|"refines · declared — settles where generic orchestration lives and what runs jobs until then"| n0
  %% count: 1; spec:decisions.orchestration-leaves-infra to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0
  n8 -->|"refines · declared — settles what carries HQ's plan and where it sits"| n0
  %% count: 1; spec:decisions.sdp-holds-the-plan to diagram.spec:hq.headquarters.requirement.fold.refines.incoming.declared.band.0

Decisions

HQ does the core design and starts detailed work in the engineering environment
HQ does long-term planning, high-level design and cross-project context. When a piece settles, HQ starts detailed planning and execution as sessions in the engineering environment, and does not do that work itself.
The recovery chain stops and this corpus replaces its master plan
The recovery chain stops and this SDP corpus replaces its master plan. The scan items' purpose, recovering valid owner directions and sufficient evidence for rollback and takeover, remains with the context and infra Specs. Existing evidence is used first; any remaining investigation is bounded detailed work, not a revival of the recovery chain.
HQ's plan for all software delivery is an SDP corpus in a small repository of its own
HQ's plan for all software delivery is the SDP corpus of this repository, a small plain adopter that pins SDP and holds Specs and nothing else. It sits outside the system being bootstrapped, and it is not part of Kontrapunkt.
Repositories stay separate, and the plan names work in them in prose
There is no monorepo. HQ's plan, Kontrapunkt, infra, SDP, Relay and each project stay in their own repositories. A Spec here names work in another repository in prose, by repository and pull request, and this repository imports and calls nothing from them.

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:hq.headquarters

The diagram as text

spec:architecture.cc-agents: cc-agents
spec:architecture.inbox: The inbox
spec:architecture.relay: Relay
spec:decisions.hq-starts-engineering: HQ does the core design and starts detailed work in the engineering environment
spec:decisions.recovery-closed: The recovery chain stops and this corpus replaces its master plan
spec:decisions.sdp-holds-the-plan: HQ's plan for all software delivery is an SDP corpus in a small repository of its own
spec:decisions.separate-repositories: Repositories stay separate, and the plan names work in them in prose
spec:hq.context: HQ's private context stays in one place and stays clean
spec:hq.delivery-planning: SDP carries delivery planning across projects
spec:hq.engineering-environment: The engineering environment runs apart from HQ
spec:hq.environment: HQ runs in an isolated environment that infra manages
spec:hq.headquarters: HQ plans and designs across every project, and starts the engineering work
spec:hq.infra: Infra delivers configuration by projection, under HQ's plan
spec:hq.model: HQ's vocabulary
spec:hq.orchestration: Orchestration lives in one plugin, apart from infra and HQ
spec:hq.session-handoff: HQ hands a settled piece to a detailed session
spec:hq.headquarters decidedBy spec:decisions.hq-starts-engineering · declared — sets the altitude HQ works at and where detailed work happens
spec:hq.headquarters decidedBy spec:decisions.recovery-closed · declared — sets what of the recovery's master plan this plan keeps
spec:hq.headquarters decidedBy spec:decisions.sdp-holds-the-plan · declared — sets where the plan lives and what reads it
spec:hq.headquarters decidedBy spec:decisions.separate-repositories · declared — sets how HQ reaches work in other repositories
spec:architecture.cc-agents refines spec:hq.headquarters · declared — one of the systems HQ's design names
spec:architecture.inbox refines spec:hq.headquarters · declared — one of the systems HQ's design names
spec:architecture.relay refines spec:hq.headquarters · declared — one of the systems HQ's design names
spec:decisions.hq-starts-engineering refines spec:hq.headquarters · declared — settles HQ's altitude and where detailed work happens
spec:decisions.recovery-closed refines spec:hq.headquarters · declared — settles what of the recovery's master plan HQ's plan keeps
spec:decisions.separate-repositories refines spec:hq.headquarters · declared — settles how HQ's plan touches other repositories
spec:hq.context refines spec:hq.headquarters · declared — names where HQ's context lives and how it stays clean
spec:hq.delivery-planning refines spec:hq.headquarters · declared — one of the aspects the owner names
spec:hq.engineering-environment refines spec:hq.headquarters · declared — the place HQ's work goes to be executed
spec:hq.environment refines spec:hq.headquarters · declared — gives HQ's isolation its home
spec:hq.infra refines spec:hq.headquarters · declared — one of the aspects the owner names
spec:hq.model refines spec:hq.headquarters · declared — names what the HQ design speaks of
spec:hq.orchestration refines spec:hq.headquarters · declared — names how work moves between harnesses, models and machines
spec:hq.session-handoff refines spec:hq.headquarters · declared — realizes how HQ starts the work it does not do itself

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:hq.headquarters

flowchart TB
  n0["HQ's plan for all software delivery is an SDP corpus in a small repository of its own · spec:decisions.sdp-holds-the-plan"]
  n1["HQ plans and designs across every project, and starts the engineering work · spec:hq.headquarters"]
  n2["14 Incoming refines, folded · spec:hq.headquarters.fold.Incoming.refines"]
  %% folded spec:hq.headquarters.fold.Incoming.refines: spec:architecture.cc-agents, spec:architecture.inbox, spec:architecture.relay, spec:decisions.hq-starts-engineering, spec:decisions.recovery-closed, spec:decisions.separate-repositories, spec:hq.context, spec:hq.delivery-planning, spec:hq.engineering-environment, spec:hq.environment, spec:hq.infra, spec:hq.model, spec:hq.orchestration, spec:hq.session-handoff
  n1 -->|"decidedBy · declared — sets where the plan lives and what reads it"| n0
  %% count: 1; spec:hq.headquarters to spec:decisions.sdp-holds-the-plan
  n1 -->|"decidedBy · declared (3 unit edges)"| n2
  %% count: 3; spec:hq.headquarters to spec:hq.headquarters.fold.Incoming.refines
  n2 -->|"refines · declared (14 unit edges)"| n1
  %% count: 14; spec:hq.headquarters.fold.Incoming.refines to spec:hq.headquarters

Rests on

decidedBy · spec:decisions.hq-starts-engineering · stated defined, floor ready
decidedBy · spec:decisions.recovery-closed · stated defined, floor ready
decidedBy · spec:decisions.sdp-holds-the-plan · stated defined, floor ready
decidedBy · spec:decisions.separate-repositories · stated defined, floor ready

Rested on by

Distance 1

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.context
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
spec:hq.engineering-environment
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.infra
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
spec:hq.orchestration
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 2

spec:cc-agents.hq-links
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.client-material-deferred
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.coordination-native-first
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.design-locked-by-projection
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:decisions.orchestration-leaves-infra
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
spec:decisions.sdp-holds-the-plan
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

Relations

Relation and direction	Other end	Claim	Reason	Exercised keys
decidedBy · outgoing	HQ does the core design and starts detailed work in the engineering environment `spec:decisions.hq-starts-engineering` · resolves	declared	sets the altitude HQ works at and where detailed work happens	None
decidedBy · outgoing	The recovery chain stops and this corpus replaces its master plan `spec:decisions.recovery-closed` · resolves	declared	sets what of the recovery's master plan this plan keeps	None
decidedBy · outgoing	HQ's plan for all software delivery is an SDP corpus in a small repository of its own `spec:decisions.sdp-holds-the-plan` · resolves	declared	sets where the plan lives and what reads it	None
decidedBy · outgoing	Repositories stay separate, and the plan names work in them in prose `spec:decisions.separate-repositories` · resolves	declared	sets how HQ reaches work in other repositories	None
refines · incoming	cc-agents `spec:architecture.cc-agents` · resolves	declared	one of the systems HQ's design names	None
refines · incoming	The inbox `spec:architecture.inbox` · resolves	declared	one of the systems HQ's design names	None
refines · incoming	Relay `spec:architecture.relay` · resolves	declared	one of the systems HQ's design names	None
refines · incoming	HQ does the core design and starts detailed work in the engineering environment `spec:decisions.hq-starts-engineering` · resolves	declared	settles HQ's altitude and where detailed work happens	None
refines · incoming	The recovery chain stops and this corpus replaces its master plan `spec:decisions.recovery-closed` · resolves	declared	settles what of the recovery's master plan HQ's plan keeps	None
refines · incoming	Repositories stay separate, and the plan names work in them in prose `spec:decisions.separate-repositories` · resolves	declared	settles how HQ's plan touches other repositories	None
refines · incoming	HQ's private context stays in one place and stays clean `spec:hq.context` · resolves	declared	names where HQ's context lives and how it stays clean	None
refines · incoming	SDP carries delivery planning across projects `spec:hq.delivery-planning` · resolves	declared	one of the aspects the owner names	None
refines · incoming	The engineering environment runs apart from HQ `spec:hq.engineering-environment` · resolves	declared	the place HQ's work goes to be executed	None
refines · incoming	HQ runs in an isolated environment that infra manages `spec:hq.environment` · resolves	declared	gives HQ's isolation its home	None
refines · incoming	Infra delivers configuration by projection, under HQ's plan `spec:hq.infra` · resolves	declared	one of the aspects the owner names	None
refines · incoming	HQ's vocabulary `spec:hq.model` · resolves	declared	names what the HQ design speaks of	None
refines · incoming	Orchestration lives in one plugin, apart from infra and HQ `spec:hq.orchestration` · resolves	declared	names how work moves between harnesses, models and machines	None
refines · incoming	HQ hands a settled piece to a detailed session `spec:hq.session-handoff` · resolves	declared	realizes how HQ starts the work it does not do itself	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.