<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/configuration-project-structure/">
  <id>https://docs.spec-kitty.ai/context/configuration-project-structure/</id>
  <title>Context: Configuration and Project Structure</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/configuration-project-structure/"/>
  <summary>Glossary context defining where policy, runtime configuration, and mission artifacts live in a Spec Kitty project (.kittify/, kitty-specs/, and related terms).</summary>
  <content type="html">&lt;h2 id=&quot;context-configuration-and-project-structure&quot;&gt;Context: Configuration and Project Structure&lt;/h2&gt;
&lt;p&gt;Terms describing where policy, runtime configuration, and mission artifacts live in a Spec Kitty project.&lt;/p&gt;
&lt;h3 id=&quot;kittify&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt;&lt;/h3&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Project-local configuration and shared memory directory.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Key contents&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;config.yaml&lt;/code&gt; (agents, project identity, charter packs), &lt;code dir=&quot;auto&quot;&gt;charter/&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;charter.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;activation.yaml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;interview/answers.yaml&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;glossaries/&lt;/code&gt; (glossary seed files), &lt;code dir=&quot;auto&quot;&gt;metadata.yaml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;migration-ledger.jsonl&lt;/code&gt; (migration metadata), &lt;code dir=&quot;auto&quot;&gt;events/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;runtime/&lt;/code&gt; (local event logs and consolidation state)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/governance/#charter&quot;&gt;Charter&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#mission&quot;&gt;Mission&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;kitty-specs&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;kitty-specs/&lt;/code&gt;&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Holds one Mission directory per Mission (&lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;mission_slug&gt;/&lt;/code&gt;), with its planning artifacts (&lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;plan.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tasks/&lt;/code&gt;, plus supporting files), &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt; and the status event log &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/orchestration/#mission&quot;&gt;Mission&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#work-package&quot;&gt;work package&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;worktrees&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;.worktrees/&lt;/code&gt;&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Holds the Git worktrees a Mission’s execution lanes use: one lane worktree per lane (&lt;code dir=&quot;auto&quot;&gt;.worktrees/&amp;#x3C;slug&gt;-lane-&amp;#x3C;id&gt;&lt;/code&gt;) and, for a coordination topology, the coordination worktree (&lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;Mission directory&gt;-coord&lt;/code&gt;). A &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission has no lane worktree: its work packages run in the write checkout.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/orchestration/#work-package&quot;&gt;work package&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#lane&quot;&gt;Lane&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;glossary&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;glossary/&lt;/code&gt;&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Policy-level language authority for terminology and semantic contracts. A project has no top-level &lt;code dir=&quot;auto&quot;&gt;glossary/&lt;/code&gt; directory: the glossary seed files live in &lt;code dir=&quot;auto&quot;&gt;.kittify/glossaries/&amp;#x3C;scope&gt;.yaml&lt;/code&gt;, and the glossary code lives in &lt;code dir=&quot;auto&quot;&gt;src/glossary/&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/system-events/#glossary-scope&quot;&gt;Glossary Scope&lt;/a&gt;, &lt;a href=&quot;/context/execution/#semantic-check&quot;&gt;Semantic Check&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;bootstrap-candidate&quot;&gt;Bootstrap (Candidate)&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Proposed onboarding flow to collect project intent, constraints, and glossary context early. It is not a CLI command: today &lt;code dir=&quot;auto&quot;&gt;spec-kitty charter interview&lt;/code&gt; captures the charter answers. Not to be confused with the bootstrap mode of charter context loading (&lt;a href=&quot;/context/charter-overview/#bootstrap-vs-compact-context&quot;&gt;Bootstrap vs Compact Context&lt;/a&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/governance/#charter&quot;&gt;Charter&lt;/a&gt;, &lt;a href=&quot;/context/orchestration/#mission&quot;&gt;Mission&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;project-charter&quot;&gt;Project Charter&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The compiled, project-specific charter containing the HiC’s governance decisions, activation choices, interview answers, and reference manifest. Stored in &lt;code dir=&quot;auto&quot;&gt;.kittify/charter/&lt;/code&gt;: decisions in &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;, activation choices in &lt;code dir=&quot;auto&quot;&gt;activation.yaml&lt;/code&gt;, interview answers in &lt;code dir=&quot;auto&quot;&gt;interview/answers.yaml&lt;/code&gt;, and the reference manifest as the &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; section of &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; (it replaced the retired &lt;code dir=&quot;auto&quot;&gt;references.yaml&lt;/code&gt;). Use “Project Charter” when distinguishing from the Charter Library.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;canonical&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;/context/governance/#charter&quot;&gt;Charter&lt;/a&gt;, &lt;a href=&quot;#charter-library&quot;&gt;Charter Library&lt;/a&gt;, &lt;a href=&quot;/context/identity/#human-in-charge-hic&quot;&gt;Human-in-Charge (HiC)&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;charter-library&quot;&gt;Charter Library&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Definition&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The project-local collection of doctrine source documents that the HiC has selected, stored alongside the Project Charter and indexed by a reference manifest. The compiler writes no separate library directory today: the references are listed in the &lt;code dir=&quot;auto&quot;&gt;catalog&lt;/code&gt; section of &lt;code dir=&quot;auto&quot;&gt;charter.yaml&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;_build_catalog_dict&lt;/code&gt; in &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;&lt;strong&gt;Context&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Configuration &amp;#x26; Project Structure&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Status&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;candidate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Applicable to&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;1.x&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Related terms&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;a href=&quot;#project-charter&quot;&gt;Project Charter&lt;/a&gt;, &lt;a href=&quot;/context/charter/#charter-offering&quot;&gt;Charter offering&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;</content>
</entry>
