An adopter learns graph homes, carrier grammar and shipped paths from the on-ramps

problem

An adopter needs a repeatable commit install and stable recipe inputs. An adopter that follows the shipped on-ramps cannot learn where a deferral, an unsettled fact, a ruling awaiting its owner, a statement a test checks, or a count belongs, so it invents tags of its own, hand-kept registers, and scripts that keep them true.

outcome

Teach commit installation and stable recipe inputs in the README. Teach each ruled home in the shipped skills, one line each with its carrying Spec, so an adopter states those truths in the graph and not beside it.

rule.commitInstall line 27 · specs/consumers/adopter-on-ramp.sdp.md:27

An adopter can pin the package to a git commit, and the package's prepare script builds the CLI, subpath exports and shipped recipes before installation completes. While the package version is 0.0.0, the installation guidance uses a commit pin rather than an npm prerelease.

no example exercises it

rule.installGuidance line 28 · specs/consumers/adopter-on-ramp.sdp.md:28

The shipped README teaches a commit install with npm and pnpm, the source-qualified build approval each needs, and a check that the installed CLI's sdp --version names the pinned full commit, for a git clone or a hosted git archive install. It teaches that the ./vitest subpath needs Vitest 2 or later installed beside the package.

no example exercises it

rule.recipeUpgrade line 29 · specs/consumers/adopter-on-ramp.sdp.md:29

The upgrade guidance teaches a recipe caller to pass the recipe's subject as --params data and run the shipped recipe file, never to rewrite the recipe body.

no example exercises it

rule line 30 · specs/consumers/adopter-on-ramp.sdp.md:30

The authoring skill teaches a deferral as a blocking open question whose trigger: field names what brings the Spec back, plus dependsOn for a true precondition. Its blocking question holds the Spec below defined without an adopter-specific tag. Example children may still state defined once their bound points are complete and match the parent's example vocabulary when it has one; their ready waits until the parent states at least defined.

rule line 31 · specs/consumers/adopter-on-ramp.sdp.md:31

It teaches an unsettled fact as a constraint Spec whose blocking open question names the check that would settle it. Specs bounded by it declare constrainedBy; they may state defined when their own floor clears, and their ready waits until the constraint states at least defined.

rule line 32 · specs/consumers/adopter-on-ramp.sdp.md:32

It teaches a ruling that awaits its owner as a decision Spec below ready, with decidedBy from each Spec the ruling shapes.

rule line 33 · specs/consumers/adopter-on-ramp.sdp.md:33

It teaches that a fact is checked by an example that verifies it. has-verifier is derived once a test anchor binds the example, and a checked status is never authored.

rule line 34 · specs/consumers/adopter-on-ramp.sdp.md:34

It carries a short table of the Markdown body grammar, one row per section, that points at spec:carrier.markdown-body-grammar, so the grammar is found from the skill and not by probing.

rule line 35 · specs/consumers/adopter-on-ramp.sdp.md:35

It teaches that counts, registers, and review scope are derived. Census counts come from sdp census, open-question and mention registers from catalog recipes, and a change's review scope from changed-file blast radius. None is quoted into prose.

rule.helpNamesOnRamps line 36 · specs/consumers/adopter-on-ramp.sdp.md:36

sdp --help names the shipped skills, the recipe catalog, and the Protocol's own specs/ by package-relative path.

no example exercises it

rule line 37 · specs/consumers/adopter-on-ramp.sdp.md:37

The skills teach and never check. No validator reads an adopter's own tags, and an adopter's own policy checks stay the adopter's.

7 unkeyed rules.

Verifier bindings

