writing-plans

Draft step-by-step implementation plans with tasks, files, tests, and milestones.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/softbreezee/claw-os --skill writing-plans-softbreezee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/softbreezee/claw-os/tree/main/temp_skills/superpowers-main/skills/writing-plans
Command: npx skills add https://github.com/softbreezee/claw-os --skill writing-plans-softbreezee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafting end-to-end implementation plans from vague specs can be time-consuming and error-prone. This skill provides a repeatable template that translates requirements into actionable tasks, files to touch, tests to write, and milestones to track.

Core Features & Use Cases

  • Structured plan generation: Converts a spec into a step-by-step plan with defined tasks, file changes, tests, and commits.
  • Design unit mapping: Outlines file boundaries and interfaces for the new feature to ensure cohesive design.
  • Documentation-first workflow: Encourages upfront documentation to reduce ambiguity and rework.

Quick Start

Provide a complete implementation plan for the given spec, including task lists, file changes, tests, and milestones.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I create a step-by-step implementation plan from a software spec?

To create an implementation plan from a spec, map each requirement to concrete file changes, executable tasks, and tests. This approach breaks features into self-contained milestones, ensuring every step is testable and ready for execution in a structured Markdown document.

What is the best way to structure task decomposition for a new software feature?

Task decomposition for a software feature works best by mapping design units to specific files and interfaces, then outlining explicit milestones. This method reduces ambiguity by documenting boundaries upfront, resulting in a step-by-step plan with testable, self-contained tasks.

How does documentation-first workflow improve software implementation planning?

A documentation-first workflow improves software implementation planning by establishing clear design units and file boundaries before coding begins. Upfront documentation reduces ambiguity and rework, translating vague specs into actionable tasks with explicit test requirements and mapped file changes.

Can I generate a testable implementation plan for vague software requirements?

Yes, you can generate a testable implementation plan for vague software requirements by applying a structured template that defines scope, design units, and milestones. This process converts ambiguous specs into a finished Markdown document with executable steps and explicit tests.

What should be included in an actionable software engineering implementation plan?

An actionable software engineering implementation plan should include a top-level header, a numbered task structure, mapped file changes, explicit executable steps, and defined tests. Each step must be self-contained and testable, ensuring cohesive design and trackable milestones.