Spec Studio

Composed intent hands off on one proposal shape

spec:consumers.intent-compositionUse Case / Behavior · storyready floor ready

Packs: pack:self-hosting-v1

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

Findings: no errors, no warnings

specs/consumers/intent-composition.sdp.md

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

The edit model, spec:consumers.edit-model, owns the intent, agent and git law. This Spec owns how a composing surface hands its intent off.

Intent
actor
A person or an agent reading a view who wants a design change made.
problem
Each composing surface could invent its own hand-off, so a reviewer, an agent and a check would read one change in as many shapes as there are surfaces.
outcome
Give every surface that composes scoped intent one hand-off shape, applied as an ordinary edit.
Behavior
rule line 19 · specs/consumers/intent-composition.sdp.md:19
Every surface that composes scoped intent, including the Studio's composing panel, hands off on the one change-proposal contract, spec:consumers.intent-composition.proposal.
rule line 20 · specs/consumers/intent-composition.sdp.md:20
A composing surface writes no source.
rule.changedScope line 21 · specs/consumers/intent-composition.sdp.md:21
A composed proposal is applied after its proposal check: the applying caller sends a change whose scope changed since the base to a person instead of applying it and applies every other change as an ordinary edit, so one changed scope never holds back the whole proposal; the edit lands only from a worktree on which sdp validate reports no error, and the conformance and honesty checks stay the only gate.

no example exercises it

Cited at

  • test/skills.test.ts:1675

2 unkeyed rules.

Verification

Verifier bindings

  • test:protocol.studio-intent-handoff · anchored · test anchor binding present · test/studio-s5.test.ts:407

    External run evidence from test/studio-s5.test.ts

    Test anchors: test:protocol.studio-export-contained, test:protocol.studio-intent-handoff, test:protocol.studio-intents-refresh, test:protocol.studio-memo-shared, test:protocol.studio-watch-plain. Specs verified by those bindings: spec:consumers.edit-model, spec:consumers.intent-composition, spec:consumers.intent-composition.proposal.memo, spec:consumers.intent-composition.proposal.memo.shared, spec:consumers.spec-studio.components, spec:consumers.spec-studio.export, spec:consumers.spec-studio.export.self-contained, spec:consumers.spec-studio.intent-panel, spec:consumers.spec-studio.intent-panel.refresh-keeps-intents, spec:consumers.spec-studio.publisher.watch, spec:consumers.spec-studio.publisher.watch.matches-plain-run, spec:consumers.spec-studio.responsive.

    Run 1: external run evidence from vitest 4.1.10

    Build: CI 380 · Branch: feature/roadmap-and-slices-v0 · Commit: 34909918bf0be0e849959644401797191cae379f · Start: 2026-10-22T17:40:31.456Z · Stop: 2026-10-22T17:42:16.171Z

    NameSuiteResultDuration
    executes the bound example against a fresh worldRefreshing a tab keeps every gathered intent (spec:consumers.spec-studio.intent-panel.refresh-keeps-intents)passed10.32 ms
    executes the bound example against a fresh worldRecipe 49 and the composing panel write one memo for one proposal (spec:consumers.intent-composition.proposal.memo.shared)passed4.64 ms
    executes the bound example against a fresh worldA Pack's export opens alone and keeps its links inside it (spec:consumers.spec-studio.export.self-contained)passed63.72 ms
    executes the bound example against a fresh worldEach watch cycle writes the page set a plain run writes (spec:consumers.spec-studio.publisher.watch.matches-plain-run)passed133.79 ms
    keeps unsupported intents apart and expands Pack members only against the stamped basenot recordedpassed2.36 ms
    returns the same schema problems as recipe 38 and renders in any corpusnot recordedpassed8.22 ms
    composes locally without changing source or requesting a network servicenot recordedpassed1.63 ms
    keeps the last local intents when storage refuses writesnot recordedpassed0.28 ms
    keeps unsaved local intents when storage remains readable but its quota refuses writesnot recordedpassed0.34 ms
    rewrites SVG and accessibility references without changing subject attributes or authored textnot recordedpassed3.98 ms
    opens disclosures for print and restores exactly their prior statenot recordedpassed1.63 ms
    leaves Mermaid source closed for print unless the reader opened itnot recordedpassed1.13 ms
    stops the actual Studio watch process with exit zero on SIGINTnot recordedpassed492.7 ms
    removes a failed watch publication, keeps watching and recovers on the next carrier editnot recordedpassed38.33 ms
    ships a phone layout and a print stylesheet for the whole canvasnot recordedpassed14.52 ms
    keeps exports graph-only when the browsing pages receive a base and run recordsnot recordedpassed25.05 ms
    starts no cycle for source or input-file eventsnot recordedpassed26.7 ms
    merges concurrent panels before gathering or discarding and flags rejected storage recordsnot recordedpassed0.51 ms
    refreshes the browser panel on storage and pageshow and removes those listeners on disconnectnot recordedpassed1.55 ms
    prefills compose with the authored entry text including code spans and no rendered annotationsnot recordedpassed13.61 ms
    omits blank exact text and reports whitespace requests in the compose dialognot recordedpassed2.32 ms
    uses the stamp base, labels fields, orders actions and copies and saves the named documentsnot recordedpassed4.06 ms
    copies distinct actions and recorded scopes for both Pack choices without a stampnot recordedpassed3.09 ms
    keeps Pack framing changes apart and gathers scenario editor steps verbatimnot recordedpassed2.64 ms
    matches the literal memo for the shared proposal, including the full relation and documentnot recordedpassed0.82 ms
    keeps the last watch pages when an optional base becomes unreadable, just like a plain runnot recordedpassed1014.27 ms
    inlines the selected stylesheet asset in exports and publishes those same style bytesnot recordedpassed22.14 ms
    introduces studio before its watch option and gives recipe 49 a use casenot recordedpassed1.43 ms
    renders edit scenario steps outside inert templates without scriptnot recordedpassed1.08 ms
    renders propose scenario steps outside inert templates without scriptnot recordedpassed0.75 ms
    writes both memo reasons as code spans: "<details>Review the design.</details>", "`Keep` the ``literal`` reason`"not recordedpassed0.71 ms
    writes both memo reasons as code spans: "`Review` the ``design`` reason`", "<details>Keep the change.</details>"not recordedpassed0.44 ms
    fences requests so their Markdown cannot alter the memo: "Fix a typo.\n<!--"not recordedpassed0.96 ms
    fences requests so their Markdown cannot alter the memo: "Use this text.\n```\n## Forged heading\n``````\n<!--hidden-->"not recordedpassed0.81 ms
    contains phone navigation, stamp and wide tables within the viewportnot recordedpassed12.93 ms
    keeps the maturity caption readable and empty cells compact on a phonenot recordedpassed25.57 ms
    aligns maturity cell counts with the empty cell dashesnot recordedpassed14.09 ms
    keeps table headers and one-word cells intact while allowing word-boundary wrappingnot recordedpassed18.22 ms
    keeps natural desktop diagram size and fits only on phonesnot recordedpassed10.27 ms
    hides phone scroll advice and closed source in print while keeping opened source printablenot recordedpassed13.92 ms
