planning-phase

Generate implementation plans from feature specifications with code reuse and architecture modeling.

Updated Oct 26, 2025
One-click install
npx skills add https://github.com/oxie/portfolio-cms-project --skill planning-phase-oxie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-phase
Source: https://github.com/oxie/portfolio-cms-project/tree/main/.claude/skills/planning-phase
Command: npx skills add https://github.com/oxie/portfolio-cms-project --skill planning-phase-oxie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill transforms feature specifications into detailed implementation plans, emphasizing code reuse, design pattern selection, and robust architecture decisions. It prevents technical debt, ensures efficient and consistent development, and provides a clear blueprint for implementation.

Core Features & Use Cases

  • Code Reuse Detection: Guides research for existing patterns, utilities, and components to maximize code reuse and reduce development time.
  • Architecture Design: Defines application layers, components, and dependencies, documenting major architectural decisions (ADRs).
  • API Contract Definition: Specifies detailed request/response schemas, validation rules, and error handling for API endpoints.
  • Testing Strategy: Outlines comprehensive unit, integration, and end-to-end testing approaches with clear coverage targets.
  • Use Case: A feature specification is complete. This skill helps a technical lead or architect create a comprehensive implementation plan, ensuring maximum code reuse and a solid architectural foundation before any code is written.

Quick Start

Plan the 'Student Progress Dashboard' feature, identifying code reuse opportunities, designing the architecture, and defining API contracts.

Frequently Asked Questions about planning-phase

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an implementation plan that maximizes code reuse?

Code reuse detection guides research for existing patterns, utilities, and components before implementation. This Skill automates the planning phase by analyzing specifications, identifying reusable assets, and documenting them in a comprehensive plan.md artifact to reduce development time and prevent duplicated code.

What should a software architecture plan include?

A solid architecture plan defines application layers, components, and dependencies, documenting major architectural decisions (ADRs). This Skill generates detailed architecture models from feature specifications, ensuring consistent development and providing a clear blueprint before coding begins.

How do I define API contracts during the planning phase?

API contract definition specifies request/response schemas, validation rules, and error handling for endpoints. This Skill produces detailed API contracts as part of the planning phase, ensuring alignment between frontend and backend before implementation.

When should I plan testing strategy before implementation?

Testing strategy planning outlines unit, integration, and end-to-end testing approaches with clear coverage targets before development starts. This Skill includes testing strategy as a core planning artifact, reducing rework and ensuring comprehensive coverage targets are defined upfront.

Can I use this for technical design and research assessment?

Yes, this Skill covers research depth assessment and technical design across the planning phase. It guides design pattern selection, research for reusable components, and produces research.md artifacts documenting findings and technology recommendations.

What outputs does the planning phase generate?

The planning phase produces plan.md, research.md, and an updated workflow-state.yaml. These artifacts document implementation strategy, code reuse opportunities, architectural decisions, API contracts, and testing approaches for handoff to development.