Spec Studio

Decisions

Recipe 31, the decision register.

  • 47 decisions.
  • 47 decisions stated ready.
  • 0 superseded decisions.
  • 0 decisions shaping no Spec.

Delivery nouns remain familiar without workflow gates

spec:decisions.adopt-the-nouns · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:model.open-question-fields, spec:protocol.self-hosting

Questions: None

Adopted runnable registrars are committed

spec:decisions.adopted-registrars-committed · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:extraction.runnable-modules

Questions: None

The agent front door is one evaluation sink over the exported reader

spec:decisions.agent-front-door · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 6 Specs · spec:consumers.agent-surface, spec:consumers.agent-surface.evaluation-sink, spec:consumers.agent-surface.recipe-parameters, spec:consumers.context-bundle, spec:consumers.reader, spec:consumers.reading-on-ramp

Questions: None

Agents script the visible graph

spec:decisions.agent-surface-scripts-graph · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:consumers.agent-surface, spec:consumers.reader

Questions: None

Bindings are optional, plural, and may reference a design

spec:decisions.anchor-binding-grain · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.shipped-projections-frozencarves out the Design Review's Referenced by list and the census References table

Refined by: None

Shapes: 9 Specs · spec:consumers.authoring-on-ramp, spec:consumers.census-page, spec:consumers.design-review, spec:consumers.design-slice, spec:consumers.reader, spec:extraction.derive-graph, spec:model.anchors, spec:protocol.significant-units-review, spec:protocol.structural-self-binding

Questions: None

The comment form is a second anchor representation

spec:decisions.anchor-comment-form · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 4 Specs · spec:consumers.authoring-on-ramp, spec:extraction.runnable-modules, spec:model.anchors, spec:model.spec-sections

Questions: None

Architectural significance is annotated where it is realized

spec:decisions.architectural-annotation · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.shipped-projections-frozencarves out the census Roles, Layers and Contexts tables and the role, layer and context on the Design Review's code unit rows

Refined by: None

Shapes: 15 Specs · spec:consumers.authoring-on-ramp, spec:consumers.census-page, spec:consumers.design-review, spec:consumers.design-slice, spec:consumers.impact-graph.curation-assist, spec:consumers.pack-design, spec:consumers.spec-studio.lenses.architecture, spec:model.anchors, spec:model.planned-architecture, spec:model.structural-patterns, spec:protocol.role-vocabulary, spec:protocol.significant-units-review, spec:protocol.structural-self-binding, spec:validation.architecture-constraints, spec:validation.corpus-rules

Questions: None

The Design Review renders open-section entries as a list

spec:decisions.authored-entry-order · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.shipped-projections-frozencarves out how the Design Review renders open-section entries, as a list in authored order

Refined by: None

Shapes: 3 Specs · spec:consumers.design-review, spec:consumers.spec-studio.spec-page, spec:consumers.spec-studio.spec-page.core

Questions: None

Bindings state existence, not liveness

spec:decisions.binding-not-liveness · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 10 Specs · spec:consumers.binding-language-views, spec:consumers.spec-studio.lenses.evidence, spec:consumers.spec-studio.lenses.tests, spec:consumers.spec-studio.runs-page, spec:consumers.spec-studio.verification-panels, spec:extraction.delivery-facts, spec:extraction.runnable-modules, spec:model.anchors, spec:observation.run-evidence, spec:validation.authored-honesty

Questions: None

Promoted evidence must carry its own evidence

spec:decisions.carried-evidence · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:validation.kind-evidence, spec:validation.readiness-floor

Questions: None

Markdown is the default Spec carrier

spec:decisions.carrier-ruling · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: spec:decisions.gherkin-carrier-optionadmits Gherkin as a canonical per-ID carrier for behavior and example Specs beside the Markdown default, spec:decisions.pack-markdown-carrierextends the Markdown carrier to Packs and keeps the TypeScript builder as a per-ID option

Shapes: 3 Specs · spec:carrier.markdown-authoring, spec:carrier.markdown-body-grammar, spec:carrier.sdp-import

Questions: None

Carrier universality is bounded by honest kind structure

spec:decisions.carrier-universality · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.gherkin-carrier-optionsettles the admitted description prose and the meaning of universality as a generated read projection, while reaffirming the behavior and example kind bound

Refined by: None

Shapes: 2 Specs · spec:carrier.gherkin-authoring, spec:consumers.gherkin-view

Questions: None

A Spec id written in prose is a checked mention

spec:decisions.checked-mentions · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 5 Specs · spec:model.open-question-keys, spec:model.rule-keys, spec:model.stable-ids, spec:model.term-addresses, spec:validation.prose-mentions

Questions: None

