writing-plans

Generate implementation plans with tasks, files, tests, and milestones.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/BlackRoad-OS-Inc/blackroad-operator --skill writing-plans-blackroad-os-inc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/BlackRoad-OS-Inc/blackroad-operator/tree/main/agents/superpowers/skills/writing-plans
Command: npx skills add https://github.com/BlackRoad-OS-Inc/blackroad-operator --skill writing-plans-blackroad-os-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates comprehensive, implementation-ready plans from vague requirements, enabling engineers to start coding with clear direction and fewer reworks.

Core Features & Use Cases

  • Plan decomposition: translate requirements into tasks, files, tests, and milestones.
  • Collaboration-ready: structured plan documents suitable for design reviews and handoffs.
  • Reusable templates: standardized plan structure and review workflow to accelerate feature development.

Quick Start

Create a comprehensive implementation plan for a new feature 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 vague product requirements into an actionable engineering plan?▼

To turn vague requirements into an engineering plan, decompose the product spec into explicit tasks, file-by-file mappings, tests, and milestones using a standardized plan structure for clear development direction.

What's the best way to break down complex engineering tasks for design reviews?▼

The best way to break down engineering tasks for design reviews is generating structured plan documents that enforce explicit task decomposition and a standardized review workflow suitable for engineering handoffs.

How do I generate a development plan with file-by-file mapping for engineering handoffs?▼

Generate a development plan with file-by-file mapping by translating known product requirements into checklist-ready steps, explicit task decomposition, and milestones within a standardized plan document structure.

Does this planning approach work for complex version-control tasks and feature development?▼

Yes, this planning approach supports complex version-control tasks and feature development by creating comprehensive implementation plans that chunk complex requirements into manageable, checklist-ready engineering milestones.

When do I need a standardized plan document structure for task decomposition?▼

You need a standardized plan document structure for task decomposition when a product requirement is known but requires chunking into specific tasks, tests, and milestones before starting engineering work to reduce reworks.

Why should I use a structured implementation plan instead of coding directly from a spec?▼

You should use a structured implementation plan instead of coding directly from a spec because explicit task decomposition and milestone mapping provide clear direction for engineers, enabling fewer reworks and smoother design reviews.