outcomeHQ does the core design and starts detailed work in the engineering environment
spec:decisions.hq-starts-engineeringNext rung ready: nothing blocks; it waits only for the author's statement.
Packs: none
Design: no design entries · no pinned declarations · no decisions
Findings: no errors, no warnings
specs/decisions/hq-starts-engineering.sdp.md
No open questions and no blocking questions; implementation binding none, verifier binding none, and expected-outcome oracle none.
Intent
- Decide what HQ does itself and what it starts elsewhere.
Decision
context- The owner said on 30 October that HQ does the core design and initiates detailed design and implementation in the engineering fleet, and then gave the fuller reading: isolation means HQ can do long-term planning and high-level design, and when things settle, to reduce the noise and to have cross-project context, it actually initiates detailed planning and execution sessions in the engineering environment.
decision- 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.
rationale- Hard to reverse: it fixes the altitude of every Spec here. Surprising without context: HQ is the owner's most capable context and still writes no code. A real trade-off: HQ loses the speed of working directly and keeps a context with little noise, which is the reason for isolating it.
alternatives- HQ delivers directly into repositories: that was the bootstrap, and it produced the noise the owner is reducing.
- HQ writes detailed plans for sessions to follow: it would grow the briefs this design removes, and it would plan without the target repository's knowledge.
consequences- This corpus stays at HQ's altitude, and detailed design lands in the target repositories.
- Delivery depends on the session handoff, so its seam comes early on the roadmap.
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.
Arrows: refines (declared).
The diagram as text
- spec:decisions.hq-starts-engineering: HQ does the core design and starts detailed work in the engineering environment · declared Spec
- spec:hq.headquarters: HQ plans and designs across every project, and starts the engineering work · declared Spec
- spec:decisions.hq-starts-engineering refines spec:hq.headquarters · declared — settles HQ's altitude and where detailed work happens
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.
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
- E2: decidedBy · declared — sets the altitude HQ works at and where detailed work happens
The diagram as text
- spec:decisions.hq-starts-engineering: HQ does the core design and starts detailed work in the engineering environment
- spec:hq.headquarters: HQ plans and designs across every project, and starts the engineering work
- spec:hq.session-handoff: HQ hands a settled piece to a detailed session
- spec:decisions.hq-starts-engineering refines spec:hq.headquarters · declared — settles HQ's altitude and where detailed work happens
- spec:hq.headquarters decidedBy spec:decisions.hq-starts-engineering · declared — sets the altitude HQ works at and where detailed work happens
- spec:hq.session-handoff decidedBy spec:decisions.hq-starts-engineering · declared — the ruling makes the session the only way detailed work leaves HQ
Mermaid source
Copyable source; the Studio draws static SVG.
Preferred syntax: flowchart. Chosen syntax: labelled flowchart, preserving exact relations, claims and folds.
Rests on
- refines · spec:hq.headquarters · stated defined, floor ready
Rested on by
Distance 1
- spec:hq.headquarters
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: pack:hq-roadmap
Distance 2
- spec:architecture.assistant
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.cc-agents
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.claude-harness
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.environments
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.hq
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.hq-plan
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.infra
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.kontrapunkt
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:architecture.sdp
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: None
- spec:architecture.t3-code
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.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.assistant
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: pack:hq-roadmap
- spec:hq.context
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: pack:hq-roadmap
- spec:hq.delivery-planning
Implementing units
None.
Referencing units
None.
Enabled verifiers: None
Packs: pack:hq-roadmap
- 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: pack:hq-roadmap
- 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: pack:hq-roadmap
Distance 3
- 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.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 |
|---|---|---|---|---|
| refines · outgoing | HQ plans and designs across every project, and starts the engineering workspec:hq.headquarters · resolves | declared | settles HQ's altitude and where detailed work happens | None |
| decidedBy · incoming | HQ plans and designs across every project, and starts the engineering workspec:hq.headquarters · resolves | declared | sets the altitude HQ works at and where detailed work happens | None |
| decidedBy · incoming | HQ hands a settled piece to a detailed sessionspec:hq.session-handoff · resolves | declared | the ruling makes the session the only way detailed work leaves HQ | 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.