Spec Studio

Sections carry content while relations carry links

spec:decisions.content-only-sectionsDecision Record · featureready floor ready

Packs: pack:self-hosting-v1

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

Findings: no errors, no warnings

specs/decisions/content-only-sections.sdp.md

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

Intent
outcome
Keep inline detail and promoted Specs from representing the same fact twice.
Decision
context
Behavior content can mature from prose to structured evidence or into a standalone matching-kind Spec.
decision
Sections contain local content only; promotion moves content exclusively and relations state the linkage.
rationale
  • Reference unions and duplicate parent lists force consumers to branch and leave double-linkage drift legal.
consequences
  • Promoted children preserve readiness evidence through their own content and authored relations.
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.content-only-sections

Arrows: refines (declared).

The diagram as text
  • spec:decisions.content-only-sections: Sections carry content while relations carry links · declared Spec
  • spec:model.spec-sections: Spec sections carry typed detail and direct verifier semantics · declared Spec
  • spec:decisions.content-only-sections refines spec:model.spec-sections · declared
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
Relations of spec:decisions.content-only-sections
The diagram as text
  • spec:decisions.carried-evidence: Promoted evidence must carry its own evidence
  • spec:decisions.checked-mentions: A Spec id written in prose is a checked mention
  • spec:decisions.content-only-sections: Sections carry content while relations carry links
  • spec:model.spec-sections: Spec sections carry typed detail and direct verifier semantics
  • spec:decisions.content-only-sections refines spec:model.spec-sections · declared
  • spec:model.spec-sections decidedBy spec:decisions.content-only-sections · declared
  • spec:decisions.carried-evidence dependsOn spec:decisions.content-only-sections · declared
  • spec:decisions.checked-mentions dependsOn spec:decisions.content-only-sections · declared
Mermaid source

Copyable source; the Studio draws static SVG.

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

Rests on

Rested on by

Distance 1

Distance 2

Distance 3

Distance 4

Distance 5

Distance 6

Distance 7

Distance 8

Distance 9

Distance 10

Relations

Relation and directionOther endClaimReasonExercised keys
refines · outgoingSpec sections carry typed detail and direct verifier semantics
spec:model.spec-sections · resolves
declaredNoneNone
decidedBy · incomingSpec sections carry typed detail and direct verifier semantics
spec:model.spec-sections · resolves
declaredNoneNone
dependsOn · incomingPromoted evidence must carry its own evidence
spec:decisions.carried-evidence · resolves
declaredNoneNone
dependsOn · incomingA Spec id written in prose is a checked mention
spec:decisions.checked-mentions · resolves
declaredNoneNone

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.