shipit-kit:plan

What problem does it solve?

Converts feature specifications and research into a concrete, test-driven implementation plan so teams can move from discovery to implementation without unresolved questions or missing tests. It enforces a gate check on open research questions and ensures planning follows a mandatory RED-GREEN-REFACTOR workflow so work is incremental, test-first, and traceable.

Core Features & Use Cases

• Gate Enforcement: Reads research.yaml and stops planning if any openQuestions have resolved: false to prevent premature implementation.
• Architecture & TDD Plans: Produces a high-level architecture overview and breaks work into TDD-aligned phases (Foundational, RED, GREEN, REFACTOR) for Domain, Application, and Infrastructure layers.
• YAML Sources of Truth: Generates plan.yaml and tasks.yaml with clear rules about content separation, writes data-model.md when needed, updates status fields and feature.yaml, and provides an actionable tasks[] array for tracking.
• Developer Workflow Integration: Lists files to create/modify, identifies parallelizable tasks, prescribes testing strategy, documents risks and rollback steps, and prescribes commit and CI-watch steps for each phase.
• Use Case: Ideal for engineering teams using ShipIT to convert a completed spec and research into an implementation backlog that enforces tests-first development.

Quick Start

Use shipit-kit:plan to generate a TDD implementation plan and tasks.yaml from the spec and research in specs/NNN-feature-name so the feature is ready for implementation.