writing-plans

Generate structured implementation plans listing files, tests, and docs.

2|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/yuma588/skill-gallery --skill writing-plans-yuma588
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/yuma588/skill-gallery/tree/main/skill-gallery-deploy/skills/community/superpower/writing-plans
Command: npx skills add https://github.com/yuma588/skill-gallery --skill writing-plans-yuma588

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documenting every detail of a multi-step task before touching code helps teams coordinate, reduce rework, and ensure a shared understanding of requirements, tests, and deliverables.

Core Features & Use Cases

  • Create a complete, task-level implementation plan that identifies files to touch, tests to write, and docs to review.
  • Provide a ready-to-execute sequence of steps that a developer can follow, ensuring DRY, YAGNI, and TDD practices.
  • Save the plan to a centralized location for traceability (docs/plans/YYYY-MM-DD-<feature-name>.md) and enable quick handoffs between teammates.

Quick Start

Create a detailed implementation plan for the 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
What is an implementation plan for software development and when do I need one?▼

An implementation plan documents task-level execution steps, files to touch, and tests to write before coding. You need one for cross-functional feature development, complex requirements, or scenarios with incomplete specs to align engineers on scope.

How do I create a detailed task breakdown for a multi-step coding project?▼

To create a task breakdown, generate a structured plan listing touched files, testing steps, and documentation needs. This provides a ready-to-execute sequence ensuring DRY, YAGNI, and TDD practices for developers to follow.

How do I structure documentation for feature implementation plans to ensure team alignment?▼

Structure implementation documentation by listing touched files, tests, and deliverables, then save the plan to a centralized path like docs/plans/YYYY-MM-DD-<feature-name>.md. This enables traceability and quick handoffs between teammates.

Can I use task-level planning for cross-functional features with incomplete specs?▼

Yes, task-level planning is specifically designed for scenarios with incomplete specs and cross-functional feature development. It generates a detailed execution plan that aligns engineers on scope and deliverables before coding begins.

What is the best way to document software implementation steps for developer handoffs?▼

The best way to document implementation steps for handoffs is generating a structured plan with testing steps and documentation needs, saving it to docs/plans/YYYY-MM-DD-<feature-name>.md. This reduces rework and ensures shared understanding.