writing-plans

Convert software specifications into structured Markdown implementation plans.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/yt8766/learning-agent-core --skill writing-plans-yt8766
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/yt8766/learning-agent-core/tree/main/.agents/skills/writing-plans
Command: npx skills add https://github.com/yt8766/learning-agent-core --skill writing-plans-yt8766

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers convert vague specifications or requirements into comprehensive, ready-to-implement plans before coding, reducing ambiguity and rework.

Core Features & Use Cases

  • Plan decomposition: break down a spec into concrete tasks, files to touch, and milestones.
  • Documentation guidance: outline tests, docs, and examples to guide development and validation.
  • Predictable workflows: enforce DRY, YAGNI, and test-driven planning to streamline delivery.

Quick Start

Write a complete implementation plan from the provided spec and save it to docs/superpowers/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 turn a software spec into a step-by-step implementation plan?

To turn a spec into an implementation plan, decompose requirements into concrete tasks, map files to modify, define milestones, and outline testing and documentation to reduce ambiguity and rework.

What is task decomposition for software development planning?

Task decomposition is breaking down a specification into discrete, actionable steps, including file mapping, scope definition, and milestone creation, to ensure predictable and test-driven project delivery.

How do I structure a multi-step development plan to reduce rework?

Structure a development plan by enforcing DRY and YAGNI principles, outlining required tests, documenting examples, and mapping file modifications to create a predictable workflow before coding begins.

Does this planning workflow enforce test-driven development practices?

Yes, the planning workflow enforces test-driven planning by explicitly outlining tests and documentation tasks within the structured plan, guiding development validation and ensuring reliable delivery.

What is the best way to document implementation plans for reliable handoffs?

The best way to document implementation plans for reliable handoffs is generating a structured Markdown file that covers scope definition, file mapping, milestones, and testing tasks, saved to a standardized directory.