What problem does it solve?
It prevents workflow breakage by clarifying which git actions Spec Kitty’s Python automation performs versus which actions LLM agents must perform manually, including worktree lifecycle, auto-commit behavior, and the safe-commit pattern.
Core Features & Use Cases
- Worktree lifecycle governance: Ensures agents use Spec Kitty commands to create and reuse lane worktrees instead of manually running
git worktree add.
- Auto-commit boundaries: Explains when planning artifacts and lane transition artifacts are auto-committed by Python (configurable via
auto_commit or --no-auto-commit).
- Safe-commit and merge execution rules: Documents the safe-commit pattern for lane transitions, plus how merges run (including pre-flight validation, cleanup, and conflict handling expectations).
- Use case: When implementing multiple dependent WPs in the same execution lane, agents follow the correct commit/rebase/merge responsibilities so merges succeed and worktrees are cleaned up without corrupting the main repo.
Quick Start
Use this spec to guide an agent in implementing a WP (e.g., WP01) by committing implementation changes inside the lane worktree, then handling any required rebase conflicts before requesting for review or merge.