Design view

Requirement drawing

Requirement drawing for spec:consumers.intent-composition

Shown as text: this drawing exceeds the height budget of 2000 pixels after folding.

The diagram as text
  • spec:consumers.intent-composition: Composed intent hands off on one proposal shape · declared Spec · no satisfying binding
  • spec:consumers.intent-composition.proposal: A change proposal is addressed, based and checked before it lands · declared Spec
  • spec:consumers.spec-studio.intent-panel: A composing panel on every page gathers scoped intent for an agent · declared Spec
  • spec:consumers.spec-studio.intent-panel.refresh-keeps-intents: Refreshing a tab keeps every gathered intent · declared Spec
  • spec:consumers.edit-model: Views compose scoped intent instead of patching canonical source · declared Spec
  • spec:consumers.intent-composition.proposal.memo: Recipe 49 renders a change proposal as the Markdown memo a person reviews · declared Spec
  • impl:protocol.proposal-schema-and-recipe: realizes the shipped proposal schema and proposal check in the recipe catalog · anchored code · test/iteration-recipes.test.ts:1510
  • impl:protocol.studio-compose: opens a native request dialog beside build-rendered scopes without changing their content · anchored code · src/studio-elements/compose.ts:13
  • impl:protocol.studio-frame: renders Studio navigation, page rails and composing controls · anchored code · src/projections/studio/pages/frame.ts:6
  • impl:protocol.studio-intent-panel: gathers ordered intents under the page-root storage key and partitions their hand-off · anchored code · src/studio-elements/intent-panel.ts:51
  • impl:protocol.studio-intent-panel-element: displays gathered requests and writes copy selections or local download links · anchored code · src/studio-elements/intent-panel-element.ts:14
  • impl:protocol.studio-proposal-contract: browser proposal shape and schema checks · anchored code · src/studio-elements/proposal.ts:1
  • impl:protocol.studio-scenario-editor: gathers the edited Given, When and Then as exact text scoped to its subject · anchored code · src/studio-elements/scenario-editor.ts:17
  • oracle:protocol.studio-intents: oracle:protocol.studio-intents · anchored oracle binding · test/studio-s5.test.ts:239
  • test:protocol.proposal-schema-and-recipe: test:protocol.proposal-schema-and-recipe · anchored test binding · binding present · test/iteration-recipes.test.ts:1517
  • test:protocol.studio-intent-handoff: test:protocol.studio-intent-handoff · anchored test binding · binding present · test/studio-s5.test.ts:407
  • test:protocol.studio-intents-refresh: test:protocol.studio-intents-refresh · anchored test binding · binding present · test/studio-s5.test.ts:249
  • spec:consumers.intent-composition refines spec:consumers.edit-model · declared
  • spec:consumers.intent-composition.proposal refines spec:consumers.intent-composition · declared
  • spec:consumers.intent-composition.proposal.memo refines spec:consumers.intent-composition.proposal · declared
  • spec:consumers.spec-studio.intent-panel refines spec:consumers.intent-composition · declared
  • spec:consumers.spec-studio.intent-panel.refresh-keeps-intents refines spec:consumers.spec-studio.intent-panel · declared
  • spec:consumers.spec-studio.intent-panel.refresh-keeps-intents verifies spec:consumers.spec-studio.intent-panel · declared
  • impl:protocol.proposal-schema-and-recipe satisfies spec:consumers.intent-composition.proposal · anchored
  • impl:protocol.studio-compose satisfies spec:consumers.spec-studio.intent-panel · anchored
  • impl:protocol.studio-frame satisfies spec:consumers.spec-studio.intent-panel · anchored
  • impl:protocol.studio-intent-panel satisfies spec:consumers.spec-studio.intent-panel · anchored
  • impl:protocol.studio-intent-panel references spec:consumers.intent-composition · anchored
  • impl:protocol.studio-intent-panel-element satisfies spec:consumers.spec-studio.intent-panel · anchored
  • impl:protocol.studio-intent-panel-element references spec:consumers.intent-composition · anchored
  • impl:protocol.studio-proposal-contract satisfies spec:consumers.intent-composition.proposal · anchored
  • impl:protocol.studio-scenario-editor satisfies spec:consumers.spec-studio.intent-panel · anchored
  • oracle:protocol.studio-intents models spec:consumers.spec-studio.intent-panel · anchored
  • test:protocol.proposal-schema-and-recipe verifies spec:consumers.intent-composition.proposal · anchored
  • test:protocol.studio-intent-handoff verifies spec:consumers.spec-studio.intent-panel · anchored
  • test:protocol.studio-intent-handoff verifies spec:consumers.intent-composition · anchored
  • test:protocol.studio-intents-refresh verifies spec:consumers.spec-studio.intent-panel.refresh-keeps-intents · anchored

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:consumers.intent-composition
The diagram as text
  • spec:consumers.edit-model: Views compose scoped intent instead of patching canonical source
  • spec:consumers.intent-composition: Composed intent hands off on one proposal shape
  • spec:consumers.intent-composition.proposal: A change proposal is addressed, based and checked before it lands
  • spec:consumers.spec-studio.intent-panel: A composing panel on every page gathers scoped intent for an agent
  • spec:consumers.studio-on-ramp: The Studio skill teaches agents to publish, share and read the Spec Studio
  • spec:consumers.upgrade-kit: The upgrade kit shows a corpus what it could adopt
  • spec:consumers.vault-on-ramp: The vault skill teaches agents to keep an Obsidian vault of the graph
  • spec:consumers.intent-composition refines spec:consumers.edit-model · declared
  • spec:consumers.studio-on-ramp dependsOn spec:consumers.intent-composition · declared — a received proposal is checked and applied as the hand-off law states
  • spec:consumers.upgrade-kit dependsOn spec:consumers.intent-composition · declared — a proposed upgrade hands off on the one change-proposal shape and is applied after its check
  • spec:consumers.vault-on-ramp dependsOn spec:consumers.intent-composition · declared — intent written in the vault is applied through a checked change proposal
  • spec:consumers.intent-composition.proposal refines spec:consumers.intent-composition · declared
  • spec:consumers.spec-studio.intent-panel refines spec:consumers.intent-composition · 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 · outgoingViews compose scoped intent instead of patching canonical source
