writing-plans

Create structured implementation plans with tasks, file changes, and review phases.

Updated May 19, 2026
One-click install
npx skills add https://github.com/swissonid/pi-superpowers --skill writing-plans-swissonid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/swissonid/pi-superpowers/tree/main/skills/writing-plans
Command: npx skills add https://github.com/swissonid/pi-superpowers --skill writing-plans-swissonid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write clear, end-to-end implementation plans from a spec or requirements, ensuring engineers know exactly what to build, test, and document.

Core Features & Use Cases

  • Decompose a spec into bite-sized tasks with clear ownership and file impact.
  • Produce a structured plan document that guides implementation, testing, and documentation.
  • Use for feature development, bug fixes, or refactors to reduce miscommunication and rework.

Quick Start

Create a plan document for the target feature and save it to docs/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I write an implementation plan from a software spec?

Writing an implementation plan involves decomposing a spec into bite-sized tasks with clear ownership, mapped file changes, testing steps, and documentation. This produces a structured plan document that guides engineers through the exact work required.

What is task decomposition in software development planning?

Task decomposition in software development is breaking down a feature, bug fix, or refactor into actionable steps. It enforces a standard plan structure with headers, per-task steps, and concrete file impacts to ensure completeness and traceability across the project.

Does my software development plan need to include a file map?

Yes, your software development plan should include a file map. Creating a comprehensive implementation plan requires mapping concrete file changes and per-task steps to ensure engineers know exactly what files to build, test, and document.

What's the best way to structure a refactor plan for a development team?

The best way to structure a refactor plan is using a standard format with headers, per-task steps, and concrete file impacts. This reduces miscommunication and rework by ensuring engineers know exactly what to build, test, and document during the refactoring process.

When do I need a formal implementation plan document?

You need a formal implementation plan document for multi-step software development tasks like feature development, bug fixes, or refactors. It is required whenever a spec demands breakdown into actionable steps, file maps, tests, and a review phase for traceability.

Can I use this planning approach for both small fixes and feature development?

Yes, you can use this planning approach for both small fixes and feature development. It applies to any software development task requiring breakdown into actionable steps, file maps, tests, and documentation, ensuring completeness and traceability across all scopes.