What problem does it solve?
sp-planning prevents rushed or incorrect coding by forcing a structured plan that starts with reading the existing codebase, confirms the exact target project/repo, and produces an implementation-ready task tree with clear files, commands, and commit messages.
Core Features & Use Cases
- Reality-first exploration: Read relevant files, identify constraints and existing patterns, and check prior art before designing anything.
- Designer guardrails: No code writing, explicit approval before execution, and design at the structure level (refactor before adding behavior).
- Strict scope control: Enforces one task → one plan → one confirmed project/repo, and instructs splitting tasks when multiple repos are involved.
- Worker-ready plan quality: Requires each subtask to include exact file paths, what to do, build/test commands, and a copy-paste commit message.
- Checkpoint alignment and orientation: Includes a conversational checkpoint to confirm approach before proceeding, and optionally generates an orientation flicknote for complex work.
Quick Start
Use the sp-planning skill to produce a repo-scoped task tree plan by first running ttal project list, then exploring the codebase, aligning on approach, and writing a bite-sized implementation plan with exact files, commands, and commit messages.