• test:protocol.adopter-on-ramp · skill-asset checks verify the adopter on-ramp · anchored · test anchor binding present · test/skills.test.ts:719

  External run evidence from test/skills.test.ts

  Test anchors: test:protocol.adopter-on-ramp, test:protocol.authoring-on-ramp, test:protocol.delivery-session-on-ramp, test:protocol.graph-first-planning, test:protocol.reading-on-ramp, test:protocol.studio-on-ramp, test:protocol.vault-on-ramp. Specs verified by those bindings: spec:consumers.adopter-on-ramp, spec:consumers.authoring-on-ramp, spec:consumers.delivery-session-on-ramp, spec:consumers.graph-first-planning, spec:consumers.reading-on-ramp, spec:consumers.studio-on-ramp, spec:consumers.vault-on-ramp.

  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

  Name	Suite	Result	Duration
  discovers the design slice's summary and detail parameter	not recorded	passed	7.03 ms
  teaches the named-file exception to both carrier-watch descriptions	not recorded	passed	1.09 ms
  teaches the optional priority field in the Pack manifest envelope	not recorded	passed	0.8 ms
  teaches design rounds and curates bindings by responsibility	not recorded	passed	3.5 ms
  presents the Protocol engine roles and reviewed boundary as worked examples for adopters	not recorded	passed	1.21 ms
  routes the next work and reviews through roadmap and proposal recipes	not recorded	passed	3.96 ms
  keeps planning truth in graph homes and session routing advisory	Protocol skill assets	passed	1.33 ms
  rejects missing planning guidance: An open question goes	Protocol skill assets	passed	2.15 ms
  rejects missing planning guidance: A deferral is	Protocol skill assets	passed	1.08 ms
  rejects missing planning guidance: An unsettled fact	Protocol skill assets	passed	0.92 ms
  rejects missing planning guidance: A ruling that awaits	Protocol skill assets	passed	0.97 ms
  rejects missing planning guidance: A statement a test checks	Protocol skill assets	passed	1.51 ms
  rejects missing planning guidance: Derive a count	Protocol skill assets	passed	1.19 ms
  rejects missing planning guidance: Group a body of work	Protocol skill assets	passed	1.21 ms
  rejects missing planning guidance: Hold advisory priority	Protocol skill assets	passed	2.68 ms
  owns skills under .agents and exposes them to Claude through one relative symlink	Protocol skill assets	passed	0.51 ms
  ships every skill folder in the package and indexes it in the help	Protocol skill assets	passed	1.18 ms
  uses the repository's two-field single-file convention	Protocol skill assets	passed	2.59 ms
  keeps every skill graph-first and the authoring law linked to carrying Specs	Protocol skill assets	passed	12.22 ms
  names the complete closed graph schema in the shape section	Protocol skill assets	passed	0.97 ms
  routes delivery sessions through the five advisory graph shapes	Protocol skill assets	passed	0.99 ms
  documents only valid CLI verbs and keeps root-specific exclusions intact	Protocol skill assets	passed	3.16 ms
  uses the local runtime or package runner instead of a colliding global binary	Protocol skill assets	passed	1.56 ms
  contains no contradictory shortcuts for readiness or verifier realization	Protocol skill assets	passed	2.44 ms
  states no recipe-catalog size in an on-ramp	Protocol skill assets	passed	14.6 ms
  maps a task to every catalog recipe in one sheet	the graph-reading on-ramp	passed	2.92 ms
  links the Specs that own the graph contract, the claims and the sink	the graph-reading on-ramp	passed	0.58 ms
  teaches every Markdown section owner and links the carrying grammar	adopter teaching	passed	2.33 ms
  teaches open-question home	adopter rule meanings	passed	1.24 ms
  teaches blocking floor	adopter rule meanings	passed	1.19 ms
  teaches blocking deferral	adopter rule meanings	passed	1.36 ms
  teaches deferral trigger	adopter rule meanings	passed	1.24 ms
  teaches deferral precondition	adopter rule meanings	passed	1.36 ms
  teaches independent defined floor	adopter rule meanings	passed	1.62 ms
  teaches complete example children	adopter rule meanings	passed	8.74 ms
  teaches example vocabulary agreement	adopter rule meanings	passed	1.29 ms
  teaches physical entry line	adopter rule meanings	passed	1.34 ms
  teaches one leading prose owner	adopter rule meanings	passed	1.09 ms
  teaches Note is refused	adopter rule meanings	passed	1.02 ms
  teaches ready reads parent	adopter rule meanings	passed	1.1 ms
  teaches ready waits for defined parent	adopter rule meanings	passed	1.14 ms
  teaches unsettled constraint home	adopter rule meanings	passed	1.13 ms
  teaches unsettled blocking check	adopter rule meanings	passed	1.11 ms
  teaches bounded relation	adopter rule meanings	passed	1.15 ms
  teaches bounded defined allowed	adopter rule meanings	passed	1.08 ms
  teaches bounded ready waits	adopter rule meanings	passed	1.12 ms
  teaches pending decision below ready	adopter rule meanings	passed	1 ms
  teaches shaping relation	adopter rule meanings	passed	1.54 ms
  teaches owner states ready	adopter rule meanings	passed	1.41 ms
  teaches checked statement home	adopter rule meanings	passed	2.23 ms
  teaches checking example relation	adopter rule meanings	passed	1.2 ms
  teaches example test binding	adopter rule meanings	passed	1.1 ms
  teaches derived verifier fact	adopter rule meanings	passed	1.14 ms
  teaches verifier existence versus passing	adopter rule meanings	passed	4.17 ms
  teaches CI owns outcomes	adopter rule meanings	passed	3.95 ms
  teaches no authored checked status	adopter rule meanings	passed	4.14 ms
  teaches fresh derived counts registers scope	adopter rule meanings	passed	1.07 ms
  teaches census source	adopter rule meanings	passed	7.43 ms
  teaches open-question register source	adopter rule meanings	passed	1.21 ms
  teaches dependency register source	adopter rule meanings	passed	1.17 ms
  teaches mention register source	adopter rule meanings	passed	1.48 ms
  teaches delta scope source	adopter rule meanings	passed	1.12 ms
  teaches no quoted counts	adopter rule meanings	passed	1.14 ms
  teaches operator-selected policy	adopter rule meanings	passed	1.21 ms
  teaches per-file policy parameters	adopter rule meanings	passed	2.29 ms
  teaches separate policy findings	adopter rule meanings	passed	1.14 ms
  teaches policy failures	adopter rule meanings	passed	1.03 ms
  teaches watch policy rereads	adopter rule meanings	passed	1.02 ms
  teaches Constraints leading-prose exception	adopter rule meanings	passed	1.06 ms
  teaches one primary owner	adopter rule meanings	passed	1.08 ms
  rejects the opposite teaching for independent defined floor: defined floor does not read the parent's readiness	adopter rule meanings	passed	1.26 ms
  rejects the opposite teaching for independent defined floor: defined floor does not read the parent's readiness	adopter rule meanings	passed	1.22 ms
  rejects the opposite teaching for example vocabulary agreement: complete and match the parent's example vocabulary, when it has one	adopter rule meanings	passed	1.15 ms
  rejects the opposite teaching for ready reads parent: ready floor does read the parent's readiness	adopter rule meanings	passed	1.15 ms
  rejects the opposite teaching for physical entry line: a wrapped or indented continuation is refused	adopter rule meanings	passed	1.17 ms
  rejects the opposite teaching for one leading prose owner: Leading prose may stand under that owner or under Example space, not both	adopter rule meanings	passed	1.15 ms
  rejects the opposite teaching for Note is refused: The parser reads - Note: x as a key and refuses it	adopter rule meanings	passed	1.15 ms
  rejects the opposite teaching for open-question home: An open question goes under Intent's ### Open questions.	adopter rule meanings	passed	1.21 ms
  accepts a harmless open-question instruction frame	adopter rule meanings	passed	1.7 ms
  defined examples ignore parent readiness but read its vocabulary: matches=true	adopter rule meanings	passed	3.78 ms
  defined examples ignore parent readiness but read its vocabulary: matches=false	adopter rule meanings	passed	0.45 ms
  teaches the Intent grammar row	adopter rule meanings	passed	0.66 ms
  teaches the Intent grammar row	adopter rule meanings	passed	0.57 ms
  teaches the Behavior grammar row	adopter rule meanings	passed	0.54 ms
  teaches the Rule grammar row	adopter rule meanings	passed	1.82 ms
  teaches the Workflow grammar row	adopter rule meanings	passed	0.56 ms
  teaches the Workflow grammar row	adopter rule meanings	passed	0.51 ms
  teaches the Contract grammar row	adopter rule meanings	passed	0.58 ms
  teaches the Example space grammar row	adopter rule meanings	passed	0.49 ms
  teaches the Example space grammar row	adopter rule meanings	passed	0.54 ms
  teaches the Constraints grammar row	adopter rule meanings	passed	0.56 ms
  teaches the Constraints grammar row	adopter rule meanings	passed	0.47 ms
  teaches the Constraints grammar row	adopter rule meanings	passed	0.47 ms
  teaches the Model grammar row	adopter rule meanings	passed	0.53 ms
  teaches the Model grammar row	adopter rule meanings	passed	0.64 ms
  teaches the Design grammar row	adopter rule meanings	passed	0.54 ms
  teaches the Design grammar row	adopter rule meanings	passed	0.53 ms
  teaches the Decision grammar row	adopter rule meanings	passed	0.55 ms
  teaches the Decision grammar row	adopter rule meanings	passed	0.51 ms
  teaches the UI grammar row	adopter rule meanings	passed	0.43 ms
  teaches the Verification — <mode> grammar row	adopter rule meanings	passed	0.46 ms
  teaches the Verification — <mode> grammar row	adopter rule meanings	passed	0.42 ms
  teaches the Verification — <mode> grammar row	adopter rule meanings	passed	0.44 ms
  keeps graph-reader verifier teaching about existence and CI outcomes	adopter rule meanings	passed	0.79 ms
  keeps session teaching advisory and separate from permission	adopter rule meanings	passed	0.48 ms
  the README teaches commit pin	adopter install and upgrade guidance	passed	0.3 ms
  the README teaches npm script approval	adopter install and upgrade guidance	passed	0.25 ms
  the README teaches npm git approval	adopter install and upgrade guidance	passed	0.21 ms
  the README teaches pnpm repository approval	adopter install and upgrade guidance	passed	0.21 ms
  the README teaches pnpm 10 exact approval	adopter install and upgrade guidance	passed	0.21 ms
  the README teaches installed CLI check	adopter install and upgrade guidance	passed	0.21 ms
  the README teaches vitest subpath requirement	adopter install and upgrade guidance	passed	0.22 ms
  the README teaches recipe subject as params	adopter install and upgrade guidance	passed	0.2 ms
  refuses wrapped continuation	taught grammar agrees with parser behavior	passed	1.34 ms
  refuses indented continuation	taught grammar agrees with parser behavior	passed	0.18 ms
  allows leading prose under either owner and refuses it under both	taught grammar agrees with parser behavior	passed	1.03 ms
  refuses Note as a plain Rule entry	taught grammar agrees with parser behavior	passed	0.28 ms
  refuses Note as a plain Workflow entry	taught grammar agrees with parser behavior	passed	0.13 ms
  refuses Note as a plain Contract entry	taught grammar agrees with parser behavior	passed	0.09 ms
  refuses Note as a plain Verification — manual entry	taught grammar agrees with parser behavior	passed	0.51 ms
  refuses unique Model terms duplicates	taught grammar agrees with parser behavior	passed	0.52 ms
  refuses unique Design keys duplicates	taught grammar agrees with parser behavior	passed	0.13 ms
  refuses unique UI keys via Design form duplicates	taught grammar agrees with parser behavior	passed	0.09 ms
  refuses single Intent actor duplicates	taught grammar agrees with parser behavior	passed	0.55 ms
  refuses single Intent problem duplicates	taught grammar agrees with parser behavior	passed	0.15 ms
  refuses single Intent outcome duplicates	taught grammar agrees with parser behavior	passed	0.1 ms
  refuses single Intent value duplicates	taught grammar agrees with parser behavior	passed	0.1 ms
  refuses single Constraints statement duplicates	taught grammar agrees with parser behavior	passed	0.28 ms
  refuses single Constraints flavor duplicates	taught grammar agrees with parser behavior	passed	0.21 ms
  refuses single Constraints target duplicates	taught grammar agrees with parser behavior	passed	0.13 ms
  refuses single Constraints measurableBy duplicates	taught grammar agrees with parser behavior	passed	0.1 ms
  refuses single Decision context duplicates	taught grammar agrees with parser behavior	passed	0.23 ms
  refuses single Decision decision duplicates	taught grammar agrees with parser behavior	passed	0.12 ms
  allows Behavior alone and refuses a second primary owner	taught grammar agrees with parser behavior	passed	0.52 ms
  allows Rule alone and refuses a second primary owner	taught grammar agrees with parser behavior	passed	0.22 ms
  allows Workflow alone and refuses a second primary owner	taught grammar agrees with parser behavior	passed	0.14 ms
  allows Contract alone and refuses a second primary owner	taught grammar agrees with parser behavior	passed	0.2 ms
  allows leading prose in Design and refuses it in Constraints	taught grammar agrees with parser behavior	passed	0.2 ms
  allows the taught repeatable Intent entries	taught grammar agrees with parser behavior	passed	0.18 ms
  allows the taught repeatable Decision entries	taught grammar agrees with parser behavior	passed	0.14 ms
  extracts the key the skill's marker carries and resolves the address the skill gives it	the taught question marker	passed	13.76 ms
  leaves the address unresolved when the key stands outside the brackets	the taught question marker	passed	8.53 ms
  creates the anchored suite before generating, and the build places the registrar beside it	the reviewed skill teaching	passed	23.52 ms
  keys a step in the vocabulary, as the step-key law and the contract generator agree	the reviewed skill teaching	passed	8.43 ms
  owns publishing in one reader section that agrees with each verb's flags	the reviewed skill teaching	passed	2.25 ms
  names the vault's owned folder, the person's notes and the roots a vault run removes	the reviewed skill teaching	passed	0.64 ms
  teaches entry addresses, term addresses and anchored source citations as the engine derives them	the reviewed skill teaching	passed	15.32 ms
  states what an empty or ready answer establishes and no more	the reviewed skill teaching	passed	1.27 ms
  teaches a refused bundle as the end of pagination, as recipe 36 refuses	the reviewed skill teaching	passed	9.72 ms
  keeps corpus rules in one section whose composed rules file runs as taught	the reviewed skill teaching	passed	9.15 ms
  points every skill at the installed upgrade guide and triggers authoring on upgrades and rules	the reviewed skill teaching	passed	1.5 ms
  orders the reader as a task route and leaves recipe contracts to the catalog	the reviewed skill teaching	passed	0.78 ms
  states the graph's flat topology and which node types carry lines, as the graph does	the reviewed skill teaching	passed	14.53 ms
  is its own shipped skill, which the reading skill points to	the Studio on-ramp	passed	1.1 ms
  starts from what the agent holds	the Studio on-ramp	passed	0.52 ms
  teaches the publishing run as the studio and generate verbs take it	the Studio on-ramp	passed	2.39 ms
  teaches stamping and the preview workflow as the workflow declares them	the Studio on-ramp	passed	6.91 ms
  has the preview's run evidence checked against the stamp, never assumed to match it	the Studio on-ramp	passed	3.17 ms
  maps each task to a page the Studio writes, and states what a page does not	the Studio on-ramp	passed	45.15 ms
  receives the composing panel's hand-off through the proposal check	the Studio on-ramp	passed	19.46 ms
  cites resolving Studio Specs for law and leaves flags to each verb's help	the Studio on-ramp	passed	700.44 ms
  is its own shipped skill, which the reading skill points to	the vault on-ramp	passed	1.29 ms
  places the vault where the command accepts it	the vault on-ramp	passed	3.7 ms
  keeps the person's notes outside the folder the command owns	the vault on-ramp	passed	0.51 ms
  teaches synchronizing and watching as the verbs and the failed index state them	the vault on-ramp	passed	0.51 ms
  names every refusal the guard prints and how to recover from it	the vault on-ramp	passed	0.81 ms
  converts a note's links back to the addresses the vault wrote, then checks the proposal	the vault on-ramp	passed	14.49 ms
  takes the proposal's base from the graph the person read, never from the latest synchronization	the vault on-ramp	passed	4.12 ms
  cites resolving vault Specs for law and leaves flags to the verb's help	the vault on-ramp	passed	124.17 ms

