<?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-09-27-1-pack-skills-share-commands-through-charter-packs/">
  <id>https://docs.spec-kitty.ai/adr/3.x/2026-09-27-1-pack-skills-share-commands-through-charter-packs/</id>
  <title>ADR: pack skills — share and co-maintain agent commands through charter packs</title>
  <updated>2026-09-27T00: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-09-27-1-pack-skills-share-commands-through-charter-packs/"/>
  <summary>Accepted: a charter-activatable `skill` doctrine kind so teams share and co-maintain agent commands through pack tiers, not private per-user copies.</summary>
  <content type="html">&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-09-27 (accepted 2026-10-04, mission &lt;code dir=&quot;auto&quot;&gt;pack-skills-kind-01M43419&lt;/code&gt;)&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Deciders:&lt;/strong&gt; Stijn Dejongh (owner). Design produced by a profile-loaded research and
architecture squad: &lt;code dir=&quot;auto&quot;&gt;researcher-robbie&lt;/code&gt; (prior art), &lt;code dir=&quot;auto&quot;&gt;architect-alphonso&lt;/code&gt; (design),
&lt;code dir=&quot;auto&quot;&gt;doctrine-daphne&lt;/code&gt; (doctrine integrity), &lt;code dir=&quot;auto&quot;&gt;paula-patterns&lt;/code&gt; (second-opinion adjudication).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Technical Story:&lt;/strong&gt; &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/5193&quot;&gt;#5193&lt;/a&gt; (implementation tracking, under epic &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/2466&quot;&gt;#2466&lt;/a&gt;).&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;Spec Kitty’s vision is governed, shared, consistent AI usage. Doctrine already delivers that
for &lt;em&gt;rules and techniques&lt;/em&gt;: directives, tactics, procedures, and profiles live in pack tiers
(&lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; for consumers, org packs such as &lt;code dir=&quot;auto&quot;&gt;packs/internal/&lt;/code&gt; for a team, and the
project’s &lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/&lt;/code&gt;), are merged by &lt;code dir=&quot;auto&quot;&gt;merge_three_layers&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/merge.py&lt;/code&gt;), and are switched on per project through
&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;There is no equivalent for the &lt;strong&gt;entry points&lt;/strong&gt; people actually type. The shorthands a team
relies on (for this repository: landing a contributor PR, driving a mission from an issue,
triaging the tracker, curating memory) live as private, per-user agent skills. The research
pass found:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;No pack can ship a skill or command today.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;SkillRegistry&lt;/code&gt; reads one package root
(&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/skills/registry.py:66-93&lt;/code&gt;); the command-skill set is a closed tuple with a
parity assert (&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/skills/command_installer.py:81-106&lt;/code&gt;); every rendered command
is forced to &lt;code dir=&quot;auto&quot;&gt;spec-kitty.&amp;#x3C;cmd&gt;&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/skills/command_renderer.py:468&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No doctrine concept exists&lt;/strong&gt; for a skill, command, alias, or shorthand, and no ADR, spec,
or plan discusses shareable entry points.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The private copies duplicate doctrine and drift.&lt;/strong&gt; The landing shorthand restates the
internal procedure &lt;code dir=&quot;auto&quot;&gt;landing-contributor-prs&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;packs/internal/procedures/landing-contributor-prs.procedure.yaml&lt;/code&gt;) and already cites a doc
path that does not exist (&lt;code dir=&quot;auto&quot;&gt;docs/development/pr-landing.md&lt;/code&gt;; the page is
&lt;code dir=&quot;auto&quot;&gt;docs/development/how-to/pr-landing.md&lt;/code&gt;). Memory curation restates
&lt;code dir=&quot;auto&quot;&gt;memory-curation-and-escalation&lt;/code&gt;; triage restates the built-in
&lt;code dir=&quot;auto&quot;&gt;tracker-organisation-workflow&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;issue-triage-state-machine&lt;/code&gt; procedures.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;They hard-code people and places&lt;/strong&gt; (an operator handle, the repository slug, check
names) and &lt;strong&gt;squat on the built-in &lt;code dir=&quot;auto&quot;&gt;spk-&lt;/code&gt; namespace&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/README.md&lt;/code&gt;,
“Naming Convention”).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;A second, drifting, unreviewed copy of doctrine per person is exactly what the charter’s
&lt;em&gt;single canonical authority&lt;/em&gt; principle forbids. Sharing a shorthand today means pasting it
into someone else’s account.&lt;/p&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Single canonical authority&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;DIRECTIVE_044&lt;/code&gt;): the substance stays in procedures; the
entry point must reference it, not restate it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Relationships are DRG edges, not fields.&lt;/strong&gt; ADR
&lt;a href=&quot;/adr/3.x/2026-07-26-1-drg-edges-are-the-canonical-relationship-authority/&quot;&gt;2026-07-26-1&lt;/a&gt; treats inline
&lt;code dir=&quot;auto&quot;&gt;references:&lt;/code&gt; as pre-DRG residue (pinned by &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_reference_enum_ratchet.py&lt;/code&gt;);
C-009 says the same for profile lineage.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;One activation authority.&lt;/strong&gt; The only non-kind activatable token today, &lt;code dir=&quot;auto&quot;&gt;mission-type&lt;/code&gt;, is
recorded as debt awaiting promotion (ADR &lt;a href=&quot;/adr/3.x/2026-08-05-1-mission-type-availability-before-kind-promotion/&quot;&gt;2026-08-05-1&lt;/a&gt;). A second outlier would be a
parallel authority.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Pack-tier boundary&lt;/strong&gt; (ADR &lt;a href=&quot;/adr/3.x/2026-08-16-3-spec-kitty-internal-is-a-public-org-pack-not-force-shipped/&quot;&gt;2026-08-16-3&lt;/a&gt;): in-house shorthands must never ship in the wheel.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Terminology canon:&lt;/strong&gt; do not add an eighth sense of “command” or a fifth of “alias”.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Every configured tool&lt;/strong&gt;, not one harness: 13 slash-command tools plus 4 Agent Skills tools.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Trust:&lt;/strong&gt; a shared prompt runs with the tool’s repository permissions.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;New doctrine kind &lt;code dir=&quot;auto&quot;&gt;command&lt;/code&gt;&lt;/strong&gt; (“Pack Command”; forms &lt;code dir=&quot;auto&quot;&gt;full | alias&lt;/code&gt;), DRG-wired and
charter-activatable (architect’s draft).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No new kind: “pack skills” on the existing skill surface&lt;/strong&gt;, installed whenever their bound
procedure is active, with the binding in SKILL.md frontmatter (doctrine-integrity lens).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;New doctrine kind &lt;code dir=&quot;auto&quot;&gt;skill&lt;/code&gt;&lt;/strong&gt; (URN &lt;code dir=&quot;auto&quot;&gt;skill:&amp;#x3C;id&gt;&lt;/code&gt;, prose “pack skill”; forms &lt;code dir=&quot;auto&quot;&gt;prompt | wrapper&lt;/code&gt;),
DRG-wired, charter-activatable, projected by the managed doctrine-skill installer
(adjudicated synthesis of 1 and 2).&lt;/li&gt;
&lt;li&gt;Make procedures directly invocable (&lt;code dir=&quot;auto&quot;&gt;invocable: true&lt;/code&gt; on &lt;code dir=&quot;auto&quot;&gt;procedure&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Tool-native plugin marketplaces (for example Claude Code plugins).&lt;/li&gt;
&lt;li&gt;An alias layer inside the command-skill pipeline (&lt;code dir=&quot;auto&quot;&gt;shortcodes.yaml&lt;/code&gt; per pack, resolved in
&lt;code dir=&quot;auto&quot;&gt;command_renderer.render()&lt;/code&gt;), as sketched in
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/2470&quot;&gt;#2470&lt;/a&gt;.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen option: 3, a charter-activatable &lt;code dir=&quot;auto&quot;&gt;skill&lt;/code&gt; doctrine kind.&lt;/strong&gt; It keeps option 1’s
structure (a real &lt;code dir=&quot;auto&quot;&gt;ArtifactKind&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;NodeKind&lt;/code&gt;, DRG edges, charter activation) because option 2
has nowhere to put the skill → procedure binding except an inline reference block, which
ADR 2026-07-26-1 forbids, and any independent activation would add a second &lt;code dir=&quot;auto&quot;&gt;mission-type&lt;/code&gt;
style outlier. It takes option 2’s naming (“skill” is already the glossary term:
&lt;code dir=&quot;auto&quot;&gt;packs/built-in/glossary_packs/spec-kitty-core.glossary-pack.yaml:545&lt;/code&gt;) and its sequencing
(derive the lockstep kind lists first; augment procedures before thinning skills).&lt;/p&gt;
&lt;p&gt;The skills README’s rule that skills are “not the source of team workflow”
(&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/README.md:7-24&lt;/code&gt;) constrains &lt;em&gt;substance&lt;/em&gt;. A pack skill is a thin,
parameterised entry point that &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt; the procedure carrying the substance, so it
complies with that rule rather than breaking it.&lt;/p&gt;
&lt;h3 id=&quot;shape-of-the-artifact&quot;&gt;Shape of the artifact&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# packs/internal/skills/land-pr.skill.yaml   (org tier; never in the wheel)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;schema_version&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;1.0&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;land-pr&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;                        &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# URN skill:land-pr&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;title&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Land a contributor PR&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;Maintainer landing pass on a PR — triage, rebase, classify reds, squad, hand off.&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;triggers&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;land this PR&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;landing pass&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;]&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;form&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;prompt&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;                       &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# prompt | wrapper&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;body_path&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;land-pr.skill.md&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# prompt form only; copied into SKILL.md unchanged (no per-tool placeholder rewrite)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;parameters&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;pr&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;required&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;PR number or URL&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;steer&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;required&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;free-text steer&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;invocation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;user_invocable&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;true&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;model_invocable&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;           &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# forced false when side_effects is non-empty&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;side_effects&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;git-push&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;gh-write&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;]&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;tools&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;]                       &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# accepted and stored; deferred: not used to filter projection&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;version&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;1.0.0&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;maintainers&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;@spec-kitty/core&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;]&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# a wrapper-form skill: a thin shorthand over an existing command&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;ship&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;form&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;wrapper&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;expands_to&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;builtin:spec-kitty.merge&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;args&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;--strategy squash $ARGUMENTS&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Relationships live only in the pack’s DRG fragment:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;edges&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;skill:land-pr&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;procedure:landing-contributor-prs&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;requires&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;skill:land-pr&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;directive:NO_FULL_HEAVY_SUITES_IN_MISSION&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;requires&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;skill:land-pr&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;target&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;agent_profile:reviewer-renata&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;relation&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;suggests&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Dangling endpoints fail closed with &lt;code dir=&quot;auto&quot;&gt;unresolved_edge_endpoint&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/merge.py&lt;/code&gt;). The rendered skill carries a generated preamble that
fetches each &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt; target at run time with &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter context --include &amp;#x3C;urn&gt;&lt;/code&gt;,
so the substance is never copied into the skill.&lt;/p&gt;
&lt;h3 id=&quot;tiers-merge-and-activation&quot;&gt;Tiers, merge, and activation&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Tier&lt;/th&gt;&lt;th&gt;Location&lt;/th&gt;&lt;th&gt;Ships?&lt;/th&gt;&lt;th&gt;Example content&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;built-in&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/skills/&lt;/code&gt; (a generated &lt;code dir=&quot;auto&quot;&gt;skill.graph.yaml&lt;/code&gt; shard is deferred)&lt;/td&gt;&lt;td&gt;yes&lt;/td&gt;&lt;td&gt;consumer-safe shorthands (empty at MVP)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;org&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;pack&gt;/skills/&lt;/code&gt;, declared in &lt;code dir=&quot;auto&quot;&gt;drg/fragment.yaml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;required_skills:&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;org-charter.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;never for &lt;code dir=&quot;auto&quot;&gt;packs/internal&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;land-pr&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission-from-issue&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;issue-triage&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;curate-memory&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;project&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/doctrine/skills/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;repo-local&lt;/td&gt;&lt;td&gt;repository-specific shorthands&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;ul&gt;
&lt;li&gt;The built-in tier is empty at the MVP, so no &lt;code dir=&quot;auto&quot;&gt;skill.graph.yaml&lt;/code&gt; shard exists. The extractor helper
that emits built-in skill nodes (&lt;code dir=&quot;auto&quot;&gt;_emit_skill_nodes&lt;/code&gt;) is in place for when the tier gains content.&lt;/li&gt;
&lt;li&gt;Activation: &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate skill land-pr --cascade procedure,directive&lt;/code&gt;
through &lt;code dir=&quot;auto&quot;&gt;plan_activation&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;commit_plan&lt;/code&gt;; config key &lt;code dir=&quot;auto&quot;&gt;activated_skills&lt;/code&gt;. Cascade pulls in
what the skill &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;; deactivation keeps anything another active artifact still
references (C-005).&lt;/li&gt;
&lt;li&gt;Default in force when the key is absent: &lt;code dir=&quot;auto&quot;&gt;required_skills&lt;/code&gt; of registered org packs plus
built-in defaults, &lt;strong&gt;not&lt;/strong&gt; every available skill, supplied through the existing
&lt;code dir=&quot;auto&quot;&gt;effective_ids&lt;/code&gt; seam and one kind attribute rather than per-kind branching. Registering a
pack must not silently add N commands to every tool.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;overrides: skill:&amp;#x3C;id&gt;&lt;/code&gt; replaces a skill. At the MVP, overriding a &lt;strong&gt;built-in&lt;/strong&gt; skill is
refused; built-in replacement through &lt;code dir=&quot;auto&quot;&gt;replaceable-builtins.yaml&lt;/code&gt; is deferred to slice 3.
&lt;code dir=&quot;auto&quot;&gt;enhances&lt;/code&gt; may change parameter defaults, triggers, tool
targeting, or narrow invocation, but never the body or expansion. Same id in two sibling
org packs is a hard conflict.&lt;/li&gt;
&lt;li&gt;Co-maintenance: the pack’s &lt;code dir=&quot;auto&quot;&gt;pack_version&lt;/code&gt;, the skill’s &lt;code dir=&quot;auto&quot;&gt;version&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;maintainers&lt;/code&gt;, and review through the pack
repository’s PRs. A locally edited rendered copy is reported as drift pointing back at the
pack source, so tweaks become upstream PRs rather than forks.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;rendering-and-installation&quot;&gt;Rendering and installation&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;charter (pure)                                  specify_cli (adapter)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;merged DRG + activated_skills&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;└─ prepare_project_skill_activations()  ─►  resolve_project_skill_catalog(project_root)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;       &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;(id, rendered name, body, expansion,       ├─ render_pack_skill(): builds its own SKILL.md&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;        &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;provenance, source_hash)                  │   (frontmatter, context preamble, parameters,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;                                                  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│   instructions); no command_renderer, no&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;                                                  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;│   User-Input block rewrite&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;                                                  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;├─ stage under .kittify/runtime/pack-skills/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;                                                  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;├─ project skill roots only, never global&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;                                                  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;└─ .kittify/skills-manifest.json ownership&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;ul&gt;
&lt;li&gt;The &lt;strong&gt;managed doctrine-skill installer&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/skills/installer.py&lt;/code&gt;) is the
owner. &lt;code dir=&quot;auto&quot;&gt;command_installer.py&lt;/code&gt; and its &lt;code dir=&quot;auto&quot;&gt;spec-kitty.*&lt;/code&gt; contract stay closed.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;One catalog-composition seam&lt;/strong&gt; used by every caller that today builds
&lt;code dir=&quot;auto&quot;&gt;SkillRegistry.from_package()&lt;/code&gt; and installs with &lt;code dir=&quot;auto&quot;&gt;retire=True&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;init&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt;
migrations, the verifier, the managed-skills tool-surface provider). Injecting pack skills
into a single call site would let the others prune them on the next &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Charter emits unresolved &lt;code dir=&quot;auto&quot;&gt;builtin:&lt;/code&gt; expansion targets; the &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; adapter validates
them against its command set, keeping the enforced
&lt;code dir=&quot;auto&quot;&gt;kernel &amp;#x3C;- charter &amp;#x3C;- … &amp;#x3C;- specify_cli&lt;/code&gt; direction. &lt;code dir=&quot;auto&quot;&gt;cli:&lt;/code&gt; targets are limited to
&lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt; argv.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project scope only.&lt;/strong&gt; Activation is per repository, so rendered skills go to project
skill roots (&lt;code dir=&quot;auto&quot;&gt;.claude/skills/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.agents/skills/&lt;/code&gt;, and the other roots in
&lt;code dir=&quot;auto&quot;&gt;AGENT_SKILL_CONFIG&lt;/code&gt;), never to user-global directories.&lt;/li&gt;
&lt;li&gt;Coverage at MVP: the 16 tools with a project skill root, and only the primary (first-listed)
root of each (&lt;code dir=&quot;auto&quot;&gt;.agents/skills/&lt;/code&gt; for the shared-root tools). Amazon Q is wrapper-only: the
installer skips wrapper-class tools silently and raises no finding for it. A research-gap
finding for that tool, and project-local command files for non-skill tools, are deferred to
slice 3.&lt;/li&gt;
&lt;li&gt;Deactivation re-runs projection and retires manifest-owned entries only.&lt;/li&gt;
&lt;li&gt;Rendered copies are gitignored in this repository, so &lt;code dir=&quot;auto&quot;&gt;doctor&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt; compare the
freshly prepared &lt;code dir=&quot;auto&quot;&gt;source_hash&lt;/code&gt; (a &lt;code dir=&quot;auto&quot;&gt;sha256:&lt;/code&gt; digest of the skill record, its DRG &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;,
its rendered name and its body) against the &lt;code dir=&quot;auto&quot;&gt;source_hash&lt;/code&gt; in the skills-manifest provenance
(staleness, not only tampering of the rendered copy, which is reported separately as
drift against the manifest &lt;code dir=&quot;auto&quot;&gt;content_hash&lt;/code&gt;). A manifest entry the current catalog no longer
provides (for example after a namespace change) is reported as &lt;code dir=&quot;auto&quot;&gt;orphaned&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;namespaces-and-trust&quot;&gt;Namespaces and trust&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spk-&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;spec-kitty.&lt;/code&gt; are reserved for built-in. Org and project packs
declare a &lt;code dir=&quot;auto&quot;&gt;skill_namespace&lt;/code&gt;; skills render as &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;namespace&gt;-&amp;#x3C;id&gt;&lt;/code&gt;. Two activated skills that
render to the same name fail before any write; an unowned existing directory with that name
is preserved and reported (an empty directory with that name is projected into).&lt;/li&gt;
&lt;li&gt;A pack acts only after a maintainer registers it in &lt;code dir=&quot;auto&quot;&gt;charter_packs.org.packs&lt;/code&gt; (built at
the MVP). &lt;strong&gt;Deferred to slice 3:&lt;/strong&gt; remote packs pinning an immutable ref, and verifying
content hashes at preparation.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Deferred to slice 3:&lt;/strong&gt; activation printing a trust summary over the skill’s whole
&lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;suggests&lt;/code&gt; closure, assets included (assets already ship executables), and
requiring &lt;code dir=&quot;auto&quot;&gt;--accept&lt;/code&gt; for side effects or remote packs. &lt;strong&gt;Built at the MVP:&lt;/strong&gt; the validator
refuses a &lt;code dir=&quot;auto&quot;&gt;scripts/&lt;/code&gt; directory and permission-widening frontmatter (such as
&lt;code dir=&quot;auto&quot;&gt;allowed-tools&lt;/code&gt;) for org and project skills.&lt;/li&gt;
&lt;li&gt;Bindings (repository, operator) resolve at run time from project config, never baked into
rendered files; public packs carry no personal identifiers.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;ownership-proof&quot;&gt;Ownership proof&lt;/h3&gt;
&lt;p&gt;The charter’s “User Customization Preservation” rule requires any flow that mutates user-visible
skill directories to document its proof. This flow acts only on what it can prove it owns.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Ownership record.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;.kittify/skills-manifest.json&lt;/code&gt; lists every file the installer wrote, with
the &lt;code dir=&quot;auto&quot;&gt;content_hash&lt;/code&gt; it wrote. Retire (on &lt;code dir=&quot;auto&quot;&gt;deactivate&lt;/code&gt;, a namespace change, or a skill removed
from the pack) and overwrite (on a changed pack source) act only on paths in that manifest.
The installer retires an entry only when the current catalog no longer expects its path.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Validated paths.&lt;/strong&gt; Before any write the installer checks every manifest entry: the skill name
must be one path segment, the source path must be relative with no &lt;code dir=&quot;auto&quot;&gt;..&lt;/code&gt;, and the installed path
must equal &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;primary skill root&gt;/&amp;#x3C;name&gt;/&amp;#x3C;source&gt;&lt;/code&gt;. An entry that fails the check stops the
projection with “Skills manifest contains an invalid ownership path”. Removal is per file;
a directory is removed afterwards only when every entry in it was deleted.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A same-name directory the tool does not own&lt;/strong&gt; (no manifest entry) is preserved and reported,
even when it has no &lt;code dir=&quot;auto&quot;&gt;SKILL.md&lt;/code&gt;. An &lt;strong&gt;empty&lt;/strong&gt; directory with that name holds nothing to
preserve, so the installer projects into it.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A locally edited copy is kept.&lt;/strong&gt; When an owned file no longer matches its recorded
&lt;code dir=&quot;auto&quot;&gt;content_hash&lt;/code&gt;, the installer neither overwrites nor deletes it. &lt;code dir=&quot;auto&quot;&gt;charter activate&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;charter deactivate&lt;/code&gt; list it as “Skill file preserved”, and &lt;code dir=&quot;auto&quot;&gt;doctor skills&lt;/code&gt; reports it as drift.
Replacing an owned, unmodified file keeps a backup of the old copy.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Names and ids are validated before they reach a path.&lt;/strong&gt; A &lt;code dir=&quot;auto&quot;&gt;skill_namespace&lt;/code&gt; must be lowercase
ASCII: it starts with a letter, its &lt;code dir=&quot;auto&quot;&gt;[a-z0-9]&lt;/code&gt; segments are joined by single &lt;code dir=&quot;auto&quot;&gt;-&lt;/code&gt;, and it is at
most 32 characters. A skill id follows the same grammar and is at most 64 characters. The
validator never normalises a value. An invalid namespace is refused before the staging
directory or any skill root is touched; an invalid id makes the repository skip that skill file
with a warning, which &lt;code dir=&quot;auto&quot;&gt;doctor doctrine&lt;/code&gt; reports. A skill that is already in force and then
stops loading is refused instead of dropped, and the projection deletes nothing. Names that start with a reserved prefix, collide
with a built-in skill name, or are not a single safe path segment are refused the same way.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;amendment-2026-10-06-mission-skill-surface-upgrade-integrity-01m482z3&quot;&gt;Amendment 2026-10-06 (mission &lt;code dir=&quot;auto&quot;&gt;skill-surface-upgrade-integrity-01M482Z3&lt;/code&gt;)&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;New finding kind &lt;code dir=&quot;auto&quot;&gt;missing&lt;/code&gt;.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;doctor skills&lt;/code&gt; now reports a pack skill that is in force for a
configured tool that accepts skill files but is not installed, whether it was never projected or
its installed copy was deleted. Before, the health check could pass while the skill was absent.
The &lt;code dir=&quot;auto&quot;&gt;drift&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;stale&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;orphaned&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;unresolvable&lt;/code&gt; kinds are unchanged.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;doctor skills --fix&lt;/code&gt; projects missing skills.&lt;/strong&gt; It calls the same &lt;code dir=&quot;auto&quot;&gt;project_pack_skills&lt;/code&gt;
installer as &lt;code dir=&quot;auto&quot;&gt;charter activate&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt;. The projected paths appear in the additive &lt;code dir=&quot;auto&quot;&gt;repaired_paths&lt;/code&gt; list;
&lt;code dir=&quot;auto&quot;&gt;repaired_agents&lt;/code&gt; keeps agent keys only.
&lt;code dir=&quot;auto&quot;&gt;--fix&lt;/code&gt; still never repairs &lt;code dir=&quot;auto&quot;&gt;drift&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;no_tool_folder&lt;/code&gt;.&lt;/strong&gt; When none of the configured agents’ tool folders exists, &lt;code dir=&quot;auto&quot;&gt;doctor skills&lt;/code&gt;
fails and lists the finding under &lt;code dir=&quot;auto&quot;&gt;tool_folders&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Upgrade pre-check.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; uses the same findings function, so it also warns
&lt;code dir=&quot;auto&quot;&gt;pack_skill_missing&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Rationale.&lt;/strong&gt; Issue #5801: the projection and the health check disagreed about what “installed”
means. Deferred: the installer verifier and the assessment surface still do not read &lt;code dir=&quot;auto&quot;&gt;missing&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;consequences&quot;&gt;Consequences&lt;/h3&gt;
&lt;h4 id=&quot;positive&quot;&gt;Positive&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;A team shorthand has one reviewed, versioned source that reaches every configured tool.&lt;/li&gt;
&lt;li&gt;Procedures stay the single home of substance; entry points cannot silently drift from it.&lt;/li&gt;
&lt;li&gt;Private skills get a promotion path into a project or org pack.&lt;/li&gt;
&lt;li&gt;The kind is the convergence target for the built-in &lt;code dir=&quot;auto&quot;&gt;spk-*&lt;/code&gt; product skills later.&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;negative&quot;&gt;Negative&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;A new kind is real work: a row in each of the four per-kind tables in &lt;code dir=&quot;auto&quot;&gt;artifact_kinds.py&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;_PLURALS&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;_HAS_BUILT_IN_CONTENT_DIR&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;_PATTERNS&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;PROJECT_KIND_DIRS&lt;/code&gt;), three new enum
facts (&lt;code dir=&quot;auto&quot;&gt;org_requirable&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;selection_overlayable&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;effective_when_absent&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;NodeKind&lt;/code&gt;, a
doctor health dimension, an extractor helper, the delivery table (&lt;code dir=&quot;auto&quot;&gt;slot=None&lt;/code&gt; with a reason),
and roughly a dozen exact-set tests (precedent: the &lt;code dir=&quot;auto&quot;&gt;glossary_pack&lt;/code&gt; kind). A generated
&lt;code dir=&quot;auto&quot;&gt;skill.graph.yaml&lt;/code&gt; shard is deferred while the built-in tier is empty.&lt;/li&gt;
&lt;li&gt;It expands the visible slash surface per project, which the skills README otherwise avoids;
that is deliberate and scoped to activated skills only.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/skills/&lt;/code&gt; coexists with &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/&lt;/code&gt; until convergence.&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;neutral&quot;&gt;Neutral&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;Invocation costs one extra &lt;code dir=&quot;auto&quot;&gt;charter context --include&lt;/code&gt; call per required artifact.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;ATDD: activate a pack skill → it appears in &lt;code dir=&quot;auto&quot;&gt;.claude/skills/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;.agents/skills/&lt;/code&gt;;
run &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt; → still present; deactivate → removed; nothing else touched.&lt;/li&gt;
&lt;li&gt;Packaging safety: no &lt;code dir=&quot;auto&quot;&gt;packs/internal/skills/**&lt;/code&gt; path in the wheel.&lt;/li&gt;
&lt;li&gt;Deferred to slice 2: the four internal shorthands run from the pack with no private copy, and
the landing procedure carries the content that only the private skill held before. Slice 1
ships no &lt;code dir=&quot;auto&quot;&gt;packs/internal/skills/&lt;/code&gt; entry.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;delivery-slices&quot;&gt;Delivery slices&lt;/h2&gt;
&lt;ol start=&quot;0&quot;&gt;
&lt;li&gt;&lt;strong&gt;Campsite (precondition):&lt;/strong&gt; derive &lt;code dir=&quot;auto&quot;&gt;_BUILTIN_ARTIFACT_KINDS&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;src/charter/activation/pack_context.py&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;_ALLOWED_KINDS&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;src/charter/activation/activations.py&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;_ORG_DRG_KIND_ALIASES&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/org_pack_loader.py&lt;/code&gt;), and &lt;code dir=&quot;auto&quot;&gt;REQUIRED_KIND_FIELDS&lt;/code&gt; from
&lt;code dir=&quot;auto&quot;&gt;ArtifactKind&lt;/code&gt;, so this and every later kind adds no lockstep copies.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;MVP:&lt;/strong&gt; kind and node registration, schema and validator for both forms, activation and
cascade with the default-in-force rule, &lt;code dir=&quot;auto&quot;&gt;prepare_project_skill_activations&lt;/code&gt;, the catalog seam,
project-root projection, namespaces, drift and staleness findings, retire on deactivate.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Migration:&lt;/strong&gt; augment &lt;code dir=&quot;auto&quot;&gt;landing-contributor-prs&lt;/code&gt; and the other procedures with the content
only the private skills hold, then add the four thin &lt;code dir=&quot;auto&quot;&gt;packs/internal/skills/*&lt;/code&gt; entries and
retire the private copies.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Later:&lt;/strong&gt; trust &lt;code dir=&quot;auto&quot;&gt;--accept&lt;/code&gt; gate and remote pinning, command-file projection for non-skill
tools, a &lt;code dir=&quot;auto&quot;&gt;charter skill promote &amp;#x3C;dir&gt;&lt;/code&gt; scaffolder, an Op-opening preamble, and converging the
built-in &lt;code dir=&quot;auto&quot;&gt;spk-*&lt;/code&gt; skills onto the kind.&lt;/li&gt;
&lt;/ol&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;option-1-new-kind-command&quot;&gt;Option 1: new kind &lt;code dir=&quot;auto&quot;&gt;command&lt;/code&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Good: correct structure (kind, edges, activation, managed installer, project scope).&lt;/li&gt;
&lt;li&gt;Bad: “command” already has six or more senses (Slash Command, Command Template, Command
Envelope, CLI command, &lt;code dir=&quot;auto&quot;&gt;CANONICAL_COMMANDS&lt;/code&gt;, command-skill tools) and &lt;code dir=&quot;auto&quot;&gt;form: alias&lt;/code&gt; adds a
fifth sense of “alias”. Blocks later convergence of the product skills.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-2-pack-skills-without-a-kind&quot;&gt;Option 2: pack skills without a kind&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Good: cheapest doctrine-side change; reuses the glossary term.&lt;/li&gt;
&lt;li&gt;Bad: the skill → procedure link would live in frontmatter, a second relationship authority;
no own activation (breaks for wrapper skills, many skills over one procedure, and projects
that want the procedure but not the entry point); no cascade, &lt;code dir=&quot;auto&quot;&gt;--include&lt;/code&gt;, or doctor health.
The installer work, the dominant cost, is the same as option 3.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-3-new-kind-skill-chosen&quot;&gt;Option 3: new kind &lt;code dir=&quot;auto&quot;&gt;skill&lt;/code&gt; (chosen)&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Good: one relationship authority, one activation authority, canonical term, convergence path.&lt;/li&gt;
&lt;li&gt;Bad: kind-registration cost (reduced by slice 0).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-4-invocable-procedures&quot;&gt;Option 4: invocable procedures&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Bad: procedures have no parameters, bindings, or tool targeting; every procedure edit would
become a surface change.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-5-tool-native-plugin-marketplaces&quot;&gt;Option 5: tool-native plugin marketplaces&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Bad: tied to one tool; loses the single cross-tool source. It can stay a later projection
target.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-6-alias-layer-in-the-command-skill-pipeline-2470&quot;&gt;Option 6: alias layer in the command-skill pipeline (#2470)&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Good: small, reuses the existing renderer and manifest.&lt;/li&gt;
&lt;li&gt;Bad: widens the closed &lt;code dir=&quot;auto&quot;&gt;spec-kitty.*&lt;/code&gt; command-skill owner and its &lt;code dir=&quot;auto&quot;&gt;CONSUMER_SKILLS&lt;/code&gt; parity
invariant; aliases only, so no home for full prompt skills; no DRG edge to the procedure it
shortcuts, and no charter activation. If this ADR is accepted, #2470 is superseded by #5193.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;resolved-questions&quot;&gt;Resolved questions&lt;/h2&gt;
&lt;p&gt;Resolved when the MVP landed (mission &lt;code dir=&quot;auto&quot;&gt;pack-skills-kind-01M43419&lt;/code&gt;):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;/name&lt;/code&gt; exposure.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/tool_surface/profiles/capability_matrix.py&lt;/code&gt; records only
native named-agent primitives (it does not say which tools surface a project skill as a
&lt;code dir=&quot;auto&quot;&gt;/name&lt;/code&gt; command), so it cannot answer this. The in-repo record is the command-surface table
in &lt;code dir=&quot;auto&quot;&gt;AGENTS.md&lt;/code&gt;: Codex invokes &lt;code dir=&quot;auto&quot;&gt;$&amp;#x3C;name&gt;&lt;/code&gt;, Pi &lt;code dir=&quot;auto&quot;&gt;/skill:&amp;#x3C;name&gt;&lt;/code&gt;, Vibe &lt;code dir=&quot;auto&quot;&gt;/&amp;#x3C;name&gt;&lt;/code&gt;, and Letta
routes Agent Skills through the model. Decision: a pack skill is an Agent Skill in the
project skill roots and promises no &lt;code dir=&quot;auto&quot;&gt;/name&lt;/code&gt; form; how each tool surfaces it is the tool’s
own rule. Per-tool exposure is not asserted by Spec Kitty.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project-tier namespace.&lt;/strong&gt; A required config key, &lt;code dir=&quot;auto&quot;&gt;charter_packs.project.skill_namespace&lt;/code&gt;;
it is never derived from the repository name. A project-tier skill without it is refused
with the remedy. The org-tier &lt;code dir=&quot;auto&quot;&gt;skill_namespace&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;org-charter.yaml&lt;/code&gt; is likewise required.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Run-time binding placeholders.&lt;/strong&gt; Deferred to slice 2 with the first migrated shorthand.
Slice 1 renders no binding placeholders, so no syntax can collide with &lt;code dir=&quot;auto&quot;&gt;$ARGUMENTS&lt;/code&gt; or
TOML &lt;code dir=&quot;auto&quot;&gt;{{args}}&lt;/code&gt; yet.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;#2470 supersession.&lt;/strong&gt; Remains the owner’s call; this ADR does not close or relabel it.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;related-drift-found-during-research&quot;&gt;Related drift found during research&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;CLAUDE.md names the org-pack key &lt;code dir=&quot;auto&quot;&gt;doctrine.org.packs&lt;/code&gt;; the code reads
&lt;code dir=&quot;auto&quot;&gt;charter_packs.org.packs&lt;/code&gt; and treats the old key as a legacy fallback
(&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/org_pack_config.py&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
