Spec Studio

Agents script the visible graph

spec:decisions.agent-surface-scripts-graphDecision 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/agent-surface-scripts-graph.sdp.md

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

Intent
outcome
Give agents composable graph context without a fixed command vocabulary becoming the model.
Decision
context
Agents need decoded context and entry adapters without rebuilding graph joins.
decision
The typed graph is the visible contract and agents script it directly through a thin reader surface.
rationale
  • A verb wall duplicates graph semantics and hides composable data behind commands.
consequences
  • Entry adapters expose curated context while coverage gaps remain explicit rather than implied exhaustive.
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.agent-surface-scripts-graph

Arrows: refines (declared).

The diagram as text
  • spec:decisions.agent-surface-scripts-graph: Agents script the visible graph · declared Spec
  • spec:consumers.agent-surface: Agents script a visible typed graph · declared Spec
  • spec:decisions.agent-surface-scripts-graph refines spec:consumers.agent-surface · 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.agent-surface-scripts-graph
The diagram as text
  • spec:consumers.agent-surface: Agents script a visible typed graph
  • spec:consumers.reader: The reader bridges agent entry points to composable graph context
  • spec:decisions.agent-front-door: The agent front door is one evaluation sink over the exported reader
  • spec:decisions.agent-surface-scripts-graph: Agents script the visible graph
  • spec:decisions.agent-surface-scripts-graph refines spec:consumers.agent-surface · declared
  • spec:consumers.agent-surface decidedBy spec:decisions.agent-surface-scripts-graph · declared
  • spec:consumers.reader decidedBy spec:decisions.agent-surface-scripts-graph · declared
  • spec:decisions.agent-front-door dependsOn spec:decisions.agent-surface-scripts-graph · 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

Relations

Relation and directionOther endClaimReasonExercised keys
refines · outgoingAgents script a visible typed graph
spec:consumers.agent-surface · resolves		declaredNoneNone
decidedBy · incomingAgents script a visible typed graph
spec:consumers.agent-surface · resolves		declaredNoneNone
decidedBy · incomingThe reader bridges agent entry points to composable graph context
spec:consumers.reader · resolves		declaredNoneNone
dependsOn · incomingThe agent front door is one evaluation sink over the exported reader
spec:decisions.agent-front-door · 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.