Recipe 49 renders a change proposal as the Markdown memo a person reviews

outcome

Render a change proposal as one Markdown memo, the same bytes from the recipe and from the Studio's composing panel, that a person reviews and hands to an agent whole.

rule.memo line 17 · specs/consumers/intent-composition.proposal.memo.sdp.md:17

Recipe 49 renders a proposal as the Markdown memo a person reviews and hands off, ending with the document itself, and the Studio's composing panel, spec:consumers.spec-studio.intent-panel, writes the same bytes for the same document, so a person, a reviewer and an agent read one text.

spec:consumers.intent-composition.proposal.memo.shared · enabled

0 unkeyed rules.

Verifying examples

Given a change proposal with {changes: 2} changes, one whose exact text holds a run of {ticks: 3} backticks
When recipe 49 renders its memo and the composing panel renders its memo
Then the two memos are byte-identical: {identical: true}
Then the memo ends with the proposal as JSON in a fenced block: {carriesDocument: true}
Then the fence around that exact text is {fence: 4} backticks long

Example space

Given a change proposal with {changes:number} changes, one whose exact text holds a run of {ticks:number} backticks
When recipe 49 renders its memo and the composing panel renders its memo
Then the two memos are byte-identical: {identical:boolean}
Then the memo ends with the proposal as JSON in a fenced block: {carriesDocument:boolean}
Then the fence around that exact text is {fence:number} backticks long

memoRecipe line 20 · specs/consumers/intent-composition.proposal.memo.sdp.md:20

recipe 49, the proposal memo, takes params.proposal and returns { schemaProblems: [{ path, problem }], memo }: the schema problems recipe 38 reports for the same document and, when there are none, the memo as one string, otherwise memo: null; it reads no graph value, so one document renders one memo in any corpus.

memoHead line 21 · specs/consumers/intent-composition.proposal.memo.sdp.md:21

the memo opens with the line # Change proposal, a blank line, the line Base: followed by the base as a code span, the line Reason: followed by the reason as a code span, and a blank line.

Cited at

• Test line · test/studio-s5.test.ts:1209 · test:protocol.studio-memo-shared

memoChange line 22 · specs/consumers/intent-composition.proposal.memo.sdp.md:22

each change follows in document order as the line ## Change <n>, counting from 1, and a blank line, then each on its own line: Scope: followed by the scope items as code spans joined by , ; Request: followed by a blank line and the request in a fenced block whose info string is text; when present, Replaces: or Follows: followed by the address as a code span; Relation: followed by the action, the source as a code span, the relation type and the target as a code span, separated by single spaces; and Reason: followed by the change's reason as a code span; then, when the change carries exact text, a blank line and the text in a fenced block with no info string; then a blank line.

Cited at

• Test line · test/studio-s5.test.ts:1210 · test:protocol.studio-memo-shared

memoDocument line 23 · specs/consumers/intent-composition.proposal.memo.sdp.md:23

the memo ends with the line ## The proposal, a blank line, and the document in a fenced block whose info string is json, written as JSON.stringify writes it with two-space indentation and the keys in the order the document holds them.

Cited at

• Test line · test/studio-s5.test.ts:1211 · test:protocol.studio-memo-shared

memoMarkup line 24 · specs/consumers/intent-composition.proposal.memo.sdp.md:24

a code span uses a backtick run one longer than the longest run its content holds, padded with a space on each side when the content starts or ends with a backtick; a fence is a backtick run one longer than the longest run its content holds and at least three long; each request and each change's exact text is enclosed in a fence longer than any backtick run it holds, each reason is enclosed in a code span whose backtick run is longer than any run it holds, so no field of the memo can open HTML, add a heading or close its enclosing span or fence; every value is written verbatim; every line ends with a line feed and the memo with one.

Verifier bindings