Concept documents may dissolve after executable truth lands

spec:decisions.concept-docs-dissolve · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:protocol.self-hosting

Questions: None

Sections carry content while relations carry links

spec:decisions.content-only-sections · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:model.spec-sections

Questions: None

Decision records state readiness from ratification evidence

spec:decisions.decision-readiness-posture · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 3 Specs · spec:consumers.adopter-on-ramp, spec:consumers.reader, spec:validation.warn-level-signals

Questions: None

The Protocol owns the envelope grammar

spec:decisions.envelope-grammar-posture · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:carrier.envelope-contract

Questions: None

Capability epics keep kind independent of altitude

spec:decisions.epics-of-any-kind · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:consumers.capability-map, spec:protocol.capability-epics

Questions: None

Example realization stays evidence, not backlog work

spec:decisions.example-realization-posture · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:model.core-model

Questions: None

Consumer exclusions stay exact

spec:decisions.exclusion-contract · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:extraction.excludes

Questions: None

The Protocol is an executable meta-model

spec:decisions.executable-meta-model · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:protocol.self-hosting

Questions: None

Behavior and example Specs may use Gherkin canonically

spec:decisions.gherkin-carrier-option · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.carrier-rulingadmits Gherkin as a canonical per-ID carrier for behavior and example Specs beside the Markdown default

Refined by: spec:decisions.carrier-universalitysettles the admitted description prose and the meaning of universality as a generated read projection, while reaffirming the behavior and example kind bound, spec:decisions.sdp-gherkin-extensionfixes the canonical Gherkin suffix as .sdp.gherkin and keeps bare .feature files out of discovery

Shapes: 1 Spec · spec:carrier.gherkin-authoring

Questions: None

Readiness evidence follows the Spec kind

spec:decisions.kind-conditional-floor · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:validation.kind-evidence, spec:validation.readiness-floor

Questions: None

MCP integration remains deferred

spec:decisions.mcp-deferred · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:consumers.projections-model

Questions: None

One Spec carries named delivery coordinates

spec:decisions.one-primitive · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:model.core-model

Questions: None

Validation follows one graph

spec:decisions.one-validation-path · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 3 Specs · spec:extraction.derive-graph, spec:protocol.self-hosting, spec:validation.two-check-families

Questions: None

The Design Review's Pack page presents the Pack's design

spec:decisions.pack-design-page · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.shipped-projections-frozencarves out the Pack page, which renders the Pack design

Refined by: None

Shapes: 1 Spec · spec:consumers.design-review.pack-design-page

Questions: None

Packs have a Markdown manifest carrier

spec:decisions.pack-markdown-carrier · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.carrier-rulingextends the Markdown carrier to Packs and keeps the TypeScript builder as a per-ID option

Refined by: spec:decisions.roadmap-priorityopens the closed Pack manifest envelope to one optional field, order

Shapes: 2 Specs · spec:carrier.gherkin-authoring, spec:carrier.markdown-pack-authoring

Questions: None

Packs group review context without becoming truth

spec:decisions.pack-reified · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:model.pack-aggregate

Questions: None

Durable references lead with meaning

spec:decisions.plain-language-references · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:protocol.self-hosting

Questions: None

Planning truths live in ruled graph homes

spec:decisions.planning-truths-placement · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: spec:decisions.roadmap-over-plansnarrows what a plan file may still carry once a roadmap holds priority, spec:decisions.roadmap-prioritynarrows the refusal of recorded work order for one case, the advisory priority of a roadmap

Shapes: 7 Specs · spec:consumers.adopter-on-ramp, spec:consumers.delivery-session-on-ramp, spec:consumers.graph-first-planning, spec:consumers.impact-graph.symbol-reach, spec:model.open-question-fields, spec:model.relations, spec:validation.superseded-decision-signal

Questions: None

Each example binds one point

spec:decisions.point-per-example · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 3 Specs · spec:extraction.executable-contracts, spec:extraction.runnable-modules, spec:model.spec-sections

Questions: None

Prose belongs to typed graph owners

spec:decisions.prose-ownership · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 5 Specs · spec:carrier.gherkin-authoring, spec:carrier.markdown-body-grammar, spec:carrier.prose-ownership-rule, spec:consumers.gherkin-view, spec:model.relation-reasons

Questions: None

The meta-model is a software delivery protocol

spec:decisions.protocol-naming · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:protocol.self-hosting

Questions: None

The Design Review shows an open question's key

spec:decisions.question-key-rendering · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.shipped-projections-frozencarves out one change, an open question's key shown before its text

Refined by: None

Shapes: 1 Spec · spec:consumers.design-review

Questions: None

Plan and review files stop carrying the delivery record once the roadmap and the pull request do

