planning

What problem does it solve?

This Skill formalizes and streamlines the development workflow for new features, ensuring a consistent, Test-Driven Development (TDD) approach. It helps developers plan effectively, track progress, and integrate both runtime and type testing to build robust TypeScript applications, reducing ad-hoc processes and potential regressions.

Core Features & Use Cases:

• Structured TDD Workflow: Guides you through a comprehensive 5-step process (Snapshot, Log, Write Tests, Implement, Close Out) for predictable and high-quality feature development.
• Comprehensive Testing Guidance: Provides detailed instructions on when and how to apply both runtime and type tests, including common pitfalls and best practices specific to TypeScript.
• Automated State Tracking: Utilizes a script to capture the repository's Git and test state at the beginning of each development phase, establishing clear baselines and aiding in debugging.
• Use Case: When you're about to start a new feature, activate this Skill to automatically generate a structured plan, capture your current project state, and receive step-by-step guidance through a TDD cycle, ensuring your work is well-tested and documented.

Quick Start:

To capture the initial state for a new plan phase (e.g., "my-new-feature", phase 1):

bun run .claude/skills/planning/scripts/start-position.ts my-new-feature 1