• spec:consumers.intent-composition.proposal.memo.shared · Recipe 49 and the composing panel write one memo for one proposal · declared · example enabled · specs/consumers/intent-composition.proposal.memo.shared.sdp.md

  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 2: external run evidence from vitest 4.1.10

  Build: CI 439 · Branch: docs/articles-refresh-1 · Commit: 61576184ea9f39b7f91c51fef5ff991b0bf2d0e6 · Start: 2026-11-04T07:59:39.962Z · Stop: 2026-11-04T08:03:39.928Z

  Name	Suite	Result	Duration
  executes the bound example against a fresh world	Refreshing a tab keeps every gathered intent (spec:consumers.spec-studio.intent-panel.refresh-keeps-intents)	passed	13.18 ms
  executes the bound example against a fresh world	Recipe 49 and the composing panel write one memo for one proposal (spec:consumers.intent-composition.proposal.memo.shared)	passed	6.13 ms
  executes the bound example against a fresh world	A Pack's export opens alone and keeps its links inside it (spec:consumers.spec-studio.export.self-contained)	passed	99.22 ms
  executes the bound example against a fresh world	Each watch cycle writes the page set a plain run writes (spec:consumers.spec-studio.publisher.watch.matches-plain-run)	passed	214.65 ms
  keeps unsupported intents apart and expands Pack members only against the stamped base	not recorded	passed	3.67 ms
  returns the same schema problems as recipe 38 and renders in any corpus	not recorded	passed	17 ms
  composes locally without changing source or requesting a network service	not recorded	passed	5.78 ms
  keeps the last local intents when storage refuses writes	not recorded	passed	0.5 ms
  keeps unsaved local intents when storage remains readable but its quota refuses writes	not recorded	passed	0.69 ms
  rewrites SVG and accessibility references without changing subject attributes or authored text	not recorded	passed	11.52 ms
  opens disclosures for print and restores exactly their prior state	not recorded	passed	8.26 ms
  leaves Mermaid source closed for print unless the reader opened it	not recorded	passed	6.18 ms
  stops the actual Studio watch process with exit zero on SIGINT	not recorded	passed	1082.97 ms
  removes a failed watch publication, keeps watching and recovers on the next carrier edit	not recorded	passed	80.47 ms
  ships a phone layout and a print stylesheet for the whole canvas	not recorded	passed	25.84 ms
  keeps exports graph-only when the browsing pages receive a base and run records	not recorded	passed	40.31 ms
  starts no cycle for source or input-file events	not recorded	passed	61.88 ms
  merges concurrent panels before gathering or discarding and flags rejected storage records	not recorded	passed	0.62 ms
  refreshes the browser panel on storage and pageshow and removes those listeners on disconnect	not recorded	passed	1.82 ms
  prefills compose with the authored entry text including code spans and no rendered annotations	not recorded	passed	29.51 ms
  omits blank exact text and reports whitespace requests in the compose dialog	not recorded	passed	4.15 ms
  uses the stamp base, labels fields, orders actions and copies and saves the named documents	not recorded	passed	17.7 ms
  names each gathered intent's scope and the change it asks for	not recorded	passed	9.21 ms
  previews the memo it hands off, closed and read-only, before the copy actions	not recorded	passed	6.4 ms
  copies distinct actions and recorded scopes for both Pack choices without a stamp	not recorded	passed	5.86 ms
  keeps Pack framing changes apart and gathers scenario editor steps verbatim	not recorded	passed	5.73 ms
  matches the literal memo for the shared proposal, including the full relation and document	not recorded	passed	1.2 ms
  keeps the last watch pages when an optional base becomes unreadable, just like a plain run	not recorded	passed	2247.36 ms
  inlines the selected stylesheet asset in exports and publishes those same style bytes	not recorded	passed	32.85 ms
  introduces studio before its watch option and gives recipe 49 a use case	not recorded	passed	2.3 ms
  renders edit scenario steps outside inert templates without script	not recorded	passed	1.87 ms
  renders propose scenario steps outside inert templates without script	not recorded	passed	0.96 ms
  writes both memo reasons as code spans: "<details>Review the design.</details>", "`Keep` the ``literal`` reason`"	not recorded	passed	1.04 ms
  writes both memo reasons as code spans: "`Review` the ``design`` reason`", "<details>Keep the change.</details>"	not recorded	passed	0.84 ms
  fences requests so their Markdown cannot alter the memo: "Fix a typo.\n<!--"	not recorded	passed	1.44 ms
  fences requests so their Markdown cannot alter the memo: "Use this text.\n```\n## Forged heading\n``````\n<!--hidden-->"	not recorded	passed	1.09 ms
  contains phone navigation, stamp and wide tables within the viewport	not recorded	passed	22.67 ms
  keeps the maturity caption readable and empty cells compact on a phone	not recorded	passed	18.08 ms
  aligns maturity cell counts with the empty cell dashes	not recorded	passed	19.1 ms
  keeps table headers and one-word cells intact while allowing word-boundary wrapping	not recorded	passed	16.11 ms
  keeps natural desktop diagram size and fits only on phones	not recorded	passed	10.23 ms
  hides phone scroll advice and closed source in print while keeping opened source printable	not recorded	passed	9.96 ms
  shows the raw unknown action unknown-action and offers no compose control for it	not recorded	passed	2.18 ms
  shows the raw unknown action constructor and offers no compose control for it	not recorded	passed	1.81 ms
  shows the raw unknown action toString and offers no compose control for it	not recorded	passed	1.88 ms
  shows the raw unknown action valueOf and offers no compose control for it	not recorded	passed	1.8 ms
  shows the raw unknown action hasOwnProperty and offers no compose control for it	not recorded	passed	1.99 ms
  shows the raw unknown action __proto__ and offers no compose control for it	not recorded	passed	1.81 ms

Requirement drawing

Decisions

No decision record named.

• component:protocol.studio-elements · optional browser behavior and proposal handoff · src/studio-elements/index.ts:13 · layer edge · context protocol

  Uses

  • component:protocol.projections · read-only output, layout and owned publication · src/projections/design-review.ts:29 · layer edge · context protocol
  • component:protocol.reader · the typed graph contract and body evaluator · src/reader/reader.ts:697 · layer application · context protocol
• impl:protocol.proposal-memo-recipe · realizes the catalog proposal memo through its verbatim body check · test/recipes.test.ts:7368

  Uses

  None.

• impl:protocol.studio-proposal-memo · renders proposal fields verbatim with fences that outgrow their content · src/studio-elements/memo.ts:13

  Component: component:protocol.studio-elements · optional browser behavior and proposal handoff · src/studio-elements/index.ts:13 · layer edge · context protocol

  Uses

  None.

Runtime observation: not tracked.

Runtime observation: not tracked.

Build attestations: not tracked.

Deployments: not tracked.

Bills of materials: not tracked.