<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/adr/3.x/2026-08-16-2-open-packs-is-source-of-truth-for-built-in-doctrine/">
  <id>https://docs.spec-kitty.ai/adr/3.x/2026-08-16-2-open-packs-is-source-of-truth-for-built-in-doctrine/</id>
  <title>ADR: Open-packs Is the Source of Truth for Built-in Doctrine; Core Pins and Fetches It (amended)</title>
  <updated>2026-08-16T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/adr/3.x/2026-08-16-2-open-packs-is-source-of-truth-for-built-in-doctrine/"/>
  <summary>Built-in doctrine is authored in spec-kitty-open-packs; core pins it by commit and fetches the verified tree, so consumers see no change (amended 2026-10-19; was a CI re-vendor).</summary>
  <content type="html">&lt;h2 id=&quot;open-packs-is-the-source-of-truth-for-built-in-doctrine-core-pins-and-fetches-it&quot;&gt;Open-packs Is the Source of Truth for Built-in Doctrine; Core Pins and Fetches It&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Original title (2026-08-16):&lt;/strong&gt; Open-packs Is the Source of Truth for Built-in Doctrine; CI
Re-vendors It Into the Core Release. Retitled for the 2026-10-19 amendment (#6482); the
decision text below is unchanged.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Filename:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;2026-08-16-2-open-packs-is-source-of-truth-for-built-in-doctrine.md&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; Accepted&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Date:&lt;/strong&gt; 2026-08-16&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Deciders:&lt;/strong&gt; Maintainer&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Technical Story:&lt;/strong&gt; Internal doctrine-pack initiative; grounds on core #2196 (catfooding) and the open-packs catalog. Depends on the open-packs distribution umbrella (#2466) and the pack manifest schema / validator / checksum work (#2467, #2471, #2539/#2543). Supersedes the “built-in is authored in core” assumption carried by mission &lt;code dir=&quot;auto&quot;&gt;relocate-builtin-doctrine-packs-01KYT87F&lt;/code&gt;.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;amendment-2026-10-11--pre-spec-grounding-for-3504&quot;&gt;Amendment (2026-10-11 — pre-spec grounding for #3504)&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;This amendment refines Option B. It does not replace it.&lt;/strong&gt; The decision text below is
unchanged history. Where the two disagree, this amendment binds.&lt;/p&gt;
&lt;h3 id=&quot;why-it-was-needed&quot;&gt;Why it was needed&lt;/h3&gt;
&lt;p&gt;The pre-spec research squad for &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/3504&quot;&gt;#3504&lt;/a&gt;
found that the original text left the deciding questions open and had gone stale:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;As of 2026-10-11, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-open-packs&lt;/code&gt; holds &lt;strong&gt;no&lt;/strong&gt; built-in content and has &lt;strong&gt;no&lt;/strong&gt;
tags. There is nothing to pin. Moving the content is a prerequisite, tracked in
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-open-packs/issues/31&quot;&gt;open-packs#31&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Option C cites &lt;code dir=&quot;auto&quot;&gt;src/doctrine/hatch_build.py&lt;/code&gt; and the nested-doctrine-wheel groundwork.
Both were deleted when doctrine was absorbed into &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/&lt;/code&gt;
(mission &lt;code dir=&quot;auto&quot;&gt;charter-code-topology-01M152G1&lt;/code&gt;). Option C now needs a fresh wheel design (#3101).&lt;/li&gt;
&lt;li&gt;The release builds with &lt;code dir=&quot;auto&quot;&gt;python -m build&lt;/code&gt;, not a bare &lt;code dir=&quot;auto&quot;&gt;hatch build&lt;/code&gt;. “Before &lt;code dir=&quot;auto&quot;&gt;hatch build&lt;/code&gt;”
below means “before the distribution build”, in &lt;code dir=&quot;auto&quot;&gt;release.yml&lt;/code&gt; and the manual pre-tag
build in &lt;code dir=&quot;auto&quot;&gt;RELEASE_CHECKLIST.md&lt;/code&gt; alike.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;amended-decisions&quot;&gt;Amended decisions&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;The vendored tree stays committed.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; remains tracked in core, but it
is read-only there: it changes only through a pin bump, and a CI drift gate fails any PR
whose tree does not match the pin. Materializing it at build time is rejected because it
would make every checkout, worktree, lane worktree and CI shard fetch before any test ran,
would break offline development, and would leave the nightly gate (which checks the exact
release SHA) testing a tree the release never ships. The “local materialize path” in
Consequences is therefore optional tooling, not a requirement.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Pin format.&lt;/strong&gt; A committed lockfile records the open-packs repository URL, a &lt;strong&gt;commit
SHA&lt;/strong&gt; (a tag is metadata, never the pin) and a tree digest computed with the existing
&lt;code dir=&quot;auto&quot;&gt;charter.offering.packs&lt;/code&gt; hashing (&lt;code dir=&quot;auto&quot;&gt;snapshot_sha256&lt;/code&gt; and the manifest hash). It is
verified on every PR and again at release, never at consumer runtime: the wheel is
immutable, and &lt;code dir=&quot;auto&quot;&gt;pack-manifest.yaml&lt;/code&gt; already carries a &lt;code dir=&quot;auto&quot;&gt;content_hash&lt;/code&gt; for every file.
A plain SHA-256 pin is enough to start. #2539, #2543, #2467 and #2471 strengthen it
later and do not block it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;One producer for the manifest.&lt;/strong&gt; Open-packs generates &lt;code dir=&quot;auto&quot;&gt;pack-manifest.yaml&lt;/code&gt; with the
core validator at the core version it declares. Core verifies it and never regenerates
vendored content.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Compatibility is declared.&lt;/strong&gt; Mission-step prompts name CLI commands and flags, and
step contracts bind to runtime action indices, so the content cannot be versioned
independently of core. The authored &lt;code dir=&quot;auto&quot;&gt;pack.yaml&lt;/code&gt; gains a core-compatibility range
(&lt;code dir=&quot;auto&quot;&gt;requires_core&lt;/code&gt;), checked at vendor time. A change that touches a CLI command or a
contract lands as a pair: the open-packs PR first, then a core PR that bumps the pin.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Scope of the inversion.&lt;/strong&gt; Only the consumer &lt;code dir=&quot;auto&quot;&gt;built-in&lt;/code&gt; tier moves. &lt;code dir=&quot;auto&quot;&gt;packs/internal/&lt;/code&gt;
(ADR &lt;code dir=&quot;auto&quot;&gt;2026-08-16-3&lt;/code&gt;) stays authored in core. Pack skills (ADR &lt;code dir=&quot;auto&quot;&gt;2026-09-27-1&lt;/code&gt;) that ship
in &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; move with the rest of its content.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The authoring flip is a separate, later step.&lt;/strong&gt; Until it is ruled on by the operator,
contributors keep editing &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; in core, as CLAUDE.md says. Moving authorship
to open-packs, and with it CLAUDE.md, the charter and the template-source guidance, is
its own slice after the pin and drift gate are live.&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;sequence&quot;&gt;Sequence&lt;/h3&gt;
&lt;p&gt;open-packs#31 (seed the content, map the layout, first tag, &lt;code dir=&quot;auto&quot;&gt;requires_core&lt;/code&gt;) → amend core
(this ADR) → #3504 (lockfile, &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack vendor&lt;/code&gt;, drift gate, release
re-verification) → the authoring flip → Option C (#3022), unchanged as the north star.&lt;/p&gt;
&lt;h2 id=&quot;amendment-2026-10-19--pin-and-fetch-replace-committed-trees-6451&quot;&gt;Amendment (2026-10-19 — pin and fetch replace committed trees, #6451)&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;This amendment refines the 2026-10-11 amendment. It does not replace the decision text.&lt;/strong&gt;
Where they disagree, this amendment binds.&lt;/p&gt;
&lt;h3 id=&quot;decision&quot;&gt;Decision&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;The committed &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;packs/internal/&lt;/code&gt; trees are no longer tracked in
this repository. Each tier is held as a pin lockfile, &lt;code dir=&quot;auto&quot;&gt;packs/built-in.source.yaml&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;packs/internal.source.yaml&lt;/code&gt; (repository, commit SHA, subtree, clean-tree digest,
&lt;code dir=&quot;auto&quot;&gt;requires_core&lt;/code&gt;). Direction is open-packs to core.&lt;/li&gt;
&lt;li&gt;The trees are fetched from the pinned commit by &lt;code dir=&quot;auto&quot;&gt;make sync-packs&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;scripts/sync_packs.py&lt;/code&gt;, over &lt;code dir=&quot;auto&quot;&gt;charter.offering.packs.pack_fetch&lt;/code&gt;). The fetch is
cached under &lt;code dir=&quot;auto&quot;&gt;${XDG_CACHE_HOME:-~/.cache}/spec-kitty/open-packs/&amp;#x3C;sha&gt;/&amp;#x3C;subtree&gt;&lt;/code&gt;,
digest-verified on every cache read and every placement, and placed into the working
tree. No &lt;code dir=&quot;auto&quot;&gt;[tool.uv.sources]&lt;/code&gt; entry is involved: the subtree comes from the pin.&lt;/li&gt;
&lt;li&gt;Upstream layout is &lt;code dir=&quot;auto&quot;&gt;packs/built-in&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;packs/internal&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;spec-kitty-open-packs&lt;/code&gt;
(open-packs#50). Pack content is authored there. Core then bumps the pin with
&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter pack vendor --pack &amp;#x3C;built-in|internal&gt; --ref &amp;#x3C;sha&gt;&lt;/code&gt;, which resolves
the ref to a SHA, enforces &lt;code dir=&quot;auto&quot;&gt;requires_core&lt;/code&gt; and rewrites only the lockfile.
&lt;code dir=&quot;auto&quot;&gt;vendor --check&lt;/code&gt; verifies the placed tree against the pin offline.&lt;/li&gt;
&lt;li&gt;A source checkout whose built-in tree was never fetched fails closed with
&lt;code dir=&quot;auto&quot;&gt;BuiltInPackMissing&lt;/code&gt;, which names &lt;code dir=&quot;auto&quot;&gt;make sync-packs&lt;/code&gt;. An installed wheel is unaffected.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;consequences&quot;&gt;Consequences&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Editing a file under &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; in a core checkout is no longer a change: the
tree is regenerated from the pin. Author upstream, then bump.&lt;/li&gt;
&lt;li&gt;Every lane or coordination worktree runs &lt;code dir=&quot;auto&quot;&gt;make sync-packs&lt;/code&gt; once; the shared cache makes
later runs cheap and offline-capable (&lt;code dir=&quot;auto&quot;&gt;--offline&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Fetch failures carry stable codes: &lt;code dir=&quot;auto&quot;&gt;PACK_PIN_INVALID&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PACK_COMMIT_UNRESOLVABLE&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;PACK_SYNC_UNAVAILABLE&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PACK_DIGEST_MISMATCH&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PACK_TREE_STALE&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The packaging invariant is unchanged. Consumers still receive byte-identical built-in
content in the wheel, and &lt;code dir=&quot;auto&quot;&gt;packs/internal/&lt;/code&gt; is still excluded from the wheel and sdist
(see ADR &lt;code dir=&quot;auto&quot;&gt;2026-08-16-3&lt;/code&gt;). Procedure: &lt;code dir=&quot;auto&quot;&gt;docs/development/how-to/sync-packs.md&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;Built-in doctrine content today is authored &lt;strong&gt;inside&lt;/strong&gt; the core repository at
&lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; and shipped to consumers by force-inclusion in the PyPI wheel
(mission &lt;code dir=&quot;auto&quot;&gt;relocate-builtin-doctrine-packs-01KYT87F&lt;/code&gt; relocated it there from
&lt;code dir=&quot;auto&quot;&gt;src/doctrine/**&lt;/code&gt; and drew the shared &lt;code dir=&quot;auto&quot;&gt;resolve_pack_root(tier)&lt;/code&gt; seam). The
&lt;code dir=&quot;auto&quot;&gt;spec-kitty-open-packs&lt;/code&gt; repository was created to be the &lt;strong&gt;canonical, curated,
community-friendly publishing home&lt;/strong&gt; for doctrine packs — its own vision statement
frames the monolithic built-in bundle as &lt;em&gt;the problem&lt;/em&gt; open-packs answers, yet its
“division of responsibility” table still keeps built-in authored in core while
open-packs only carves &lt;em&gt;additive&lt;/em&gt; slices from it.&lt;/p&gt;
&lt;p&gt;That leaves the ownership of built-in content ambiguous and split: the place that
is meant to be the curation home (open-packs) is not the source, and the place that
is not meant to own content (core) is. We want a single, unambiguous source of truth
for doctrine &lt;strong&gt;content&lt;/strong&gt;, without changing anything a consumer experiences (built-in
must still arrive, transparently, with a normal &lt;code dir=&quot;auto&quot;&gt;pip install&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;The mechanics of doctrine — the resolver, DRG merge, charter activation, and the
validator — are deliberately &lt;strong&gt;out of scope&lt;/strong&gt;: they stay in core (per the open-packs
vision and the doctrine-layer-merge-semantics ADR). This decision is only about where
the built-in &lt;strong&gt;content&lt;/strong&gt; is authored and how it reaches the shipped artifact.&lt;/p&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;One unambiguous source of truth for doctrine content — the curation home, not core.&lt;/li&gt;
&lt;li&gt;Consumer experience unchanged: built-in still ships in the core wheel, transparently.&lt;/li&gt;
&lt;li&gt;Reuse the already-built resolution seam (&lt;code dir=&quot;auto&quot;&gt;resolve_pack_root(&quot;built-in&quot;)&lt;/code&gt; is a
filesystem ancestor-walk); do not force a runtime resolver rewrite.&lt;/li&gt;
&lt;li&gt;Keep doctrine &lt;em&gt;mechanics&lt;/em&gt; in core; move only &lt;em&gt;content&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;Honour the graduated-trust direction (checksum-verifiable packs) rather than an
opaque copy.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;A — Status quo:&lt;/strong&gt; built-in authored in core; open-packs adds only additive org slices.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;B — Invert with CI re-vendor (chosen):&lt;/strong&gt; built-in content authored in open-packs;
a release-time CI step vendors it into &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; before &lt;code dir=&quot;auto&quot;&gt;hatch build&lt;/code&gt;, so the
wheel still force-includes it. Resolution is unchanged because it is filesystem-based.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;C — Published data dependency:&lt;/strong&gt; built-in ships as a separate PyPI data package
(e.g. &lt;code dir=&quot;auto&quot;&gt;spec-kitty-doctrine&lt;/code&gt;) that core depends on and resolves at runtime from the
installed dependency.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen option: “B — Invert with CI re-vendor”,&lt;/strong&gt; because it makes open-packs the
single source of truth for content while leaving the consumer install, the runtime
resolver, and the core mechanics untouched. Built-in remains present on disk at build
time (satisfying the parity and corpus gates) and in the wheel (satisfying consumers),
but its &lt;strong&gt;canonical origin&lt;/strong&gt; becomes the open-packs catalog. Option C is the eventual
“north star” but requires the dormant nested-doctrine-wheel groundwork
(&lt;code dir=&quot;auto&quot;&gt;src/doctrine/hatch_build.py&lt;/code&gt;, guarded dormant by &lt;code dir=&quot;auto&quot;&gt;test_doctrine_wheel_closure.py&lt;/code&gt;) to
become a real published package plus a resolver that finds packs inside an installed
dependency — a larger lift deferred until the manifest/checksum work (#2467/#2539) lands.
Option A is rejected because it permanently contradicts the open-packs vision and leaves
content ownership split.&lt;/p&gt;
&lt;h3 id=&quot;consequences-1&quot;&gt;Consequences&lt;/h3&gt;
&lt;h4 id=&quot;positive&quot;&gt;Positive&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;Single curation home; contributors and SK Inc. maintain built-in where the catalog,
docsite, and validator already live.&lt;/li&gt;
&lt;li&gt;Consumers see no change — same &lt;code dir=&quot;auto&quot;&gt;pip install&lt;/code&gt;, same force-included &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The runtime resolver, DRG merge, and charter activation are untouched.&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;negative&quot;&gt;Negative&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;Core’s release now has a &lt;strong&gt;build-time dependency&lt;/strong&gt; on open-packs (a checkout/copy step
before &lt;code dir=&quot;auto&quot;&gt;hatch build&lt;/code&gt;); a broken or unpinned open-packs breaks the core release.&lt;/li&gt;
&lt;li&gt;Release reproducibility now depends on a &lt;strong&gt;pinned open-packs ref&lt;/strong&gt; (tag or SHA), which
must be recorded and verified (ideally by checksum) at build time.&lt;/li&gt;
&lt;li&gt;Parity/corpus gates (&lt;code dir=&quot;auto&quot;&gt;test_packaging_parity.py&lt;/code&gt;, the &lt;code dir=&quot;auto&quot;&gt;packs&lt;/code&gt;-triggered CI jobs) assume
&lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; is present in-tree; the vendor step must complete before they run,
and contributor checkouts need a documented way to materialize built-in locally.&lt;/li&gt;
&lt;li&gt;Runs against the direction of the shared-package-boundary ADR (which retired vendored
&lt;em&gt;code&lt;/em&gt; in favour of a published dependency). Packs are &lt;strong&gt;data, not code&lt;/strong&gt;, so that ADR
does not bind — but the tension is real and Option C remains the longer-term resolution.&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;neutral&quot;&gt;Neutral&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; continues to exist in the core tree; only its provenance changes.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;p&gt;Success = (1) built-in content has exactly one authoritative copy (open-packs), pinned by
ref/checksum in the core release; (2) a released wheel’s &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; is byte-identical
to the pinned open-packs content; (3) &lt;code dir=&quot;auto&quot;&gt;test_packaging_parity.py&lt;/code&gt; and the corpus jobs stay
green against the vendored tree; (4) consumers observe no behavioural change. &lt;strong&gt;Not yet
built&lt;/strong&gt; — this ADR ratifies direction; the implementation is a separate epic gated on
open-packs CI scaffolding (none exists today) and the manifest/checksum dependencies above.&lt;/p&gt;
&lt;h2 id=&quot;pros-and-cons-of-the-options&quot;&gt;Pros and Cons of the Options&lt;/h2&gt;
&lt;h3 id=&quot;a--status-quo-built-in-in-core&quot;&gt;A — Status quo (built-in in core)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt; No build-time coupling; simplest release; reproducible from one repo.
&lt;strong&gt;Cons:&lt;/strong&gt; Content ownership stays split; contradicts the open-packs vision; two curation
surfaces for the same corpus.&lt;/p&gt;
&lt;h3 id=&quot;b--invert-with-ci-re-vendor&quot;&gt;B — Invert with CI re-vendor&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt; Single source of truth; unchanged consumer + runtime; reuses the filesystem seam.
&lt;strong&gt;Cons:&lt;/strong&gt; Build-time dependency on open-packs; release must pin + verify a ref; local
checkouts need a materialize step.&lt;/p&gt;
&lt;h3 id=&quot;c--published-data-dependency&quot;&gt;C — Published data dependency&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt; Cleanest boundary; aligns with the shared-package-boundary philosophy; no vendoring.
&lt;strong&gt;Cons:&lt;/strong&gt; Largest lift — needs the dormant doctrine wheel productionized and a resolver that
reads packs from an installed dependency; blocked on manifest/checksum work.&lt;/p&gt;
&lt;h2 id=&quot;more-information&quot;&gt;More Information&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Open-packs vision: &lt;code dir=&quot;auto&quot;&gt;spec-kitty-open-packs/docs/architecture/vision.md&lt;/code&gt; (division-of-responsibility
table is amended by this ADR: built-in &lt;em&gt;content&lt;/em&gt; now originates in open-packs).&lt;/li&gt;
&lt;li&gt;Blockers: &lt;code dir=&quot;auto&quot;&gt;spec-kitty-open-packs/docs/research/blockers-and-core-dependencies.md&lt;/code&gt; (#2466/#2467/#2471/#2539).&lt;/li&gt;
&lt;li&gt;Companion decision: &lt;code dir=&quot;auto&quot;&gt;2026-08-16-3-spec-kitty-internal-is-a-public-org-pack-not-force-shipped.md&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