• test:protocol.shipped-protocol-corpus · package smoke checks verify the shipped corpus · anchored · test anchor binding present · test/package-smoke.test.ts:259

  External run evidence from test/package-smoke.test.ts

  Test anchors: test:protocol.shipped-protocol-corpus. Specs verified by those bindings: spec:consumers.adopter-on-ramp, spec:consumers.shipped-protocol-corpus.

  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

  Name	Suite	Result	Duration
  packing leaves every repository dist file's inode, size and mtime untouched	published package surface	passed	874.76 ms
  packs the same files and bytes as npm 11 selects from the built repository	published package surface	passed	13214.67 ms
  dist/adapters/vitest.js keeps Vitest runner code outside the package	published package surface	passed	2.26 ms
  dist/index.cjs keeps Vitest runner code outside the package	published package surface	passed	2.7 ms
  registers and passes one bindExample test with the installed consumer's Vitest	published package surface	passed	3009.76 ms
  proves the installed tarball lists import, dry-runs conversion without writes, and exposes the barrel	published package surface	passed	6409 ms

Requirement drawing

• Declared verifying examples: no declared verifying example.

Decisions

• Decision records state readiness from ratification evidence

  A decision Spec states ready when its complete record is registry-ratified. Decision records never require implementation or verifier bindings; the operational build backlog and verifier-gap signal exclude kind decision, while recipe 1 reports the excluded ready-decision count.

