ss-sdd-preflight

What problem does it solve?

Ensures a spec-driven-development run starts in a valid, commit-capable repository state so later stages can rely on configuration and branch assumptions without surprises.

Core Features & Use Cases

• Config validation gate: Confirms .sublime-skills/config.yml exists and passes validate-config.sh, aborting immediately if missing or invalid.
• Git and branch readiness checks: Verifies the current directory is inside a git repository and that HEAD is attached to a named branch (aborts if detached).
• Permissive dirty-tree handling: Warns when the working tree is dirty, then asks for confirmation to proceed so existing user changes remain untouched.
• SDD state shell initialization: Removes any orphan .sublime-skills/state.json from a prior dead pipeline and creates a fresh minimal state.json only after all hard checks pass.
• Use case: Before drafting specs and planning implementation tasks, run this to avoid wasted work caused by misconfigured SDD, missing bootstrap artifacts, or running on detached HEAD.

Quick Start

Tell your agent to run the ss-sdd-preflight skill to verify the repo configuration, git readiness, and create the initial .sublime-skills/state.json shell.