outcomeThe reading skill teaches agents to query the graph
spec:consumers.reading-on-rampPacks: pack:self-hosting-v1
Design: no design entries · no pinned declarations · 1 decision
Findings: no errors, no warnings
specs/consumers/reading-on-ramp.sdp.md
No open questions and no blocking questions; implementation binding present, verifier binding present, and expected-outcome oracle none.
Intent
- Give an agent a shipped reading on-ramp that selects current graph evidence and the Spec that owns each law.
Behavior
ruleline 16 ·specs/consumers/reading-on-ramp.sdp.md:16- The skill names the closed graph node types, edge types and claims, links their carrying Specs, and moves when those contracts change.
ruleline 17 ·specs/consumers/reading-on-ramp.sdp.md:17- The skill teaches how delivery facts derive and explains the limits of empty answers, keeping a binding distinct from passing tests and runtime observation.
ruleline 18 ·specs/consumers/reading-on-ramp.sdp.md:18- The skill bootstraps through the Protocol repository wrapper or an adopter's package runner, selecting the appropriate root and exclusions without relying on a global
sdp. ruleline 19 ·specs/consumers/reading-on-ramp.sdp.md:19- The skill directs the reader from a question to the numbered, named catalog recipe that answers it, passes subjects as
params, and teaches summary and detail output without creating query verbs. ruleline 20 ·specs/consumers/reading-on-ramp.sdp.md:20- The skill links the Specs that own law and uses summaries for orientation; current graph data answers state questions and the carrying Specs answer intended truth.
ruleline 21 ·specs/consumers/reading-on-ramp.sdp.md:21- The skill carries one sheet that maps a delivery task to the recipe that answers it.
6 unkeyed rules.
Verification
Verifier bindings
- test:protocol.reading-on-ramp · skill-asset checks verify the graph-reading on-ramp · anchored · test anchor binding present ·
test/skills.test.ts:670External run evidence from
test/skills.test.tsTest 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 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 discovers the design slice's summary and detail parameter not recorded passed 16.91 ms teaches the named-file exception to both carrier-watch descriptions not recorded passed 1.72 ms teaches the optional priority field in the Pack manifest envelope not recorded passed 1.29 ms teaches design rounds and curates bindings by responsibility not recorded passed 5.53 ms presents the Protocol engine roles and reviewed boundary as worked examples for adopters not recorded passed 1.34 ms routes the next work and reviews through roadmap and proposal recipes not recorded passed 4.22 ms keeps planning truth in graph homes and session routing advisory Protocol skill assets passed 2.2 ms rejects missing planning guidance: An open question goes Protocol skill assets passed 3.31 ms rejects missing planning guidance: A deferral is Protocol skill assets passed 1.66 ms rejects missing planning guidance: An unsettled fact Protocol skill assets passed 1.47 ms rejects missing planning guidance: A ruling that awaits Protocol skill assets passed 1.54 ms rejects missing planning guidance: A statement a test checks Protocol skill assets passed 1.36 ms rejects missing planning guidance: Derive a count Protocol skill assets passed 1.72 ms rejects missing planning guidance: Group a body of work Protocol skill assets passed 1.82 ms rejects missing planning guidance: Hold advisory priority Protocol skill assets passed 1.94 ms owns skills under .agents and exposes them to Claude through one relative symlink Protocol skill assets passed 1.17 ms ships every skill folder in the package and indexes it in the help Protocol skill assets passed 1.89 ms uses the repository's two-field single-file convention Protocol skill assets passed 3.52 ms keeps every skill graph-first and the authoring law linked to carrying Specs Protocol skill assets passed 5.36 ms names the complete closed graph schema in the shape section Protocol skill assets passed 1.85 ms routes delivery sessions through the five advisory graph shapes Protocol skill assets passed 1.8 ms documents only valid CLI verbs and keeps root-specific exclusions intact Protocol skill assets passed 6.86 ms uses the local runtime or package runner instead of a colliding global binary Protocol skill assets passed 3.42 ms contains no contradictory shortcuts for readiness or verifier realization Protocol skill assets passed 4.59 ms states no recipe-catalog size in an on-ramp Protocol skill assets passed 34.39 ms maps a task to every catalog recipe in one sheet the graph-reading on-ramp passed 14 ms links the Specs that own the graph contract, the claims and the sink the graph-reading on-ramp passed 1 ms teaches every Markdown section owner and links the carrying grammar adopter teaching passed 1.66 ms teaches open-question home adopter rule meanings passed 2.09 ms teaches blocking floor adopter rule meanings passed 4.13 ms teaches blocking deferral adopter rule meanings passed 2.22 ms teaches deferral trigger adopter rule meanings passed 2.04 ms teaches deferral precondition adopter rule meanings passed 2.02 ms teaches independent defined floor adopter rule meanings passed 2.09 ms teaches complete example children adopter rule meanings passed 1.9 ms teaches example vocabulary agreement adopter rule meanings passed 1.82 ms teaches physical entry line adopter rule meanings passed 4 ms teaches one leading prose owner adopter rule meanings passed 1.86 ms teaches Note is refused adopter rule meanings passed 1.81 ms teaches ready reads parent adopter rule meanings passed 1.96 ms teaches ready waits for defined parent adopter rule meanings passed 2.59 ms teaches unsettled constraint home adopter rule meanings passed 4.3 ms teaches unsettled blocking check adopter rule meanings passed 2.64 ms teaches bounded relation adopter rule meanings passed 1.93 ms teaches bounded defined allowed adopter rule meanings passed 1.95 ms teaches bounded ready waits adopter rule meanings passed 1.91 ms teaches pending decision below ready adopter rule meanings passed 1.88 ms teaches shaping relation adopter rule meanings passed 2.01 ms teaches owner states ready adopter rule meanings passed 1.89 ms teaches checked statement home adopter rule meanings passed 2.15 ms teaches checking example relation adopter rule meanings passed 1.95 ms teaches example test binding adopter rule meanings passed 1.88 ms teaches derived verifier fact adopter rule meanings passed 1.96 ms teaches verifier existence versus passing adopter rule meanings passed 5 ms teaches CI owns outcomes adopter rule meanings passed 2.16 ms teaches no authored checked status adopter rule meanings passed 1.92 ms teaches fresh derived counts registers scope adopter rule meanings passed 3.63 ms teaches census source adopter rule meanings passed 1.98 ms teaches open-question register source adopter rule meanings passed 1.91 ms teaches dependency register source adopter rule meanings passed 1.94 ms teaches mention register source adopter rule meanings passed 2.05 ms teaches delta scope source adopter rule meanings passed 1.94 ms teaches no quoted counts adopter rule meanings passed 1.9 ms teaches operator-selected policy adopter rule meanings passed 1.87 ms teaches per-file policy parameters adopter rule meanings passed 1.97 ms teaches separate policy findings adopter rule meanings passed 1.88 ms teaches policy failures adopter rule meanings passed 4.78 ms teaches watch policy rereads adopter rule meanings passed 2.56 ms teaches Constraints leading-prose exception adopter rule meanings passed 2.03 ms teaches one primary owner adopter rule meanings passed 2.19 ms rejects the opposite teaching for independent defined floor: defined floor does not read the parent's readiness adopter rule meanings passed 5.41 ms rejects the opposite teaching for independent defined floor: defined floor does not read the parent's readiness adopter rule meanings passed 4.02 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 2.11 ms rejects the opposite teaching for ready reads parent: ready floor does read the parent's readiness adopter rule meanings passed 2.07 ms rejects the opposite teaching for physical entry line: a wrapped or indented continuation is refused adopter rule meanings passed 2.05 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 2.02 ms rejects the opposite teaching for Note is refused: The parser reads - Note: x as a key and refuses it adopter rule meanings passed 2.07 ms rejects the opposite teaching for open-question home: An open question goes under Intent's ### Open questions. adopter rule meanings passed 2.12 ms accepts a harmless open-question instruction frame adopter rule meanings passed 2 ms defined examples ignore parent readiness but read its vocabulary: matches=true adopter rule meanings passed 3.57 ms defined examples ignore parent readiness but read its vocabulary: matches=false adopter rule meanings passed 0.7 ms teaches the Intent grammar row adopter rule meanings passed 1.01 ms teaches the Intent grammar row adopter rule meanings passed 0.88 ms teaches the Behavior grammar row adopter rule meanings passed 0.85 ms teaches the Rule grammar row adopter rule meanings passed 0.87 ms teaches the Workflow grammar row adopter rule meanings passed 0.86 ms teaches the Workflow grammar row adopter rule meanings passed 0.87 ms teaches the Contract grammar row adopter rule meanings passed 0.95 ms teaches the Example space grammar row adopter rule meanings passed 0.85 ms teaches the Example space grammar row adopter rule meanings passed 0.88 ms teaches the Constraints grammar row adopter rule meanings passed 0.97 ms teaches the Constraints grammar row adopter rule meanings passed 0.94 ms teaches the Constraints grammar row adopter rule meanings passed 0.93 ms teaches the Model grammar row adopter rule meanings passed 0.82 ms teaches the Model grammar row adopter rule meanings passed 0.89 ms teaches the Design grammar row adopter rule meanings passed 0.86 ms teaches the Design grammar row adopter rule meanings passed 3.1 ms teaches the Decision grammar row adopter rule meanings passed 0.91 ms teaches the Decision grammar row adopter rule meanings passed 3.26 ms teaches the UI grammar row adopter rule meanings passed 0.84 ms teaches the Verification — <mode> grammar row adopter rule meanings passed 0.87 ms teaches the Verification — <mode> grammar row adopter rule meanings passed 0.92 ms teaches the Verification — <mode> grammar row adopter rule meanings passed 0.9 ms keeps graph-reader verifier teaching about existence and CI outcomes adopter rule meanings passed 1.5 ms keeps session teaching advisory and separate from permission adopter rule meanings passed 0.86 ms the README teaches commit pin adopter install and upgrade guidance passed 0.59 ms the README teaches npm script approval adopter install and upgrade guidance passed 0.56 ms the README teaches npm git approval adopter install and upgrade guidance passed 0.54 ms the README teaches pnpm repository approval adopter install and upgrade guidance passed 2.72 ms the README teaches pnpm 10 exact approval adopter install and upgrade guidance passed 0.51 ms the README teaches installed CLI check adopter install and upgrade guidance passed 3.53 ms the README teaches vitest subpath requirement adopter install and upgrade guidance passed 0.54 ms the README teaches recipe subject as params adopter install and upgrade guidance passed 0.49 ms glosses the format and the file, and the README defines them the same way the carrier's two levels passed 0.85 ms refuses wrapped continuation taught grammar agrees with parser behavior passed 3 ms refuses indented continuation taught grammar agrees with parser behavior passed 0.41 ms allows leading prose under either owner and refuses it under both taught grammar agrees with parser behavior passed 2.22 ms refuses Note as a plain Rule entry taught grammar agrees with parser behavior passed 0.47 ms refuses Note as a plain Workflow entry taught grammar agrees with parser behavior passed 0.35 ms refuses Note as a plain Contract entry taught grammar agrees with parser behavior passed 0.39 ms refuses Note as a plain Verification — manual entry taught grammar agrees with parser behavior passed 1.08 ms refuses unique Model terms duplicates taught grammar agrees with parser behavior passed 0.88 ms refuses unique Design keys duplicates taught grammar agrees with parser behavior passed 0.31 ms refuses unique UI keys via Design form duplicates taught grammar agrees with parser behavior passed 0.32 ms refuses single Intent actor duplicates taught grammar agrees with parser behavior passed 0.87 ms refuses single Intent problem duplicates taught grammar agrees with parser behavior passed 0.39 ms refuses single Intent outcome duplicates taught grammar agrees with parser behavior passed 0.28 ms refuses single Intent value duplicates taught grammar agrees with parser behavior passed 0.26 ms refuses single Constraints statement duplicates taught grammar agrees with parser behavior passed 0.44 ms refuses single Constraints flavor duplicates taught grammar agrees with parser behavior passed 0.28 ms refuses single Constraints target duplicates taught grammar agrees with parser behavior passed 0.31 ms refuses single Constraints measurableBy duplicates taught grammar agrees with parser behavior passed 0.26 ms refuses single Decision context duplicates taught grammar agrees with parser behavior passed 0.42 ms refuses single Decision decision duplicates taught grammar agrees with parser behavior passed 0.24 ms allows Behavior alone and refuses a second primary owner taught grammar agrees with parser behavior passed 0.91 ms allows Rule alone and refuses a second primary owner taught grammar agrees with parser behavior passed 0.81 ms allows Workflow alone and refuses a second primary owner taught grammar agrees with parser behavior passed 0.37 ms allows Contract alone and refuses a second primary owner taught grammar agrees with parser behavior passed 0.37 ms allows leading prose in Design and refuses it in Constraints taught grammar agrees with parser behavior passed 0.82 ms allows the taught repeatable Intent entries taught grammar agrees with parser behavior passed 0.38 ms allows the taught repeatable Decision entries taught grammar agrees with parser behavior passed 0.41 ms extracts the key the skill's marker carries and resolves the address the skill gives it the taught question marker passed 25.51 ms leaves the address unresolved when the key stands outside the brackets the taught question marker passed 5.91 ms creates the anchored suite before generating, and the build places the registrar beside it the reviewed skill teaching passed 46.02 ms keys a step in the vocabulary, as the step-key law and the contract generator agree the reviewed skill teaching passed 11.48 ms owns publishing in one reader section that agrees with each verb's flags the reviewed skill teaching passed 3.97 ms names the vault's owned folder, the person's notes and the roots a vault run removes the reviewed skill teaching passed 1.1 ms teaches entry addresses, term addresses and anchored source citations as the engine derives them the reviewed skill teaching passed 31.26 ms states what an empty or ready answer establishes and no more the reviewed skill teaching passed 2.13 ms teaches a refused bundle as the end of pagination, as recipe 36 refuses the reviewed skill teaching passed 16.24 ms keeps corpus rules in one section whose composed rules file runs as taught the reviewed skill teaching passed 15.12 ms points every skill at the installed upgrade guide and triggers authoring on upgrades and rules the reviewed skill teaching passed 8.24 ms orders the reader as a task route and leaves recipe contracts to the catalog the reviewed skill teaching passed 1.83 ms names as entry adapters exactly the ones the demand map rules, apart from the reader joins the reviewed skill teaching passed 981.15 ms states the graph's flat topology and which node types carry lines, as the graph does the reviewed skill teaching passed 24.79 ms is its own shipped skill, which the reading skill points to the Studio on-ramp passed 1.27 ms starts from what the agent holds the Studio on-ramp passed 0.4 ms teaches the publishing run as the studio and generate verbs take it the Studio on-ramp passed 88.22 ms teaches stamping and the preview workflow as the workflow declares them the Studio on-ramp passed 11.61 ms has the preview's run evidence checked against the stamp, never assumed to match it the Studio on-ramp passed 6 ms maps each task to a page the Studio writes, and states what a page does not the Studio on-ramp passed 65.25 ms receives the composing panel's hand-off through the proposal check the Studio on-ramp passed 19.69 ms cites resolving Studio Specs for law and leaves flags to each verb's help the Studio on-ramp passed 257.75 ms is its own shipped skill, which the reading skill points to the vault on-ramp passed 5.07 ms places the vault where the command accepts it the vault on-ramp passed 6.31 ms keeps the person's notes outside the folder the command owns the vault on-ramp passed 0.8 ms teaches synchronizing and watching as the verbs and the failed index state them the vault on-ramp passed 0.77 ms names every refusal the guard prints and how to recover from it the vault on-ramp passed 1.19 ms converts a note's links back to the addresses the vault wrote, then checks the proposal the vault on-ramp passed 61.94 ms takes the proposal's base from the graph the person read, never from the latest synchronization the vault on-ramp passed 12.13 ms cites resolving vault Specs for law and leaves flags to the verb's help the vault on-ramp passed 188.18 ms
Design view
Requirement drawing
- Declared verifying examples: no declared verifying example.
Scroll horizontally to read the whole drawing.
The diagram as text
- spec:consumers.reading-on-ramp: The reading skill teaches agents to query the graph · declared Spec
- spec:consumers.studio-on-ramp: The Studio skill teaches agents to publish, share and read the Spec Studio · declared Spec
- spec:consumers.vault-on-ramp: The vault skill teaches agents to keep an Obsidian vault of the graph · declared Spec
- spec:consumers.agent-surface: Agents script a visible typed graph · declared Spec
- impl:protocol.reading-on-ramp: asserts realization of the shipped graph-reading skill document · anchored code ·
test/skills.test.ts:663 - impl:protocol.studio-on-ramp: asserts realization of the shipped Studio skill document · anchored code ·
test/skills.test.ts:1740 - impl:protocol.vault-on-ramp: asserts realization of the shipped vault skill document · anchored code ·
test/skills.test.ts:2074 - test:protocol.reading-on-ramp: skill-asset checks verify the graph-reading on-ramp · anchored test binding · binding present ·
test/skills.test.ts:670 - test:protocol.studio-on-ramp: skill-asset checks verify the Studio on-ramp against the verbs, workflow and pages · anchored test binding · binding present ·
test/skills.test.ts:1747 - test:protocol.vault-on-ramp: skill-asset checks verify the vault on-ramp against the verb, its guard and its notes · anchored test binding · binding present ·
test/skills.test.ts:2081 - spec:consumers.reading-on-ramp refines spec:consumers.agent-surface · declared
- spec:consumers.studio-on-ramp refines spec:consumers.reading-on-ramp · declared — a Studio page is a person's reading of the one graph, and the skill sends an agent from a page to the graph behind it
- spec:consumers.vault-on-ramp refines spec:consumers.reading-on-ramp · declared — a vault note is a person's reading of the one graph, and the skill turns what the person writes beside it into checked edits
- impl:protocol.reading-on-ramp satisfies spec:consumers.reading-on-ramp · anchored
- impl:protocol.studio-on-ramp satisfies spec:consumers.studio-on-ramp · anchored
- impl:protocol.vault-on-ramp satisfies spec:consumers.vault-on-ramp · anchored
- test:protocol.reading-on-ramp verifies spec:consumers.reading-on-ramp · anchored
- test:protocol.studio-on-ramp verifies spec:consumers.studio-on-ramp · anchored
- test:protocol.vault-on-ramp verifies spec:consumers.vault-on-ramp · anchored
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
- The agent front door is one evaluation sink over the exported reader
The front door is two entrances over one seam: the package exports the reader constructor, and the CLI carries a single evaluation sink that derives the graph in process, injects that same reader, and prints the body's pre-shaped return.
Runtime
impl:protocol.reading-on-ramp· asserts realization of the shipped graph-reading skill document ·test/skills.test.ts:663Uses
None.
Runtime observation: not tracked.
Evidence
Runtime observation: not tracked.
Build attestations: not tracked.
Deployments: not tracked.
Bills of materials: not tracked.
Impact
The diagram as text
- spec:consumers.agent-surface: Agents script a visible typed graph
- spec:consumers.reading-on-ramp: The reading skill teaches agents to query the graph
- spec:consumers.studio-on-ramp: The Studio skill teaches agents to publish, share and read the Spec Studio
- spec:consumers.vault-on-ramp: The vault skill teaches agents to keep an Obsidian vault of the graph
- spec:decisions.agent-front-door: The agent front door is one evaluation sink over the exported reader
- spec:consumers.reading-on-ramp decidedBy spec:decisions.agent-front-door · declared
- spec:consumers.reading-on-ramp refines spec:consumers.agent-surface · declared
- spec:consumers.studio-on-ramp refines spec:consumers.reading-on-ramp · declared — a Studio page is a person's reading of the one graph, and the skill sends an agent from a page to the graph behind it
- spec:consumers.vault-on-ramp refines spec:consumers.reading-on-ramp · declared — a vault note is a person's reading of the one graph, and the skill turns what the person writes beside it into checked edits
Mermaid source
Copyable source; the Studio draws static SVG.
Preferred syntax: flowchart. Chosen syntax: labelled flowchart, preserving exact relations, claims and folds.
Rests on
- refines · spec:consumers.agent-surface · stated ready, floor ready
- decidedBy · spec:decisions.agent-front-door · stated ready, floor ready
Rested on by
Distance 1
- spec:consumers.studio-on-ramp
Implementing units
impl:protocol.studio-on-ramp·test/skills.test.ts:1740
Referencing units
None.
Enabled verifiers: test:protocol.studio-on-ramp
- spec:consumers.vault-on-ramp
Implementing units
impl:protocol.vault-on-ramp·test/skills.test.ts:2074
Referencing units
None.
Enabled verifiers: test:protocol.vault-on-ramp
Relations
| Relation and direction | Other end | Claim | Reason | Exercised keys |
|---|---|---|---|---|
| decidedBy · outgoing | The agent front door is one evaluation sink over the exported readerspec:decisions.agent-front-door · resolves | declared | None | None |
| refines · outgoing | Agents script a visible typed graphspec:consumers.agent-surface · resolves | declared | None | None |
| refines · incoming | The Studio skill teaches agents to publish, share and read the Spec Studiospec:consumers.studio-on-ramp · resolves | declared | a Studio page is a person's reading of the one graph, and the skill sends an agent from a page to the graph behind it | None |
| refines · incoming | The vault skill teaches agents to keep an Obsidian vault of the graphspec:consumers.vault-on-ramp · resolves | declared | a vault note is a person's reading of the one graph, and the skill turns what the person writes beside it into checked edits | None |
Bindings
Implementation binding: present
impl:protocol.reading-on-ramp· asserts realization of the shipped graph-reading skill document ·test/skills.test.ts:663
Design reference: none
Verifier binding: present
- test:protocol.reading-on-ramp · skill-asset checks verify the graph-reading on-ramp · anchored ·
test/skills.test.ts:670· 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.