/spk-charter-governance

name: spk-charter-governance
description: >-
  Run Spec Kitty charter interview, generation, context loading, and
  synchronization workflows for project governance. Access charter artifacts
  programmatically via ActiveCharterService. Resolve agent profiles. Load
  action-scoped governance context iteratively, not all at once.
  Triggers: "interview for charter", "generate charter",
  "sync charter", "use doctrine", "set up governance",
  "charter status", "extract governance config", "load doctrine",
  "agent profile", "ActiveCharterService", "action index".
  Does NOT handle: generic spec writing not tied to governance, direct runtime
  loop advancement, setup/repair diagnostics, or editorial glossary maintenance.

spk-charter-governance

Use this skill for project governance, charter creation, charter sync, or charter context questions.

`.kittify/charter/charter.yaml` is the runtime governance source for a project; `.kittify/charter/charter.md` is a human-readable companion the runtime never parses. The charter offering (`src/charter/offering/`) supplies the reusable directives, tactics, paradigms, styleguides, toolguides, procedures, agent profiles, and step contracts the charter references.

Invariant

spec-kitty never calls an LLM. The harness running this skill is the inference engine: when asked to synthesize charter artifacts, author them yourself, then let the CLI validate and promote them.

Flow

1. Invoke `/spec-kitty.charter` or the relevant charter command. 2. Check the current state:

   spec-kitty charter status --json

3. Discover the change in chat, write `.kittify/charter/interview/answers.yaml`, then generate:

   spec-kitty charter generate --from-interview --json

4. Keep governance decisions explicit and versioned; edit `charter.yaml` directly for policy changes. 5. Load charter context on demand, scoped to the active action:

   spec-kitty charter context --action <action> --json

6. Use the `spk-charter-glossary` and `spk-charter-spdd-reasons` skills when the charter selects those practices; load profiles with `spk-charter-profile-load`.

References

• `references/charter-governance-workflow.md` -- Full workflow: agent-driven

synthesis, the charter model and data flow, artifact kinds, `ActiveCharterService` access, profile resolution, and common pitfalls.

• `references/charter-command-map.md` -- Full CLI command reference with all

flags and output fields.

• `references/charter-artifact-structure.md` -- File layout, authority

classes, and data flow.