spec:consumers.edit-model · resolves		declaredNoneNone
dependsOn · incomingThe Studio skill teaches agents to publish, share and read the Spec Studio
spec:consumers.studio-on-ramp · resolves		declareda received proposal is checked and applied as the hand-off law statesNone
dependsOn · incomingThe upgrade kit shows a corpus what it could adopt
spec:consumers.upgrade-kit · resolves		declareda proposed upgrade hands off on the one change-proposal shape and is applied after its checkNone
dependsOn · incomingThe vault skill teaches agents to keep an Obsidian vault of the graph
spec:consumers.vault-on-ramp · resolves		declaredintent written in the vault is applied through a checked change proposalNone
refines · incomingA change proposal is addressed, based and checked before it lands
spec:consumers.intent-composition.proposal · resolves		declaredNoneNone
refines · incomingA composing panel on every page gathers scoped intent for an agent
spec:consumers.spec-studio.intent-panel · resolves		declaredNoneNone

Bindings

Implementation binding: none

Design reference: present

  • impl:protocol.studio-intent-panel · gathers ordered intents under the page-root storage key and partitions their hand-off · src/studio-elements/intent-panel.ts:51 · role service · component component:protocol.studio-elements · layer edge · context protocol
  • impl:protocol.studio-intent-panel-element · displays gathered requests and writes copy selections or local download links · src/studio-elements/intent-panel-element.ts:14 · role interaction · component component:protocol.studio-elements · layer edge · context protocol

Verifier binding: present

  • test:protocol.studio-intent-handoff · anchored · test/studio-s5.test.ts:407 · test anchor

Expected-outcome oracle: none

Runtime observation: not tracked.

Run results: not recorded in the graph.

Findings

None.

Composing (0)

Composing needs the script.