<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/04_implementation_mapping/">
  <id>https://docs.spec-kitty.ai/architecture/04_implementation_mapping/</id>
  <title>Implementation Mapping (living)</title>
  <updated>2026-10-12T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/04_implementation_mapping/"/>
  <summary>Living implementation mapping (C4 level 4): where each architecture concept lives in the source tree today. A derived view of the enforced module map.</summary>
  <content type="html">&lt;span id=&quot;implementation-mapping-living&quot;&gt;&lt;/span&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Field&lt;/th&gt;&lt;th&gt;Value&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Status&lt;/td&gt;&lt;td&gt;Living (derived view; the enforced pair wins on conflict)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Date&lt;/td&gt;&lt;td&gt;2026-03-04&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Last Updated&lt;/td&gt;&lt;td&gt;2026-09-30&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Scope&lt;/td&gt;&lt;td&gt;Maps C4 architecture views and charter offering stack to current codebase&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Parent&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/architecture/00_landscape/&quot;&gt;System Landscape&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Related ADRs&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;2026-03-25-1-glossary-type-ownership&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;purpose&quot;&gt;Purpose&lt;/h2&gt;
&lt;p&gt;Bridge the gap between the architecture documentation (C4 levels 0–3) and the
actual codebase. This document answers: “Where does each architectural concept
live in the source tree today?”&lt;/p&gt;
&lt;p&gt;This is &lt;strong&gt;not&lt;/strong&gt; a code inventory — it maps domain responsibilities to modules,
explains the charter offering stack layer model, and identifies where the current
implementation aligns with or diverges from the target architecture.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Current package boundaries&lt;/strong&gt; — Package inventory is defined by
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/pyproject.toml&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt;&lt;/a&gt; &lt;code dir=&quot;auto&quot;&gt;[tool.hatch.build.targets.wheel].packages&lt;/code&gt;,
enforced by &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/tests/architectural/test_pyproject_shape.py&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;test_pyproject_shape.py&lt;/code&gt;&lt;/a&gt;.
Import direction is defined and enforced by the &lt;code dir=&quot;auto&quot;&gt;landscape&lt;/code&gt; fixture in
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/tests/architectural/conftest.py&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;conftest.py&lt;/code&gt;&lt;/a&gt; and
&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/tests/architectural/test_layer_rules.py&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;test_layer_rules.py&lt;/code&gt;&lt;/a&gt;.
This implementation mapping is a derived view of those sources.
&lt;a href=&quot;/architecture/05_ownership_map/&quot;&gt;05_ownership_map.md&lt;/a&gt; is historical narrative only;
its former slice assignments and extraction roadmap are not authoritative for
current package ownership or boundaries.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2 id=&quot;level-0--system-landscape--codebase-modules&quot;&gt;Level 0 — System Landscape → Codebase Modules&lt;/h2&gt;
&lt;p&gt;The landscape’s domain containers all exist in the current codebase as Python
modules within a single-process CLI application. The main ones map as follows.&lt;/p&gt;

































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Landscape Container&lt;/th&gt;&lt;th&gt;Primary Codebase Location&lt;/th&gt;&lt;th&gt;Package&lt;/th&gt;&lt;th&gt;Notes&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Control Plane&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/cli/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Typer-based CLI. Single user entry point for all commands.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Kitty-core&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/core/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission_v1/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;missions/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;template/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;runtime/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Planning pipeline (specify→plan→tasks). The next-action loop itself lives at &lt;code dir=&quot;auto&quot;&gt;src/runtime/next/_internal_runtime/&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;specify_cli/next&lt;/code&gt; is gone).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Event Store&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/status/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;&lt;/td&gt;&lt;td&gt;JSONL event logs (&lt;code dir=&quot;auto&quot;&gt;store.py&lt;/code&gt;), reducer (&lt;code dir=&quot;auto&quot;&gt;reducer.py&lt;/code&gt;), WP frontmatter, &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;. Filesystem-only today.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Orchestration&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/orchestrator_api/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;consolidation/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;post_merge/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;lanes/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;workspace/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tracker/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Lifecycle engine, worktree management, lane consolidation, tracker projection. (The former local &lt;code dir=&quot;auto&quot;&gt;sync/&lt;/code&gt; transport was retired in the convergence; tracker projection now flows from &lt;code dir=&quot;auto&quot;&gt;status/emit.py&lt;/code&gt;.)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Dashboard&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;None in the CLI (the former &lt;code dir=&quot;auto&quot;&gt;specify_cli.dashboard&lt;/code&gt; package was removed, #5530)&lt;/td&gt;&lt;td&gt;external&lt;/td&gt;&lt;td&gt;The container now lives outside the CLI. Interim read path: &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;orchestrator-api mission-state&lt;/code&gt;. Replacement UIs, in their own repository, will consume the planned Mission Status Read API (#5528; &lt;a href=&quot;/adr/4.x/2026-10-01-2-mission-status-read-api-and-dashboard-extraction/&quot;&gt;ADR 2026-10-01-2&lt;/a&gt;, Accepted — open-core producer surface).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Agent Tool Connectors&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/mission-steps/*/*/prompt.md&lt;/code&gt; (source) → deployed as &lt;code dir=&quot;auto&quot;&gt;.claude/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.codex/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.amazonq/&lt;/code&gt;, etc.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; (offering source), &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; (deployment)&lt;/td&gt;&lt;td&gt;Current connector is a rendered markdown prompt template. One “adapter” per agent. Source templates live under &lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&lt;/code&gt;; charter offering code lives at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Skills Installer&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/skills/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Deployment bridge introduced in mission 055. &lt;code dir=&quot;auto&quot;&gt;SkillRegistry&lt;/code&gt; discovers canonical skills from &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;ManagedSkillManifest&lt;/code&gt; tracks installed files by hash for drift detection; &lt;code dir=&quot;auto&quot;&gt;installer.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;verifier.py&lt;/code&gt; deploy skills into agent directories alongside command templates during &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Charter Offering&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;offering code at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/&lt;/code&gt; (models/repository/validation per kind, &lt;code dir=&quot;auto&quot;&gt;drg/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;artifact_kinds.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;schemas/&lt;/code&gt;) + &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/&lt;/code&gt; (canonical skill packs); pack content at &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; (the former standalone &lt;code dir=&quot;auto&quot;&gt;doctrine&lt;/code&gt; package was absorbed here in the convergence)&lt;/td&gt;&lt;td&gt;JSON Schema validation, Pydantic models, repository pattern. Skill packs deployed from &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Charter&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; (standalone package)&lt;/td&gt;&lt;td&gt;Interview flow, compiler, action context resolver with depth semantics and action index intersection. Produces &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/&lt;/code&gt; bundles. Context bootstrap injects governance at every execution boundary.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;key-structural-observation&quot;&gt;Key structural observation&lt;/h3&gt;
&lt;p&gt;The governance layer lives in the &lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; package&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;src/charter/&lt;/code&gt;), which
absorbed the former standalone &lt;code dir=&quot;auto&quot;&gt;doctrine&lt;/code&gt; package at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/&lt;/code&gt; in
the convergence (the top-level &lt;code dir=&quot;auto&quot;&gt;doctrine&lt;/code&gt; deprecation shim module was removed, #805). The
documented layer chain is
&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;kernel &amp;#x3C;- charter &amp;#x3C;- {glossary, runtime, mission_runtime} &amp;#x3C;- specify_cli&lt;/code&gt;&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;kernel&lt;/code&gt; — zero-dependency shared primitives; the true root layer&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; — governance authority (&lt;code dir=&quot;auto&quot;&gt;charter.offering&lt;/code&gt; holds the
charter offering code); depends only on &lt;code dir=&quot;auto&quot;&gt;kernel&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;glossary&lt;/code&gt; — terminology / semantic-integrity pipeline + DRG glossary
bridge, in &lt;code dir=&quot;auto&quot;&gt;src/glossary/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;runtime&lt;/code&gt; — canonical mission control loop, in
&lt;code dir=&quot;auto&quot;&gt;src/runtime/next/_internal_runtime/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;mission_runtime&lt;/code&gt; — artifact-placement seam (&lt;code dir=&quot;auto&quot;&gt;PlacementSeam&lt;/code&gt;, resolver
port, identity, lifecycle_phase), in &lt;code dir=&quot;auto&quot;&gt;src/mission_runtime/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; — control plane, lifecycle, and orchestration; the top adapter
layer, depends downward on the rest&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;kernel&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;glossary&lt;/code&gt; are gate-enforced by &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_layer_rules.py&lt;/code&gt;
pytestarch &lt;code dir=&quot;auto&quot;&gt;LayerRule&lt;/code&gt;s. &lt;code dir=&quot;auto&quot;&gt;mission_runtime&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;runtime&lt;/code&gt; are gate-enforced by that same suite’s
shrink-only outbound-import ledgers (&lt;code dir=&quot;auto&quot;&gt;TestMissionRuntimeBoundary&lt;/code&gt; /
&lt;code dir=&quot;auto&quot;&gt;_MISSION_RUNTIME_ALLOWED_SPECIFY_CLI&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;TestRuntimeSpecifyCliLedger&lt;/code&gt; /
&lt;code dir=&quot;auto&quot;&gt;_RUNTIME_ALLOWED_SPECIFY_CLI&lt;/code&gt;) rather than a clean &lt;code dir=&quot;auto&quot;&gt;LayerRule&lt;/code&gt;, since a strict
“should not access specify_cli” rule would red on existing, working code — new
imports outside the named ledger still red the gate. Only the remaining container boundaries
are module-level conventions enforced by architectural gates and code review.&lt;/p&gt;
&lt;h3 id=&quot;retired-hosted-transports-and-clients&quot;&gt;Retired hosted transports and clients&lt;/h3&gt;
&lt;p&gt;The convergence retired the local &lt;code dir=&quot;auto&quot;&gt;sync/&lt;/code&gt; transport (daemon, offline queue,
body outbox, transport-attempts) and the &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/saas/&lt;/code&gt; package. The
hosted client packages that followed (&lt;code dir=&quot;auto&quot;&gt;zeitgeist_client/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;saas_client/&lt;/code&gt;), the
&lt;code dir=&quot;auto&quot;&gt;auth/&lt;/code&gt; package, &lt;code dir=&quot;auto&quot;&gt;core/hosted_posture.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;core/saas_sync_config.py&lt;/code&gt;, the
runtime-moment, live-work and decision-widen surfaces, &lt;code dir=&quot;auto&quot;&gt;status/zeitgeist_bridge.py&lt;/code&gt;
and the SaaS tracker providers were removed from open-core (#6164; the code is preserved in &lt;code dir=&quot;auto&quot;&gt;spec-kitty/event-router&lt;/code&gt;). Nothing in this map describes
them as live.&lt;/p&gt;
&lt;p&gt;These are guarded against silent reintroduction of the retired surfaces by
&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_no_retired_subsystems.py&lt;/code&gt; and the &lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt;
TID251 ban block; the surviving &lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_SYNC_*&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_*_SAAS_*&lt;/code&gt; env
vars are sanctioned by design.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;level-1--system-context--boundary-mapping&quot;&gt;Level 1 — System Context → Boundary Mapping&lt;/h2&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;External Actor&lt;/th&gt;&lt;th&gt;Current Boundary Surface&lt;/th&gt;&lt;th&gt;Implementation&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Human In Charge&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;CLI commands, interview prompts&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/cli/commands/&lt;/code&gt; (Typer command groups)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Human In Charge&lt;/strong&gt; (read)&lt;/td&gt;&lt;td&gt;Lane status board&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt; (bundled browser dashboard removed, #5530)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Agent Tools&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Command template prompts&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.claude/commands/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.codex/prompts/&lt;/code&gt;, etc. (12 agent directories)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;External Trackers&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Optional status projection&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/tracker/&lt;/code&gt; (feature-gated; the local &lt;code dir=&quot;auto&quot;&gt;sync/&lt;/code&gt; transport was retired in the convergence)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Project Repository&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Filesystem read/write&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt;, WP frontmatter&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;boundary-rule-compliance&quot;&gt;Boundary rule compliance&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Boundary Rule&lt;/th&gt;&lt;th&gt;Current State&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Host-owned authority is non-negotiable&lt;/td&gt;&lt;td&gt;✅ All state mutations go through &lt;code dir=&quot;auto&quot;&gt;status/emit.py&lt;/code&gt; — agents cannot bypass&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Agent Tools are external&lt;/td&gt;&lt;td&gt;✅ Agents receive rendered prompts; they do not call &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; directly&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Dashboard is read-only&lt;/td&gt;&lt;td&gt;✅ No dashboard ships in the CLI; the read surfaces (&lt;code dir=&quot;auto&quot;&gt;agent tasks status&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;orchestrator-api mission-state&lt;/code&gt;) have no write path&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Tracker integration is optional&lt;/td&gt;&lt;td&gt;✅ Tracker modules are feature-gated; system works without them&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Repository is canonical state&lt;/td&gt;&lt;td&gt;✅ All persistence is filesystem-based; no external state authority&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id=&quot;level-2--container-collaboration--code-paths&quot;&gt;Level 2 — Container Collaboration → Code Paths&lt;/h2&gt;
&lt;h3 id=&quot;loop-a-planning-user--kitty-core--event-store&quot;&gt;Loop A: Planning (User → Kitty-core → Event Store)&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;User runs: spec-kitty specify / plan / tasks&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;→ src/specify_cli/cli/commands/ (Control Plane)&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;→ src/specify_cli/core/ + mission.py (Kitty-core; the next-action loop is src/runtime/next/_internal_runtime/)&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;→ src/specify_cli/status/emit.py (Event Store write)&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;→ kitty-specs/&amp;#x3C;mission&gt;/ artifacts written to filesystem&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;loop-b-execution-coordination-orchestration--event-store--connectors&quot;&gt;Loop B: Execution Coordination (Orchestration ↔ Event Store → Connectors)&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;User runs: spec-kitty implement WP01&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;→ src/specify_cli/cli/commands/ (Control Plane)&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;→ src/specify_cli/lanes/ + workspace/ (Orchestration)&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;→ src/specify_cli/status/store.py (Event Store read — WP state)&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;→ packs/built-in/missions/mission-steps/software-dev/implement/prompt.md (Connector)&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;→ Agent executes work (external)&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;→ src/specify_cli/status/emit.py (Event Store write — lifecycle event)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;loop-c-governance-user--charter--charter-offering&quot;&gt;Loop C: Governance (User → Charter → Charter Offering)&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;User runs: spec-kitty charter interview / generate&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;→ src/specify_cli/cli/commands/ (Control Plane)&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;→ src/charter/activation/interview.py (Charter interview)&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;→ src/charter/activation/compiler.py (Charter compiler)&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;→ src/charter/activation/reference_resolver.py (transitive DFS: directive → tactic → styleguide/toolguide)&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;→ src/charter/offering/service.py → per-artifact repositories (charter offering read)&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/charter/ (compiled governance bundle)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;loop-c-action-context-bootstrap-agent--charter--charter-offering&quot;&gt;Loop C’: action context bootstrap (Agent → Charter → Charter Offering)&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;Agent calls: spec-kitty charter context --action implement&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;→ src/charter/activation/context.py (Action Context Resolver)&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;→ Load action index: packs/built-in/missions/software-dev/actions/implement/index.yaml&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;→ Two-stage intersection: action index ∩ project selections (references.yaml)&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;→ src/charter/offering/service.py (CharterOfferingService) → fetch directive/tactic content by depth&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;→ Load action guidelines: packs/built-in/missions/mission-steps/software-dev/implement/guidelines.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;→ Render CharterContextResult (governance text injected into agent prompt)&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;→ Persist context-state.json (first-load tracking for depth semantics)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;This sub-loop runs at every execution boundary (Principle 5). First invocation
returns depth-2 (full bootstrap); subsequent calls return depth-1 (compact).&lt;/p&gt;
&lt;h3 id=&quot;loop-d-visibility-status-read--event-store&quot;&gt;Loop D: Visibility (Status read ← Event Store)&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;User runs: spec-kitty agent tasks status [--json]&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;→ reduces status.events.jsonl for the Mission&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;→ prints the lane board (read-only)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The bundled browser dashboard was removed (#5530). A replacement UI will
read through the planned Mission Status Read API (#5528) from its own repository.&lt;/p&gt;
&lt;h3 id=&quot;loop-e-external-projection-orchestration--tracker&quot;&gt;Loop E: External Projection (Orchestration → Tracker)&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;Orchestration lifecycle event triggers:&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;→ src/specify_cli/status/emit.py (status projection seam)&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;→ src/specify_cli/tracker/ (tracker connector gateway)&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;→ External tracker API (optional, feature-gated)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;The local &lt;code dir=&quot;auto&quot;&gt;sync/&lt;/code&gt; transport that formerly coordinated this projection was
retired in the convergence; projection now flows directly from the status
emit seam to the tracker gateway.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2 id=&quot;level-3--components--modules&quot;&gt;Level 3 — Components → Modules&lt;/h2&gt;












































































































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Component (from C4 Level 3)&lt;/th&gt;&lt;th&gt;Module(s)&lt;/th&gt;&lt;th&gt;Key Files&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Command Router&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;cli/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;cli/__init__.py&lt;/code&gt;, command group registration&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Workflow Command Set&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;cli/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;specify.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;plan.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tasks.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;implement.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;review.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;merge.py&lt;/code&gt;. &lt;code dir=&quot;auto&quot;&gt;implement.py&lt;/code&gt; is a thin Typer shell over the ordered phases in &lt;code dir=&quot;auto&quot;&gt;implement_phases.py&lt;/code&gt;; the claim recording lives in &lt;code dir=&quot;auto&quot;&gt;implement_claim.py&lt;/code&gt;, the planning-artifact commit in &lt;code dir=&quot;auto&quot;&gt;implement_planning_commit.py&lt;/code&gt; (pure cores in &lt;code dir=&quot;auto&quot;&gt;implement_cores.py&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;--recover&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;implement_recover.py&lt;/code&gt;, and the CLI-free decisions (they return typed results or raise typed errors, and the command turns those into output and exit codes) behind seams in &lt;code dir=&quot;auto&quot;&gt;lanes/implement_support.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;coordination/planning_commit.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;workspace/context.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;core/dependency_graph.py&lt;/code&gt; (#5635). Canon terminology: &lt;code dir=&quot;auto&quot;&gt;--mission-type&lt;/code&gt; is the flag for mission-type selection (renamed from &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; in 5 type-selection commands, 2026-03-25; old &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; alias raises hard error). &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; remains the slug selector on all other commands. &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; is a hidden deprecated alias everywhere.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status Mutation Command Set&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;cli/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;status.py&lt;/code&gt;, lane transition commands&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Governance Command Set&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;cli/commands/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Next Loop Coordinator&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/runtime/next/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;_internal_runtime/engine.py&lt;/code&gt; + &lt;code dir=&quot;auto&quot;&gt;planner.py&lt;/code&gt; — per-agent action sequencing (the &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/next/&lt;/code&gt; shim was deleted in &lt;code dir=&quot;auto&quot;&gt;93dcbd7548&lt;/code&gt;, 2026-07-03)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Mission Discovery and Resolution&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;core/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission_v1/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Mission context detection, asset loading&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Runtime Asset Lifecycle Coordinator&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;runtime/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Bootstrap, tier selection, compatibility&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Tiered Template Resolution Pipeline&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;template/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Prompt/template resolution by configured precedence&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Mission Context Detection&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;core/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Active mission detection&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Event Semantics Reducer&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;status/reducer.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Deterministic event→snapshot materialization&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Persistence Layer&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;status/store.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;JSONL append/read, corruption detection&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Lifecycle Command Gateway&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;status/emit.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;emit_status_transition()&lt;/code&gt; — single entry point for state changes&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;WP Lifecycle Engine&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;status/transitions.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;16-pair transition matrix, guard conditions&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Target-Line Router&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;mission_runtime/lifecycle_phase.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;core/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Phase resolution, target branch routing&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Tracker Connector Gateway&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tracker/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;External tracker API adapters (the former &lt;code dir=&quot;auto&quot;&gt;sync/&lt;/code&gt; runtime coordinator was retired in the convergence)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Charter Offering Loader&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/service.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CharterOfferingService&lt;/code&gt; — lazy aggregation facade&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Schema Validation Gate&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/*/validation.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/schemas/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;JSON Schema + Pydantic validation&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Glossary Hook Coordinator&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/missions/glossary_hook.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;src/glossary/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Glossary checks during mission execution&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Charter Interview Flow&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter/activation/interview.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Guided Q&amp;#x26;A for governance capture&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Charter Compiler&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter/activation/compiler.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Charter offering→charter bundle compilation&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;Action Context Resolver&lt;/code&gt;&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter/activation/context.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter/activation/resolver.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter/activation/reference_resolver.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Action-scoped governance context with depth semantics (1=compact, 2=bootstrap, 3=extended) and two-stage intersection (action index ∩ project selections)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Action Index&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/*/actions/*/index.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Per-action directive/tactic/styleguide/toolguide selection — loaded by &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/missions/action_index.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Execution Dispatch&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/mission-steps/&amp;#x3C;mission_type&gt;/&amp;#x3C;step_id&gt;/prompt.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Prompt rendering for agent dispatch (source relocated from &lt;code dir=&quot;auto&quot;&gt;specify_cli/missions/&lt;/code&gt; in mission 054; content now ships from &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt;, not &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Agent Adapters&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.claude/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.codex/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.amazonq/&lt;/code&gt;, etc.&lt;/td&gt;&lt;td&gt;Per-agent command templates (12 agents)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Path Resolver&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/kernel/paths.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;get_kittify_home()&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;get_package_asset_root()&lt;/code&gt; — zero-dependency path resolution shared across all packages (moved from &lt;code dir=&quot;auto&quot;&gt;specify_cli.runtime.home&lt;/code&gt; in WP09, 2026-03-25; re-export shim at &lt;code dir=&quot;auto&quot;&gt;specify_cli/runtime/home.py&lt;/code&gt; preserves backward compatibility). &lt;strong&gt;Dependency note (Windows):&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;kernel&lt;/code&gt; is stdlib-only on Linux/macOS. On Windows, &lt;code dir=&quot;auto&quot;&gt;platformdirs&lt;/code&gt; is imported lazily in &lt;code dir=&quot;auto&quot;&gt;kernel/paths.py&lt;/code&gt; for platform-appropriate home directory resolution. This is the only sanctioned third-party import in &lt;code dir=&quot;auto&quot;&gt;kernel/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Glossary Runner Registry&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/kernel/glossary_runner.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;GlossaryRunnerProtocol&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;register()&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;get_runner()&lt;/code&gt; — plugin registry allowing &lt;code dir=&quot;auto&quot;&gt;charter.offering&lt;/code&gt; to register its runner without creating a &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; import dependency. Resolves DIV-5 (docs/adr/2.x/2026-03-25-1-glossary-type-ownership.md).&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;tiered-template-resolution-pipeline&quot;&gt;Tiered Template Resolution Pipeline&lt;/h3&gt;
&lt;p&gt;Template resolution uses a 6-tier precedence chain implemented in
&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/runtime/resolver.py&lt;/code&gt;. The resolver checks each tier in order
and returns the first file that exists:&lt;/p&gt;















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Tier&lt;/th&gt;&lt;th&gt;Label&lt;/th&gt;&lt;th&gt;Path Pattern&lt;/th&gt;&lt;th&gt;Semantics&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;1&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Project Override&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/overrides/{templates,command-templates}/{name}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Highest precedence. User’s explicit project-level override.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;2&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Legacy&lt;/strong&gt; (deprecated)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/{templates,command-templates}/{name}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Pre-migration project files. Emits deprecation warning or one-time “run &lt;code dir=&quot;auto&quot;&gt;spec-kitty migrate&lt;/code&gt;” nudge. Will be removed in next major version.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;3&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Org&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;org_root&gt;/missions/{mission}/{templates,command-templates}/{name}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Org Charter Pack roots, checked in declaration order. No-op when no org packs are configured.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;4&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Global Mission-Specific&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;~/.kittify/missions/{mission}/{templates,command-templates}/{name}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;User-global, scoped to a specific mission type. Populated by &lt;code dir=&quot;auto&quot;&gt;spec-kitty migrate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;ensure_runtime&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;5&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Global Non-Mission&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;~/.kittify/{templates,command-templates}/{name}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;User-global, cross-mission.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;6&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Package Default&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/{mission}/{templates,command-templates}/{name}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Lowest precedence. Bundled pack content (resolved through the &lt;code dir=&quot;auto&quot;&gt;charter.offering&lt;/code&gt; chain). Resolved via &lt;code dir=&quot;auto&quot;&gt;kernel.paths.get_package_asset_root()&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Special cases:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;resolve_mission()&lt;/code&gt; uses a 5-tier variant — it skips tier 5 (Global Non-Mission) because missions are inherently mission-scoped.&lt;/li&gt;
&lt;li&gt;Tier 2 (Legacy) shows a one-time stderr nudge when the global runtime is already configured.&lt;/li&gt;
&lt;li&gt;If no tier provides the asset, &lt;code dir=&quot;auto&quot;&gt;FileNotFoundError&lt;/code&gt; is raised.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;charter-offering-stack-layer-model&quot;&gt;Charter Offering Stack: Layer Model&lt;/h2&gt;
&lt;p&gt;The Charter Offering container is organized as a layered knowledge stack. Each layer
serves a distinct governance purpose, and the reference directions between
layers are strictly defined.&lt;/p&gt;
&lt;h3 id=&quot;artifact-type-layers&quot;&gt;Artifact Type Layers&lt;/h3&gt;











































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Layer&lt;/th&gt;&lt;th&gt;Artifact Type&lt;/th&gt;&lt;th&gt;Location&lt;/th&gt;&lt;th&gt;Count (shipped)&lt;/th&gt;&lt;th&gt;Purpose&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Mental Models&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Paradigm&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/paradigms/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/paradigms/&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;13&lt;/td&gt;&lt;td&gt;High-level approaches that frame &lt;em&gt;how you think about a problem&lt;/em&gt;. Not executable.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Rules&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Directive&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/directives/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/directives/&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;34&lt;/td&gt;&lt;td&gt;Enforceable governance rules. &lt;code dir=&quot;auto&quot;&gt;enforcement: required|advisory&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Procedures&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Tactic&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/tactics/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/tactics/&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;124&lt;/td&gt;&lt;td&gt;Step-by-step execution procedures. Agent-consumable.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Output Shapes&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Styleguide&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/styleguides/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/styleguides/&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;23&lt;/td&gt;&lt;td&gt;Define &lt;em&gt;what output looks like&lt;/em&gt; — formatting, naming, structure.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Tool Contracts&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Toolguide&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/toolguides/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/toolguides/&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;15&lt;/td&gt;&lt;td&gt;Define &lt;em&gt;how tools are used&lt;/em&gt; — config, invocation, constraints.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Execution Identity&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Agent Profile&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/agent_profiles/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/agent_profiles/&lt;/code&gt;; no &lt;code dir=&quot;auto&quot;&gt;shipped/&lt;/code&gt; subdirectory)&lt;/td&gt;&lt;td&gt;25&lt;/td&gt;&lt;td&gt;Agent capabilities, constraints, collaboration contracts. Injected by &lt;code dir=&quot;auto&quot;&gt;SkillRegistry&lt;/code&gt; at &lt;code dir=&quot;auto&quot;&gt;init&lt;/code&gt; time.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Deployable Governance Packs&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Skill&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;55&lt;/td&gt;&lt;td&gt;Self-contained governance bundles (SKILL.md + optional references/scripts/assets) deployed to agent directories during &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; by &lt;code dir=&quot;auto&quot;&gt;specify_cli/skills/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Process Templates&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Mission Template&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&lt;/code&gt; (Python at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/missions/&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;4 types (software-dev, documentation, research, plan)&lt;/td&gt;&lt;td&gt;Define the SDD process stages for different mission types. Also carries per-action governance indexes.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Process Templates&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Expected Artifacts Manifest&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/*/expected-artifacts.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;4 (software-dev, documentation, research, plan)&lt;/td&gt;&lt;td&gt;Per-step, class-tagged (&lt;code dir=&quot;auto&quot;&gt;input&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;output&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;workflow&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;evidence&lt;/code&gt;), blocking-semantics artifact requirements consumed by dossier &lt;code dir=&quot;auto&quot;&gt;ManifestRegistry&lt;/code&gt; via &lt;code dir=&quot;auto&quot;&gt;MissionRepository.get_expected_artifacts()&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;reference-direction-rules&quot;&gt;Reference Direction Rules&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;Paradigm ──tactic_refs──→ Tactic       (approach justifies tactics)&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;Directive ──tactic_refs──→ Tactic      (rule selects procedures)&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;Tactic ──references──→ Tactic          (step consults related procedure)&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;Tactic ──references──→ Styleguide      (step consults output shape)&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;Tactic ──references──→ Toolguide       (step consults tool contract)&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;Tactic ──references──→ Directive       (step references governing rule)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Cross-artifact tension/rejection is expressed as first-class DRG edges
(&lt;code dir=&quot;auto&quot;&gt;packs/built-in/*.graph.yaml&lt;/code&gt;), not an inline artifact field — see below.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Leaf nodes:&lt;/strong&gt; Styleguides and Toolguides are terminal — they are referenced
&lt;em&gt;by&lt;/em&gt; tactics but carry no outward references.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;DAG constraint:&lt;/strong&gt; Tactic-to-tactic references must form a directed acyclic
graph. Cycles are detected by &lt;code dir=&quot;auto&quot;&gt;test_tactic_reference_graph_has_no_cycles&lt;/code&gt; in
&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_directive_consistency.py&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Tension/rejection semantics:&lt;/strong&gt; the DRG relations &lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt; (symmetric,
non-transitive — e.g. Directive 024 Locality of Change vs. Directive 025 Boy
Scout Rule), &lt;code dir=&quot;auto&quot;&gt;reconciles_tension&lt;/code&gt; (an active reconciliation artifact bridging
both sides of a tension), and &lt;code dir=&quot;auto&quot;&gt;rejects&lt;/code&gt; (directional, target a marked
&lt;code dir=&quot;auto&quot;&gt;anti_pattern&lt;/code&gt; node) do &lt;strong&gt;not&lt;/strong&gt; mean “superseded”. All artifacts on either side
of a tension or rejection remain independently valid; the edges document known
tension/rejection so agents and &lt;code dir=&quot;auto&quot;&gt;charter consistency-check&lt;/code&gt; can surface it when
co-activated. These replaced the retired inline contradiction-declaration
field + its shared model (mission doctrine-tension-edges-01KY1WPC).&lt;/p&gt;
&lt;h3 id=&quot;repository-implementation-pattern&quot;&gt;Repository Implementation Pattern&lt;/h3&gt;
&lt;p&gt;Every artifact type follows an identical internal structure, split across a
Python package and a shipped-content directory — the two no longer live
under the same tree:&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;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;src/charter/offering/&amp;#x3C;artifact_type&gt;/    # Python package — code only&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;├── __init__.py          # Exports&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;├── models.py            # Pydantic model (e.g., Directive, Tactic, Paradigm)&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;├── repository.py        # Two-source YAML loader (shipped + project)&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;└── validation.py        # Schema validation — delegates to SchemaUtilities&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;/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;packs/built-in/&amp;#x3C;artifact_type&gt;/          # Shipped content (YAML files)&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;├── 001-xxx.&amp;#x3C;type&gt;.yaml&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;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;shared-utilities-srccharterofferingshared&quot;&gt;Shared Utilities (&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/shared/&lt;/code&gt;)&lt;/h3&gt;
&lt;p&gt;Cross-cutting infrastructure used by all artifact subpackages:&lt;/p&gt;

















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Module&lt;/th&gt;&lt;th&gt;Purpose&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;schema_utils.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;SchemaUtilities.load_schema(name)&lt;/code&gt; — single cached schema loader replacing six near-identical per-type functions&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;exceptions.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ArtifactLoadError&lt;/code&gt; — fail-open signal for corrupt/unreadable artifact files; &lt;code dir=&quot;auto&quot;&gt;ArtifactResolutionCycleError&lt;/code&gt; — raised when a cycle is detected in the reference graph&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Why shared utilities matter:&lt;/strong&gt; Before &lt;code dir=&quot;auto&quot;&gt;shared/&lt;/code&gt;, each &lt;code dir=&quot;auto&quot;&gt;validation.py&lt;/code&gt; duplicated identical schema-loading logic (importlib.resources lookup + filesystem fallback + LRU cache). The &lt;code dir=&quot;auto&quot;&gt;shared/&lt;/code&gt; module eliminates that duplication and provides a single place to evolve the loading strategy.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Two-source loading&lt;/strong&gt; is the key design pattern:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Shipped artifacts&lt;/strong&gt; are bundled as pack content under &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt;
(resolved through the &lt;code dir=&quot;auto&quot;&gt;charter.offering&lt;/code&gt; chain). These are the defaults that
come with Spec Kitty.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project artifacts&lt;/strong&gt; live in the user’s project under the canonical
&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt; tree (e.g., &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/directives/&lt;/code&gt;),
resolved through &lt;code dir=&quot;auto&quot;&gt;src/kernel/charter_pack_paths.py&lt;/code&gt;; there is no legacy read
fallback (&lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; moves a retired tree). Project artifacts can override
shipped artifacts via field-level merge or add entirely new ones. (&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/&lt;/code&gt;
is a distinct tree — the compiled Charter Bundle output, not the
project-layer artifact source.)&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;CharterOfferingService&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/service.py&lt;/code&gt;) is the aggregation facade —
it lazily instantiates all per-type repositories and is the single entry point
for all consumers (Charter compiler, Connectors, Kitty-core).&lt;/p&gt;
&lt;h3 id=&quot;schema-validation&quot;&gt;Schema Validation&lt;/h3&gt;
&lt;p&gt;Each artifact type has a corresponding JSON Schema file in
&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/schemas/&lt;/code&gt;:&lt;/p&gt;





































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Schema File&lt;/th&gt;&lt;th&gt;Validates&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;paradigm.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Paradigm artifacts (includes &lt;code dir=&quot;auto&quot;&gt;tactic_refs&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;directive.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Directive artifacts (includes &lt;code dir=&quot;auto&quot;&gt;tactic_refs&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tactic.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Tactic artifacts (includes &lt;code dir=&quot;auto&quot;&gt;steps&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;references&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;styleguide.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Styleguide artifacts&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;toolguide.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Toolguide artifacts&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;agent-profile.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Agent Profile artifacts (capabilities, constraints)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;mission.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Mission template definition&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Validation is enforced in tests (&lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/&lt;/code&gt;) and through the
Schema Validation Gate component. Schemas use &lt;code dir=&quot;auto&quot;&gt;additionalProperties: false&lt;/code&gt;
on paradigm and tactic types, meaning any new field requires both a schema
update and a valid fixture update.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;charter-offering-stack-as-is-vs-vision&quot;&gt;Charter Offering Stack: As-Is vs. Vision&lt;/h2&gt;
&lt;h3 id=&quot;what-exists-and-works-today&quot;&gt;What exists and works today&lt;/h3&gt;



















































































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Capability&lt;/th&gt;&lt;th&gt;Status&lt;/th&gt;&lt;th&gt;Evidence&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;All 7 artifact types with Pydantic models, repositories, validation&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/*/models.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;repository.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;validation.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;JSON Schema validation for all types&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/schemas/*.schema.yaml&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Two-source loading (shipped + project override)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;repository.py&lt;/code&gt; field-level merge on each type&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Cross-artifact references (&lt;code dir=&quot;auto&quot;&gt;tactic_refs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;references[]&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;Wired with test coverage across &lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/&lt;/code&gt; (185 test files, 3,017 collected tests as of 2026-09-07 — this figure grows over time, not a ceiling)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Tension/rejection modeling (&lt;code dir=&quot;auto&quot;&gt;in_tension_with&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;reconciles_tension&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;rejects&lt;/code&gt; DRG edges)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;Hand-authored edges in &lt;code dir=&quot;auto&quot;&gt;packs/built-in/*.graph.yaml&lt;/code&gt;; validated via &lt;code dir=&quot;auto&quot;&gt;assert_valid&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;DAG cycle detection — shipped artifacts&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;test_tactic_reference_graph_has_no_cycles&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/test_directive_consistency.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Cycle detection at resolution boundary&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;Moved into the DRG validator: &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/drg/validator.py&lt;/code&gt; rejects &lt;code dir=&quot;auto&quot;&gt;requires&lt;/code&gt; cycles (&lt;code dir=&quot;auto&quot;&gt;_validate_requires_cycles&lt;/code&gt;) and &lt;code dir=&quot;auto&quot;&gt;specializes_from&lt;/code&gt; lineage cycles at load time. The former &lt;code dir=&quot;auto&quot;&gt;reference_resolver._Walker&lt;/code&gt; boundary check is gone, and &lt;code dir=&quot;auto&quot;&gt;ArtifactResolutionCycleError&lt;/code&gt; is defined (&lt;code dir=&quot;auto&quot;&gt;offering/shared/exceptions.py&lt;/code&gt;, covered by &lt;code dir=&quot;auto&quot;&gt;tests/charter_offering/shared/test_exceptions.py&lt;/code&gt;) but no longer raised anywhere in &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Shared schema loading (&lt;code dir=&quot;auto&quot;&gt;SchemaUtilities&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/shared/schema_utils.py&lt;/code&gt;; replaces 6 duplicated per-type loaders&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Domain exceptions (&lt;code dir=&quot;auto&quot;&gt;ArtifactLoadError&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ArtifactResolutionCycleError&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/shared/exceptions.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CharterOfferingService&lt;/code&gt; aggregation facade&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/service.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Charter compiler consumes the charter offering&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/activation/compiler.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Command templates as connector implementation&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;12-agent template system via migrations&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Transitive reference resolution (directive → tactic → styleguide/toolguide)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/activation/reference_resolver.py&lt;/code&gt; (mission 054)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Action-scoped governance injection with depth semantics&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/activation/context.py&lt;/code&gt; + &lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/*/actions/*/index.yaml&lt;/code&gt; (mission 054)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Per-action guidelines extraction from templates&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/mission-steps/*/*/guidelines.md&lt;/code&gt; (mission 054; single owner since #5202)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;ArtifactKind canonical enum&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/charter/offering/artifact_kinds.py&lt;/code&gt; (mission 054, WP09-WP10)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;MissionRepository package relocation&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&lt;/code&gt; is the authoritative source for all shipped mission assets (YAML, mission-step prompt templates, content templates, expected-artifacts); &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/missions/&lt;/code&gt; holds only the Python repository/loader code that reads them. &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/missions/&lt;/code&gt; survives only as a stale legacy asset tree the resolver deliberately no longer falls back to (&lt;code dir=&quot;auto&quot;&gt;src/kernel/paths.py&lt;/code&gt;, DR-2); its Python mission code moved to &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/missions/&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;primitives.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary_hook.py&lt;/code&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Skills Pack canonical distribution&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/skills/&lt;/code&gt; — &lt;code dir=&quot;auto&quot;&gt;SkillRegistry&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;ManagedSkillManifest&lt;/code&gt;, installer, verifier. 55 canonical skill packs in &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/skills/&lt;/code&gt;. Deployed to agent directories during &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; (mission 055).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Agent Profile shaping connector behavior&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;Models, repository, schema, profile-aware resolution wired in &lt;code dir=&quot;auto&quot;&gt;resolver.py&lt;/code&gt;; workflow profile injection at execution boundary enabled (mission 055).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;kernel&lt;/code&gt; zero-dependency floor (&lt;code dir=&quot;auto&quot;&gt;paths&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary_runner&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary_types&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/kernel/&lt;/code&gt; — &lt;code dir=&quot;auto&quot;&gt;paths.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary_runner.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary_types.py&lt;/code&gt;. Backward-compat re-export shim at &lt;code dir=&quot;auto&quot;&gt;specify_cli/runtime/home.py&lt;/code&gt;. DIV-5 (glossary runner boundary) resolved. ADR: &lt;code dir=&quot;auto&quot;&gt;2026-03-25-1-glossary-type-ownership&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--mission-type&lt;/code&gt; flag on type-selection commands&lt;/td&gt;&lt;td&gt;✅ Complete&lt;/td&gt;&lt;td&gt;5 commands renamed from &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;--mission-type&lt;/code&gt; (2026-03-25). Old &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; alias on those commands raises &lt;code dir=&quot;auto&quot;&gt;typer.Exit(1)&lt;/code&gt;. &lt;code dir=&quot;auto&quot;&gt;--mission&lt;/code&gt; (slug selector) and &lt;code dir=&quot;auto&quot;&gt;--feature&lt;/code&gt; (hidden deprecated alias) unchanged on all other commands.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;what-is-emerging-or-aspirational&quot;&gt;What is emerging or aspirational&lt;/h3&gt;


















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Capability&lt;/th&gt;&lt;th&gt;Status&lt;/th&gt;&lt;th&gt;Gap Description&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Glossary integration at execution boundary&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;glossary_hook.py&lt;/code&gt; exists; full Glossary Hook Coordinator loop is early-stage&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Slimmed agent templates (governance-free)&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;Bootstrap section added to templates. Residual inline governance prose not yet stripped. Migration &lt;code dir=&quot;auto&quot;&gt;m_2_0_2&lt;/code&gt; pending.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Mission templates as first-class doctrine artifacts&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;Templates relocated to &lt;code dir=&quot;auto&quot;&gt;packs/built-in/missions/&lt;/code&gt; (mission 054; loader code at &lt;code dir=&quot;auto&quot;&gt;src/charter/offering/missions/&lt;/code&gt;). Action indexes operational. Formal &lt;code dir=&quot;auto&quot;&gt;MissionTemplateRepository&lt;/code&gt; deferred.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Explicit per-agent connector adapters&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;12-agent command template system is the seed. Architecture envisions SDK/shell/remote adapters (Phase 2).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Non-software-dev mission parity&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;documentation&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;plan&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;research&lt;/code&gt; missions have action directories but thinner indexes than &lt;code dir=&quot;auto&quot;&gt;software-dev&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Event Store behind interface contract&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;store.py&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;reducer.py&lt;/code&gt; provide the interface pattern. Not yet formally abstracted for alternative backends (Phase 3).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Control Plane as swappable surface&lt;/td&gt;&lt;td&gt;🔴 Conceptual&lt;/td&gt;&lt;td&gt;CLI is tightly coupled. No interface abstraction exists yet for TUI/web alternatives&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Dashboard as independent read surface&lt;/td&gt;&lt;td&gt;🟡 Partial&lt;/td&gt;&lt;td&gt;The bundled dashboard was removed (#5530); no UI ships in the CLI. Target: a Mission Status Read API in the &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; layer (overview and detail granularities); replacement UIs live outside the CLI (&lt;a href=&quot;/adr/4.x/2026-10-01-2-mission-status-read-api-and-dashboard-extraction/&quot;&gt;ADR 2026-10-01-2&lt;/a&gt;, Accepted — open-core producer surface)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id=&quot;divergence-notes&quot;&gt;Divergence Notes&lt;/h2&gt;
&lt;p&gt;Areas where the current implementation does not yet match the target
architecture:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;CLI mixes Control Plane and Orchestration:&lt;/strong&gt; Some CLI commands directly
invoke lifecycle mutations rather than routing through a clean Control Plane →
Orchestration interface. The boundary is module-level convention, not enforced
by an interface contract.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Kitty-core and Orchestration share filesystem paths:&lt;/strong&gt; Both can write
to &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&lt;/code&gt; directly. The landscape says they should both go through
the Event Store interface contract.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Connector concept is implicit:&lt;/strong&gt; The current “adapter” is a rendered
markdown template. There is no formal &lt;code dir=&quot;auto&quot;&gt;Connector&lt;/code&gt; interface that alternative
dispatch mechanisms (SDK, shell, remote API) could implement.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;No single status read contract yet:&lt;/strong&gt; The former bundled dashboard’s
&lt;code dir=&quot;auto&quot;&gt;dashboard/scanner.py&lt;/code&gt; read WP frontmatter files directly, bypassing the
Event Store abstraction; it was removed (#5530). The
orchestrator-api reads (&lt;code dir=&quot;auto&quot;&gt;mission-state&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;list-ready&lt;/code&gt;) and &lt;code dir=&quot;auto&quot;&gt;agent tasks status&lt;/code&gt;
each reduce the event log again, and do not all use the same reducer. The fix is
one Mission Status Read API that every display and external consumer reads
through (&lt;a href=&quot;/adr/4.x/2026-10-01-2-mission-status-read-api-and-dashboard-extraction/&quot;&gt;ADR 2026-10-01-2&lt;/a&gt;, Accepted — open-core producer surface).&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;These are not bugs — they reflect the natural state of a system evolving toward
its target architecture. The landscape document establishes where the boundaries
&lt;em&gt;should&lt;/em&gt; be, and the gap between as-is and target architecture guides future
refactoring priorities.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;core-code-patterns&quot;&gt;Core Code Patterns&lt;/h2&gt;
&lt;p&gt;The companion document &lt;a href=&quot;/architecture/04_implementation_mapping/code-patterns/&quot;&gt;code-patterns.md&lt;/a&gt; catalogs the
recurring code patterns applied across the codebase: rule-based pipelines
(chain-of-responsibility), append-only event log + reducer, two-source
doctrine repository, preflight validation with structured results, and the
pure-function finding shape. Each entry links to its doctrine tactic and
points at canonical implementations in the tree. Reach for it when picking
up an unfamiliar module — the patterns it documents are the codebase’s
expected shapes.&lt;/p&gt;
&lt;h2 id=&quot;traceability&quot;&gt;Traceability&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;System Landscape: &lt;code dir=&quot;auto&quot;&gt;../00_landscape/README.md&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Architectural Principles: &lt;code dir=&quot;auto&quot;&gt;../00_landscape/README.md#architectural-principles&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;System Context (living): &lt;a href=&quot;/architecture/diagrams/01_context/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;../diagrams/01_context/README.md&lt;/code&gt;&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Container View (living): &lt;a href=&quot;/architecture/diagrams/02_containers/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;../diagrams/02_containers/README.md&lt;/code&gt;&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Component View (living): &lt;a href=&quot;/architecture/diagrams/03_components/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;../diagrams/03_components/README.md&lt;/code&gt;&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Frozen 2.x C4 snapshot: &lt;code dir=&quot;auto&quot;&gt;../01_context/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;../02_containers/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;../03_components/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Code Patterns Catalog: &lt;a href=&quot;/architecture/04_implementation_mapping/code-patterns/&quot;&gt;code-patterns.md&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Doctrine governance ADR: &lt;a href=&quot;/adr/2.x/2026-02-23-1-doctrine-artifact-governance-model/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;docs/adr/2.x/2026-02-23-1-doctrine-artifact-governance-model.md&lt;/code&gt;&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
