planning-phase

What problem does it solve?

This Skill eliminates inefficient planning, missed code reuse opportunities, and unclear architecture, which often lead to rework, technical debt, and project delays.

Core Features & Use Cases

• Code Reuse Detection: Systematically identifies existing patterns, utilities, and components to leverage, maximizing code reuse (target ≥60%).
• Architecture Design: Defines clear layers, components, and dependencies, ensuring a modular and maintainable system.
• API Contract Definition: Specifies detailed request/response schemas, validation rules, and error cases for seamless frontend-backend integration.
• Use Case: Transform a feature specification into a detailed implementation plan for a "Student Progress Dashboard." This involves researching existing BaseModel and StandardController patterns, designing a service-oriented architecture, defining the GET /api/v1/students/{id}/progress API contract, and outlining a comprehensive testing strategy.

Quick Start

1. Search your codebase for similar patterns to reuse

grep -r "relevant patterns" src/

2. Document your reuse strategy in plan.md

Reuse Strategy

Existing patterns to leverage: BaseModel class (api/app/models/base.py)

New patterns to create: StudentProgressCalculator (api/app/utils/progress.py)