<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/governance-files/">
  <id>https://docs.spec-kitty.ai/context/governance-files/</id>
  <title>Governance Files Reference</title>
  <updated>2026-11-13T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/context/governance-files/"/>
  <summary>Authoritative reference for every file under .kittify/charter/ — who writes it, what it contains, and whether you can edit it.</summary>
  <content type="html">&lt;span id=&quot;governance-files-reference&quot;&gt;&lt;/span&gt;
&lt;p&gt;The Charter governance layer lives primarily in &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/&lt;/code&gt;, with the promoted project layer
under &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt;. Most files are runtime-managed or agent-generated inputs and
must not be hand-edited. This page describes the common Charter-era files and the commands that
own them.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Key rule&lt;/strong&gt;: edit &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt; for Spec Kitty runtime policy changes —
specifically its &lt;code dir=&quot;auto&quot;&gt;governance:&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;directives:&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;overrides:&lt;/code&gt; sections. What the project has
activated lives in the activation ledger &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/activation.yaml&lt;/code&gt;; change it with
&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;deactivate&lt;/code&gt;.
&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt; is a curated narrative companion; the runtime never reads it for
policy. External governance docs such as &lt;code dir=&quot;auto&quot;&gt;spec/constitution.md&lt;/code&gt; are supporting context
referenced from &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;, not alternate authoritative charter paths. Re-run
&lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; to refresh &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt; sections, and
&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; to promote doctrine artifacts — do not patch those sections, runtime state,
or synthesis outputs by hand.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2 id=&quot;file-table&quot;&gt;File Table&lt;/h2&gt;



















































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;File path&lt;/th&gt;&lt;th&gt;Who writes it&lt;/th&gt;&lt;th&gt;Contains&lt;/th&gt;&lt;th&gt;Edit directly?&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;.kittify/charter/charter.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Human&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt;); &lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt; sections only)&lt;/td&gt;&lt;td&gt;The single structured charter: hand-authored policy plus a generator-refreshed offering catalog&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt;: yes. &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt;: no&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Human&lt;/strong&gt;, or an agent during &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.charter&lt;/code&gt;’s chat flow — never &lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Narrative summary of policy; may reference or summarize an external constitution&lt;/td&gt;&lt;td&gt;Yes — but edits have no runtime effect&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;charter:&lt;/code&gt; key)&lt;/td&gt;&lt;td&gt;Minted once by &lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; on first bootstrap; human-editable afterward&lt;/td&gt;&lt;td&gt;The single pointer resolving to the active &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Yes, to redirect to a different charter file&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/activation.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter activate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;deactivate&lt;/code&gt; (presets included), upgrade migration &lt;code dir=&quot;auto&quot;&gt;4.0.0rc8_activation_ledger&lt;/code&gt;&lt;/td&gt;&lt;td&gt;The activation ledger: &lt;code dir=&quot;auto&quot;&gt;activated_kinds&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission_type_activations&lt;/code&gt;, the &lt;code dir=&quot;auto&quot;&gt;activated_&amp;#x3C;kind&gt;&lt;/code&gt; allow state and the &lt;code dir=&quot;auto&quot;&gt;deactivated_&amp;#x3C;kind&gt;&lt;/code&gt; exclusions&lt;/td&gt;&lt;td&gt;No: use &lt;code dir=&quot;auto&quot;&gt;charter activate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;deactivate&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/interview/answers.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter interview&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Captured answers used by &lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Prefer re-running &lt;code dir=&quot;auto&quot;&gt;charter interview&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/context-state.json&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Runtime context loader&lt;/td&gt;&lt;td&gt;Per-action first-load state for compact/bootstrap context&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/generated/{directives,tactics,styleguides}/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Agent harness&lt;/td&gt;&lt;td&gt;Candidate YAML artifacts consumed by &lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;No routine hand edits&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/synthesis-manifest.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;charter resynthesize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Manifest of promoted synthesized artifacts and content hashes&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/provenance/*.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;charter resynthesize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Provenance sidecars for project-local doctrine artifacts&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/.staging/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Synthesizer&lt;/td&gt;&lt;td&gt;Temporary validation/promote workspace; the newest 3 &lt;code dir=&quot;auto&quot;&gt;.failed&lt;/code&gt; dirs remain for diagnosis, older ones are pruned by the next refusal (#6723)&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;charter resynthesize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Project layer, used with the built-in Charter Pack&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/PROVENANCE.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; fresh-project path&lt;/td&gt;&lt;td&gt;Human-readable provenance for the minimal doctrine seed of a fresh project&lt;/td&gt;&lt;td&gt;No&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; refreshes &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; (doctrine reference manifest) and
&lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt; (generation timestamp) sections deterministically; it never writes &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;. It no
longer materializes doctrine library pages as authoritative &lt;code dir=&quot;auto&quot;&gt;library/*.md&lt;/code&gt; files; doctrine content
is resolved through &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; section and the active charter service over the built-in Charter Pack and the project layer.&lt;/p&gt;
&lt;p&gt;Normal hand-authored &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt; is the supported default. &lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt;
refuses to overwrite a symlinked &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;, including with &lt;code dir=&quot;auto&quot;&gt;--force&lt;/code&gt;; replace the symlink with
a normal file before generation. This guard protects the companion file from an accidental
clobber — it has no bearing on runtime policy, which never reads &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;external-governance-documents&quot;&gt;External Governance Documents&lt;/h2&gt;
&lt;p&gt;Some repositories already have a public constitution, governance policy, or engineering handbook
outside &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt; (for example &lt;code dir=&quot;auto&quot;&gt;spec/constitution.md&lt;/code&gt;). Do not treat &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt;
or &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt; as a second full copy that must stay byte-for-byte equal to that
document.&lt;/p&gt;
&lt;p&gt;Use this ownership model instead:&lt;/p&gt;





















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Document&lt;/th&gt;&lt;th&gt;Role&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Public governance document outside &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Human-facing policy, historical record, or public project constitution.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Runtime charter consumed by Spec Kitty. Its &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt; sections should contain the operative policy agents need, plus &lt;code dir=&quot;auto&quot;&gt;governance.charter.governance_references&lt;/code&gt; pointers to external authority when useful.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Human-facing narrative companion. Useful for onboarding and review; not consumed by the runtime.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Recommended pattern:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Keep the external constitution as the public source for long-form governance.&lt;/li&gt;
&lt;li&gt;Keep &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt; sections concise and
runtime-oriented: encode the binding directives, and reference the public constitution through
&lt;code dir=&quot;auto&quot;&gt;governance.charter.governance_references&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;If agents should inspect a directory of supporting policy, declare that directory under
&lt;code dir=&quot;auto&quot;&gt;governance.charter.authority_paths&lt;/code&gt;:&lt;/li&gt;
&lt;/ol&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;governance&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;charter&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;authority_paths&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:#ECC48D;--1:#3B61B0&quot;&gt;spec/&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;governance_references&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:#ECC48D;--1:#3B61B0&quot;&gt;spec/constitution.md&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Current Spec Kitty does not support a configured external charter path that replaces
&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt; itself — the &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;charter:&lt;/code&gt; pointer is the one
supported redirection mechanism, and it points at a &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; file, not at &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;.&lt;/p&gt;
&lt;h3 id=&quot;editing-charteryaml&quot;&gt;Editing &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter sync&lt;/code&gt; command was removed (#5828). Edits to &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; are read live,
so no post-edit step is needed: the next &lt;code dir=&quot;auto&quot;&gt;charter context&lt;/code&gt; call reads the file as-is.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;git-policy&quot;&gt;Git Policy&lt;/h2&gt;
&lt;p&gt;Fresh checkouts must contain human-owned policy and must not require operators
to commit local build products. Use this policy for Spec Kitty-governed
projects:&lt;/p&gt;























































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Path&lt;/th&gt;&lt;th&gt;Git policy&lt;/th&gt;&lt;th&gt;Refresh command&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;.kittify/charter/charter.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Commit. This is the Spec Kitty runtime policy source.&lt;/td&gt;&lt;td&gt;Edit &lt;code dir=&quot;auto&quot;&gt;governance:&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives:&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;overrides:&lt;/code&gt; directly; run &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter generate&lt;/code&gt; to refresh &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/activation.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Commit. The activation ledger is git-tracked.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;deactivate&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Commit. Curated narrative companion, not a runtime source.&lt;/td&gt;&lt;td&gt;Edit directly, whenever convenient.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Commit. Holds the &lt;code dir=&quot;auto&quot;&gt;charter:&lt;/code&gt; pointer plus agent/pack config.&lt;/td&gt;&lt;td&gt;Edit directly to redirect the pointer.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/provenance/*&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Do not commit. Synthesis provenance is regenerated with the promoted project layer.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter synthesize&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/synthesis-manifest.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Do not commit. Generated synthesis manifest.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter synthesize&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/graph.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Do not commit. Project-local DRG overlay synthesized locally when needed.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter synthesize&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/pack.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Commit. Project pack descriptor; carries &lt;code dir=&quot;auto&quot;&gt;pack_id&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;pack_level&lt;/code&gt;, so every contributor shares one pack identity.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; (writes it once; commit it)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/{directive,tactic,procedure,overlays}/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Commit only when the project intentionally carries a durable project layer.&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter synthesize&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter resynthesize&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;If a project has a public governance document, keep it in that public location and reference it
from &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;:&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;governance&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;charter&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;governance_references&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:#ECC48D;--1:#3B61B0&quot;&gt;spec/constitution.md&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Do not enforce markdown equality between the public document and &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.md&lt;/code&gt; or
&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt; unless the project deliberately adopts a mirror policy outside
Spec Kitty’s defaults.&lt;/p&gt;
&lt;p&gt;Spec Kitty’s own repository does not follow this split today: besides &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;activation.yaml&lt;/code&gt; and selected project-layer artifacts, it also tracks its
synthesis manifest, the provenance sidecars and &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/graph.yaml&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;When a required local generated file is missing, do not hand-create it. Run:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;status&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;synthesize&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:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&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;charter&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;bundle&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;validate&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Use &lt;code dir=&quot;auto&quot;&gt;charter status&lt;/code&gt; to detect missing or stale local synthesis state such as
a missing synthesized DRG. Use &lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; to regenerate that local
state. &lt;code dir=&quot;auto&quot;&gt;charter bundle validate&lt;/code&gt; validates the committed charter-bundle
manifest and reports missing tracked policy, missing &lt;code dir=&quot;auto&quot;&gt;.gitignore&lt;/code&gt; entries (if any project-local
entries are required), and invalid synthesis state when synthesis artifacts are present; it does
not require a project-local DRG to exist in fresh checkouts that intentionally rely on the built-in
Charter Pack.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;what-happens-if-you-edit-a-generated-section&quot;&gt;What Happens If You Edit a Generated Section&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; can overwrite &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt; sections on every run —
that refresh is a merge that leaves &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;overrides&lt;/code&gt; alone,
but any hand edit made directly inside &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt; will be lost the next time
&lt;code dir=&quot;auto&quot;&gt;charter generate&lt;/code&gt; runs. &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt; are never touched by &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt; — edit them
freely.&lt;/p&gt;
&lt;p&gt;Use these commands to check the state of the bundle before relying on it:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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;# Detect orphaned artifacts, contradictions, and staleness in the graph&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:#82AAFF;--1:#3B61B0&quot;&gt;uv&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;run&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;spec-kitty&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;charter&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;lint&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:#919F9F;--1:#5F636F&quot;&gt;# Validate the bundle against the canonical schema&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:#82AAFF;--1:#3B61B0&quot;&gt;uv&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;run&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;spec-kitty&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;charter&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;bundle&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;validate&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:#919F9F;--1:#5F636F&quot;&gt;# Inspect current bundle 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 style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&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;run&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;spec-kitty&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;charter&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;status&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;If &lt;code dir=&quot;auto&quot;&gt;charter lint&lt;/code&gt; reports decay, run &lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; if project-local doctrine needs to be
re-promoted, or edit &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; directly to fix the underlying policy.&lt;/p&gt;
&lt;h2 id=&quot;migrating-constitution-era-files&quot;&gt;Migrating Constitution-Era Files&lt;/h2&gt;
&lt;p&gt;Projects upgraded from early Spec Kitty layouts may still have stale governance files:&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Legacy path&lt;/th&gt;&lt;th&gt;Current action&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;.kittify/memory/constitution.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Move current runtime policy into &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt; sections, or keep the old file only as archived project history.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/constitution/constitution.md&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Move current runtime policy into &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt;; do not keep it as an alternate runtime source.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/charter/{governance,directives,metadata,references}.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Legacy pre-inversion derived files. The upgrade migration folds their content into &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt; and removes them; do not hand-recreate them.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/constitution/{governance,directives,metadata}.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Delete or archive after confirming the upgrade migration has folded any remaining content into &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/charter.yaml&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;If the old constitution file is still useful as public or organizational context, put it in a
normal project path such as &lt;code dir=&quot;auto&quot;&gt;spec/constitution.md&lt;/code&gt; and list that path under
&lt;code dir=&quot;auto&quot;&gt;governance.charter.governance_references&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;bundle-validation&quot;&gt;Bundle Validation&lt;/h2&gt;
&lt;p&gt;The core charter bundle is validated against the &lt;strong&gt;CharterBundleManifest v2.0.0&lt;/strong&gt; schema by:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;uv&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;run&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;spec-kitty&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;charter&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;bundle&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;validate&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 v2.0.0 manifest tracks two files — &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; — and derives nothing:
&lt;code dir=&quot;auto&quot;&gt;derived_files&lt;/code&gt; is empty. &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; is also the sole entry in &lt;code dir=&quot;auto&quot;&gt;content_hash_files&lt;/code&gt;, the
content-identity input set used for the bundle’s freshness hash. &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt; is tracked (git
must contain it) but contributes nothing to that hash, since it is a companion, not an input.
The activation ledger &lt;code dir=&quot;auto&quot;&gt;activation.yaml&lt;/code&gt; is an optional tracked member
(&lt;code dir=&quot;auto&quot;&gt;optional_tracked_files&lt;/code&gt;): its absence is never a failure, and when present it is added to the
freshness hash (&lt;code dir=&quot;auto&quot;&gt;src/charter/bundle.py&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;charter lint&lt;/code&gt; performs graph-native decay checks — it detects orphaned directives (directives
that appear in the DRG but have no referencing tactic), contradictions (two directives with
conflicting instructions), and staleness (a directive whose provenance references a deleted or
superseded built-in directive).&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;generate-vs-synthesize&quot;&gt;Generate vs Synthesize&lt;/h2&gt;
&lt;p&gt;These two operations are different:&lt;/p&gt;

















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Command&lt;/th&gt;&lt;th&gt;What it does&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;charter generate&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Refreshes &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;metadata&lt;/code&gt; sections from interview answers + doctrine references. Bootstraps &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt; from a legacy triad only on first creation of &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;; on every later run it leaves them untouched. Never writes &lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Validates and promotes agent-generated project-local doctrine artifacts from &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/generated/&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;.kittify/charter-packs/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Edit &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;governance&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;directives&lt;/code&gt; sections directly for policy changes; run
&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; when the project layer needs to be refreshed.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See Also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/context/charter-overview/&quot;&gt;How Charter Works&lt;/a&gt; — mental model and synthesis flow&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/governance/synthesize-doctrine/&quot;&gt;How to Synthesize and Maintain Doctrine&lt;/a&gt; — day-to-day synthesis workflow&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/charter-pack-usage-journey/&quot;&gt;Charter Pack Usage Journey&lt;/a&gt; — why &lt;code dir=&quot;auto&quot;&gt;charter pack apply&lt;/code&gt; alone leaves the compiled bundle absent, and the &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt; follow-up that produces it&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
