sanctuary-spec-kitty
Sanctuary Spec-Kitty Configuration
Status: Active
Domain: Project Sanctuary
Depends on: spec-kitty-plugin (generic spec-driven development framework)
Purpose
This skill is the Sanctuary-specific glue layer that knows how to configure and use the generic spec-kitty-plugin for Project Sanctuary's development workflow.
The spec-kitty-plugin has two layers:
- Auto-synced commands (from upstream CLI) — generic, overwritten on update
- AUGMENTED.md files (our custom best practices) — project-specific, never overwritten
This skill documents what's Sanctuary-specific about our spec-kitty setup.
Sanctuary-Specific Configuration
Constitution
The project constitution lives at .kittify/memory/constitution.md and is synced to .agent/rules/constitution.md. It defines:
- The Human Gate (no state-changing ops without explicit approval)
- The Hybrid Workflow (Universal start → Learning Loop or Custom Flow)
- Zero Trust git policy (never commit to main, never push without approval)
- Tool Discovery enforcement (use query_cache.py, no grep for tools)
AUGMENTED.md Files
These contain project-specific best practices that survive spec-kitty CLI updates:
| File | Sanctuary-Specific Content |
|---|---|
commands/spec-kitty-merge/AUGMENTED.md |
Pre-merge remote backup protocol, branch protection awareness (GH006 handling), kitty-specs conflict resolution |
commands/spec-kitty-implement/AUGMENTED.md |
Worktree discipline, absolute paths only, commit hygiene |
commands/spec-kitty-review/AUGMENTED.md |
Batch review protocol, dependency verification |
commands/spec-kitty-specify/AUGMENTED.md |
Doc co-authoring integration for specification quality |
commands/spec-kitty-plan/AUGMENTED.md |
Doc co-authoring integration for plan quality |
Workflow SKILL.md
skills/spec-kitty-workflow/SKILL.md is the end-to-end guide with:
- Anti-simulation rules (proof = pasted command output)
- Deterministic closure protocol (review → accept → retrospective → merge → verify)
- Pre-merge remote backup (mandatory)
- Dual-Loop mode integration (Protocol 133)
Orchestration Diagram
The end-to-end orchestration lifecycle—including verify_workflow_state.py gates and the downstream intelligence-sync—is mapped in our master diagram:
resources/diagrams/standard-spec-kitty-workflow.mmd
Sync Plugin
To update when spec-kitty CLI upgrades:
# Invoke the sync-plugin skill
/spec-kitty.sync-plugin
This runs sync_configuration.py, then the agent reviews AUGMENTED.md files for staleness.
Protected Files
The following files MUST NOT be deleted or corrupted during any sync or merge:
.agent/rules/constitution.md.agent/rules/standard-workflow-rules.md.agent/rules/01_PROCESS/*.agent/rules/02_OPERATIONS/*.agent/rules/03_TECHNICAL/*