spec:decisions.roadmap-over-plans · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.planning-truths-placementnarrows what a plan file may still carry once a roadmap holds priority

Refined by: None

Shapes: 2 Specs · spec:protocol.delivery-record-cleanup, spec:protocol.roadmap-replaces-plans

Questions: None

A roadmap states advisory priority in the graph

spec:decisions.roadmap-priority · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.pack-markdown-carrieropens the closed Pack manifest envelope to one optional field, order, spec:decisions.planning-truths-placementnarrows the refusal of recorded work order for one case, the advisory priority of a roadmap

Refined by: None

Shapes: 5 Specs · spec:carrier.markdown-pack-authoring, spec:consumers.design-diff, spec:consumers.roadmap, spec:extraction.pack-member-order, spec:model.pack-aggregate

Questions: None

Canonical Gherkin carriers use .sdp.gherkin

spec:decisions.sdp-gherkin-extension · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.gherkin-carrier-optionfixes the canonical Gherkin suffix as .sdp.gherkin and keeps bare .feature files out of discovery

Refined by: None

Shapes: 1 Spec · spec:carrier.gherkin-authoring

Questions: None

Spec extensions identify the carrier without colliding with tests

spec:decisions.sdp-ts-extension · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:carrier.markdown-authoring

Questions: None

The shipped projections stay frozen

spec:decisions.shipped-projections-frozen · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: spec:decisions.anchor-binding-graincarves out the Design Review's Referenced by list and the census References table, spec:decisions.architectural-annotationcarves out the census Roles, Layers and Contexts tables and the role, layer and context on the Design Review's code unit rows, spec:decisions.authored-entry-ordercarves out how the Design Review renders open-section entries, as a list in authored order, spec:decisions.pack-design-pagecarves out the Pack page, which renders the Pack design, spec:decisions.question-key-renderingcarves out one change, an open question's key shown before its text

Shapes: 14 Specs · spec:carrier.step-keys, spec:consumers.census-page, spec:consumers.command-line, spec:consumers.design-review, spec:consumers.gherkin-view, spec:consumers.mermaid-view, spec:consumers.obsidian-vault, spec:consumers.projections-model, spec:consumers.spec-studio, spec:consumers.spec-studio.diagram-kinds.mermaid-source, spec:consumers.spec-studio.publisher, spec:consumers.structural-mermaid, spec:model.rule-keys, spec:model.term-addresses

Questions: None

The build renders every Studio view, and an element only enhances it

spec:decisions.studio-build-renders · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.studio-web-componentsnarrows where a view's values come from; the build writes them into the markup, so a host carries that markup and supplies no graph data

Refined by: None

Shapes: 2 Specs · spec:consumers.spec-studio, spec:consumers.spec-studio.components

Questions: None

The engine lays out every Studio diagram as static SVG when the page set is built

spec:decisions.studio-diagram-renderer · ready

Supersedes: None

Superseded by: None

Refines: spec:decisions.studio-web-componentsnarrows how an element that shows a diagram renders it; the element only enhances an SVG the build drew

Refined by: None

Shapes: 4 Specs · spec:consumers.spec-studio.components, spec:consumers.spec-studio.diagram-kinds, spec:consumers.spec-studio.diagram-kinds.mermaid-source, spec:consumers.spec-studio.diagrams

Questions: None

The Studio renders HTML, and the HTML stays derived

spec:decisions.studio-html-surface · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 1 Spec · spec:consumers.spec-studio

Questions: None

The Studio is built from custom elements, not a framework

spec:decisions.studio-web-components · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: spec:decisions.studio-build-rendersnarrows where a view's values come from; the build writes them into the markup, so a host carries that markup and supplies no graph data, spec:decisions.studio-diagram-renderernarrows how an element that shows a diagram renders it; the element only enhances an SVG the build drew

Shapes: 3 Specs · spec:consumers.spec-studio, spec:consumers.spec-studio.components, spec:consumers.spec-studio.page-elements

Questions: None

Floor-read sections are closed typed shapes

spec:decisions.typing-law · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:extraction.contract-declarations, spec:model.spec-sections

Questions: None

The vault's generator owns one folder and synchronizes it

spec:decisions.vault-owned-folder · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 2 Specs · spec:consumers.obsidian-vault, spec:consumers.vault-on-ramp

Questions: None

Verification mode states posture, not realization

spec:decisions.verification-posture-not-realization · ready

Supersedes: None

Superseded by: None

Refines: None

Refined by: None

Shapes: 3 Specs · spec:consumers.spec-studio.lenses.tests, spec:consumers.spec-studio.verification-panels, spec:model.spec-sections

Questions: None

Composing (0)

Composing needs the script.