writing-plans

Generate implementation plans from feature specifications and save them to docs/plans.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans assuming the engineer has zero context for our codebase. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, and how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.

Core Features & Use Cases

  • Generate end-to-end implementation plans that specify files to touch, required tests, docs, and version-control steps.
  • Save plans to docs/plans/YYYY-MM-DD-<feature-name>.md to standardize tracking.
  • Follow a structured, task-by-task workflow that enables frequent commits, traceability, and reusability across projects.

Quick Start

Provide a complete, step-by-step implementation plan for a given 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 generate an implementation plan from a feature specification?

To generate an implementation plan from a feature specification, provide the spec to produce a step-by-step task breakdown. The plan details required file changes, tests, and documentation, saving to docs/plans with a YYYY-MM-DD feature name format.

When do I need a task-by-task implementation plan for multi-step features?

You need a task-by-task implementation plan for multi-step features requiring cross-file coordination, tests, documentation, and clear handoffs. It ensures frequent commits, traceability, and structured workflow across complex engineering tasks.

How to write implementation plans for engineers with zero codebase context?

Write implementation plans by documenting everything an engineer needs to know: which files to touch, required tests, and docs to check. Follow DRY, YAGNI, and TDD principles, breaking the feature into bite-sized tasks for frequent commits.

Does the generated implementation plan include testing and documentation steps?

Yes, the generated implementation plan includes testing and documentation steps. It creates end-to-end task breakdowns that specify files to touch, required tests, docs to check, and version-control steps to ensure comprehensive feature delivery.

What is the best way to standardize implementation plan tracking across projects?

The best way to standardize implementation plan tracking is to save plans as markdown files in docs/plans/YYYY-MM-DD-<feature-name>.md. This structured, task-by-task workflow enables frequent commits, traceability, and reusability across projects.

Can I use this plan generation workflow for single-file code changes?

This plan generation workflow targets multi-step tasks requiring cross-file coordination, documentation, and tests. For single-file changes or simple modifications, a comprehensive task breakdown with handoffs may be unnecessary overhead.