plan-management
Apply project planning conventions when creating or organizing plans. Use when user asks to create a plan, add a feature plan, document a bug, or work with the plans/ directory.
When & Why to Use This Skill
This Claude skill streamlines project organization by enforcing structured planning conventions and standardized documentation workflows. It automates the creation, categorization, and lifecycle tracking of technical plans, ensuring consistency across complex development projects through predefined directory structures and status management.
Use Cases
- Feature Roadmap Initialization: Automatically generate structured plans for new features (e.g., gameplay or UI) using standardized templates and incremental numbering to maintain a clear project trajectory.
- Systematic Bug Tracking: Document bug investigations and proposed fixes within the dedicated 'plans/bugfixes/' directory, ensuring all technical issues are addressed with clear acceptance criteria.
- Automated Progress Documentation: Proactively update plan statuses to 'Complete' and generate implementation summaries after finishing tasks, keeping the project history accurate without manual overhead.
- Technical Debt Management: Organize research and superseded plans into reference or archive folders to maintain a clean and navigable workspace for long-term development.
| name | plan-management |
|---|---|
| description | Apply project planning conventions when creating or organizing plans. Use when user asks to create a plan, add a feature plan, document a bug, or work with the plans/ directory. |
Plan Management Conventions
This project uses a structured planning system. Apply these conventions when working with plans.
Directory Structure
| Folder | Purpose |
|---|---|
plans/model/ |
Wave physics, simulation, timing |
plans/visuals/ |
Rendering, gradients, effects |
plans/gameplay/ |
Surfer, controls, multiplayer |
plans/tooling/ |
Debug panel, dev tools |
plans/testing/ |
Test strategy |
plans/bugfixes/ |
Bug investigation and fixes |
plans/world/ |
Environmental systems |
plans/reference/ |
Research docs (never archive) |
plans/archive/ |
Superseded plans |
Numbering Convention
- Use increments of 10 (10, 20, 30...) to allow inserting related plans
- Check existing files in target folder to find next available number
- Preserve numbers when moving plans between folders
Plan Template
# Plan [NUMBER]: [Title]
**Status**: Proposed | In Progress | Blocked | Complete
**Category**: model | visuals | gameplay | tooling | testing | bugfixes
**Depends On**: [other plan numbers, if any]
## Problem
Clear statement of what needs to be solved.
## Proposed Solution
Technical approach and key design decisions.
## Implementation Steps
1. First step with clear acceptance criteria
2. Second step...
## Files Affected
- `src/file.js` - What changes needed
## Testing
How to verify the implementation works correctly.
Updating Plans After Implementation
When completing implementation steps from a plan:
- Update status - Change
**Status**: Proposedto**Status**: Complete(orIn Progressif partially done) - Add completion summary - Add a
## Completion Summarysection at the end documenting:- What was implemented
- Any deviations from the original plan
- Files that were actually modified
- Do this proactively - Update the plan immediately after finishing, without waiting for user to ask
When to Apply
Automatically apply when:
- User says "create a plan", "add a feature", "document this"
- Working with files in
plans/directory - User references plan numbers or categories
- Completing implementation of a plan (update status and add summary)