<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/context/planning-and-tracking/">
  <id>https://docs.spec-kitty.ai/context/planning-and-tracking/</id>
  <title>Context: Planning &amp; Tracking</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/planning-and-tracking/"/>
  <summary>Glossary context for planning and tracking: how work is organized, classified, and dispatched across the tracker and execution tiers (companion to the seed).</summary>
  <content type="html">&lt;h2 id=&quot;context-planning--tracking&quot;&gt;Context: Planning &amp;#x26; Tracking&lt;/h2&gt;
&lt;p&gt;Terms describing how work is organized, classified, and dispatched in the issue
tracker and across the execution tiers. Human-readable companion to the
&lt;code dir=&quot;auto&quot;&gt;.kittify/glossaries/planning-and-tracking.yaml&lt;/code&gt; seed (the machine-checkable
subset); when the two differ, the seed governs semantic-check resolution and this
page governs prose. Surfaces are lowercase to match the seed.&lt;/p&gt;
&lt;h3 id=&quot;functional-epic&quot;&gt;functional epic&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;An epic that represents a real domain of work — a subsystem, capability, or bug-class — and owns its tickets as native sub-issues. Contrasted with a meta-tracker. Functional epics, not meta-trackers, are the canonical parents of work.&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;Planning &amp;#x26; Tracking&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;3.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;#meta-tracker&quot;&gt;meta-tracker&lt;/a&gt;, &lt;a href=&quot;#issue-type&quot;&gt;issue type&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;meta-tracker&quot;&gt;meta-tracker&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;A tracking or convenience issue — release gate, go/no-go, or program rollup — that references work via checklist but must NOT own functional tickets as their canonical parent. Titles are prefixed &lt;code dir=&quot;auto&quot;&gt;META-TRACKER:&lt;/code&gt;. Release gating belongs in milestones or labels, not in issues-as-parents.&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;Planning &amp;#x26; Tracking&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;3.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;#functional-epic&quot;&gt;functional epic&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;issue-type&quot;&gt;issue type&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 GitHub issue-type classification (Task, Bug, or Feature) applied to every ticket, orthogonal to priority. Epics are typed Feature. The invariant &lt;code dir=&quot;auto&quot;&gt;bug label &amp;#x3C;-&gt; type Bug&lt;/code&gt; holds. Type captures the kind of work; the legacy Px-description labels that conflated priority with type are retired.&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;Planning &amp;#x26; Tracking&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;3.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;#priority-scheme&quot;&gt;priority scheme&lt;/a&gt;, &lt;a href=&quot;#triage-status&quot;&gt;triage status&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;priority-scheme&quot;&gt;priority scheme&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 canonical issue-priority labels &lt;code dir=&quot;auto&quot;&gt;priority:P0&lt;/code&gt; .. &lt;code dir=&quot;auto&quot;&gt;priority:P3&lt;/code&gt;. The legacy &lt;code dir=&quot;auto&quot;&gt;Px-description&lt;/code&gt; labels (P0-critical, P1-bug, P2-enhancement, P3-future, P4-wontfix) are retired in favor of &lt;code dir=&quot;auto&quot;&gt;priority:Px&lt;/code&gt; plus the orthogonal issue-type field.&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;Planning &amp;#x26; Tracking&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;3.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;#issue-type&quot;&gt;issue type&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;triage-status&quot;&gt;triage status&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;A cross-priority label namespace marking a ticket’s disposition pending triage: &lt;code dir=&quot;auto&quot;&gt;triage:stale&lt;/code&gt; (reproduce and close if no longer valid), &lt;code dir=&quot;auto&quot;&gt;triage:needs-revision&lt;/code&gt; (scope/spec needs rework), and &lt;code dir=&quot;auto&quot;&gt;triage:maybe-duplicate&lt;/code&gt; (suspected duplicate pending confirmation — distinct from the confirmed &lt;code dir=&quot;auto&quot;&gt;duplicate&lt;/code&gt; label).&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;Planning &amp;#x26; Tracking&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;3.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;#issue-type&quot;&gt;issue type&lt;/a&gt;, &lt;a href=&quot;#priority-scheme&quot;&gt;priority scheme&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;usability-label&quot;&gt;usability (label)&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 &lt;code dir=&quot;auto&quot;&gt;usability&lt;/code&gt; label, marking operator/user-experience and ergonomics concerns (CLI surface, status display, command clarity). Narrows the UX overlap previously folded into the &lt;code dir=&quot;auto&quot;&gt;workflow&lt;/code&gt; label.&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;Planning &amp;#x26; Tracking&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;3.x&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h3 id=&quot;op&quot;&gt;op&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;A bounded, doctrine-governed agent action dispatched immediately without mission overhead that still produces a durable, git-tracked record. The execution tier between a full Mission and untracked ad-hoc invocation. Today an Op is opened with &lt;code dir=&quot;auto&quot;&gt;spec-kitty dispatch &quot;&amp;#x3C;request&gt;&quot;&lt;/code&gt; and closed with &lt;code dir=&quot;auto&quot;&gt;spec-kitty profile-invocation complete&lt;/code&gt;; see &lt;a href=&quot;/context/ops-vs-missions/&quot;&gt;Ops vs. Missions&lt;/a&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Note&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;The seed still names &lt;code dir=&quot;auto&quot;&gt;ask&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;advise&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;do&lt;/code&gt; commands, which the CLI no longer has.&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;Planning &amp;#x26; Tracking&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;3.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/execution/#tool&quot;&gt;Tool&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id=&quot;glossary-scope--planning--tracking-subset-deferred-runtime-scope&quot;&gt;Glossary Scope — Planning &amp;#x26; Tracking subset (deferred runtime scope)&lt;/h2&gt;
&lt;p&gt;The terms above are tracker-organization vocabulary. They are &lt;strong&gt;not&lt;/strong&gt; yet bound to
a runtime &lt;a href=&quot;/context/system-events/#glossary-scope&quot;&gt;Glossary Scope&lt;/a&gt;; the current scope
enum is &lt;code dir=&quot;auto&quot;&gt;mission_local&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;team_domain&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;audience_domain&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec_kitty_core&lt;/code&gt;
(see &lt;code dir=&quot;auto&quot;&gt;src/glossary/scope.py&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Deferred (FR-011, tracked as &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/1418&quot;&gt;#1418&lt;/a&gt;).&lt;/strong&gt; Promoting the planning-and-tracking
subset to a first-class runtime &lt;code dir=&quot;auto&quot;&gt;GlossaryScope&lt;/code&gt; enum value is intentionally
deferred. Rationale: mission runs are not yet wired into the issue-tracking
concepts (epics, triage labels, the Op tier), so a runtime scope would have no
resolution surface to bind against. #1418 was closed as completed on 2026-07-22,
after it shipped glossary packs (PR #2852); it did not add this scope, and this page
knows of no open issue for the deferral. Reassess once mission runtime consumes tracking
vocabulary. Until then this subset lives as a seed file
(&lt;code dir=&quot;auto&quot;&gt;.kittify/glossaries/planning-and-tracking.yaml&lt;/code&gt;) and this human-readable page,
deliberately outside the runtime scope hierarchy.&lt;/p&gt;</content>
</entry>
