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.