• Planning truths live in ruled graph homes

  Each planning-truth type lives in its ruled home. Work-item dependency truth rides dependsOn edges, with independence as absence of the edge and scheduling phrases never authored. Decision gates live on decision-kind Specs, linked by decidedBy. Do-not-reopen rows split by what they carry: a tradeoff refusal becomes a decision-kind Spec, which a later decision that supersedes it replaces whole and a later decision that refines it narrows for one case, either under the ADR three-part test; a row that restates a behavior guarantee already homed on a carrying Spec stays on that Spec and changes by ordinary Spec revision; a hold stays a blocking open question on its own Spec and is never minted as a decision. A lawful non-decision stays in the plan record as evidence. A deferral carries its re-entry trigger in the trigger field of its own blocking open question, and declares dependsOn separately when a true precondition exists. Exclusive ownership is one Spec identity per deliverable with consumers depending on it. Selection-pressure heuristics are advisory only, carried as behavior rules on the graph-first planning Spec or in recipes. Session law splits separately, across behavior rules on the graph-first planning Spec, the delivery-session on-ramp's handoff rule, and the plan file. The briefs index shape is retired as a carrier of law.

• component:protocol.cli · entry points, shared build and publication · src/cli/build-command.ts:32 · layer edge · context protocol

  Uses

  • component:protocol.adapters · external runtime and source adapters · src/adapters/vitest.ts:23 · layer adapter · context protocol
  • component:protocol.codegen · contracts and registrar output · src/codegen/contracts.ts:633 · layer application · context protocol
  • component:protocol.extract · the carrier and source pipeline · src/extract/index.ts:192 · layer application · context protocol
  • component:protocol.graph · the one graph and its semantic decisions · src/graph/schema.ts:34 · layer domain · context protocol
  • component:protocol.import · canonical conversion with a fidelity boundary · src/import/import.ts:45 · layer application · context protocol
  • component:protocol.model · the authored contracts and stable ids · src/model/anchors.ts:100 · layer domain · context protocol
  • 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:671 · layer application · context protocol
  • component:protocol.validate · one finding currency and ordered checks · src/validate/validators.ts:72 · layer domain · context protocol
• impl:protocol.adopter-help · SDP_HELP_TEXT indexes the shipped skills, recipe catalog, schema, walkthrough, glossary and specs/ by package-relative path · src/cli/help.ts:167

  Component: component:protocol.cli · entry points, shared build and publication · src/cli/build-command.ts:32 · layer edge · context protocol

  Uses

  None.

• impl:protocol.adopter-on-ramp · asserts realization of the shipped adopter teaching in the authoring skill · test/skills.test.ts:712

  Uses

  None.

Runtime observation: not tracked.

Runtime observation: not tracked.

Build attestations: not tracked.

Deployments: not tracked.

Bills of materials: not tracked.