What problem does it solves?
Complex software features often lead to disorganized development, missed dependencies, and difficult code reviews. This Skill provides a structured framework to break down large features into manageable, phase-based plans, ensuring clarity, efficient multi-PR implementation, and reduced development friction.
Core Features & Use Cases
- Phased Implementation Strategy: Breaks down complex features into stackable, shippable Pull Requests (PRs) with clear goals, deliverables, and dependencies for a smooth rollout.
- Agent-Friendly Documentation: Generates detailed, navigable plans in
~/.ai/plans/ using progressive disclosure, allowing AI agents (or humans) to quickly gather context at various depths.
- Context Preservation: Documents key architectural decisions, trade-offs, potential gotchas, and testing strategies for future reference, minimizing rework and confusion.
- Use Case: A product manager requests a new "User Onboarding Flow" feature that involves multiple backend and frontend changes. This skill can be used to generate a comprehensive plan, outlining database schema changes, API modifications, UI components, and testing strategies across several development phases, ensuring a predictable and successful launch.
Quick Start
Use the feature-planning skill to create a detailed plan for the "User Onboarding Flow" feature.
Break it down into logical phases.