One-click install
npx skills add https://github.com/pedropaulovc/agent-plugins --skill writing-plans-pedropaulovc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/pedropaulovc/agent-plugins/tree/main/plugins/superpowers/skills/writing-plans
Command: npx skills add https://github.com/pedropaulovc/agent-plugins --skill writing-plans-pedropaulovc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

writing-plans converts messy requirements into a clear, engineer-ready implementation roadmap that minimizes guesswork, rework, and missing context.

Core Features & Use Cases

  • Bite-sized, test-driven tasks: Breaks work into 2–5 minute steps like writing failing tests, running them to confirm failure, implementing minimal code, rerunning tests, and committing frequently.
  • Codebase-orientation and file specificity: Forces plans to spell out exact file paths and what to create or modify, plus how to test and which docs to consult.
  • Subagent-driven execution handoff: Requires a specific implementation header that routes execution through the subagent-driven-development approach for task-by-task building and review.
  • External API grounding: Includes guardrails to verify real API response shapes with real calls and embed the verified response in the plan, avoiding mock assumptions.

Quick Start

Invoke the skill when you have a spec or requirements for a multi-step task, and ask it to produce a build-ready implementation plan saved under docs/plans with bite-sized TDD steps.

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 an implementation plan with TDD steps?

To turn a spec into an implementation plan, the skill breaks down multi-step engineering work into bite-sized, 2–5 minute test-driven tasks like writing failing tests, implementing minimal code, and committing frequently.

How do I create build-ready task plans that specify exact file paths?

Creating build-ready task plans requires spelling out exact file touchpoints for modifications, detailing testing instructions, and specifying which documentation to consult, minimizing guesswork and missing context during development.

How do you handle external API grounding in an implementation plan?

External API grounding in an implementation plan requires verifying real API response shapes with actual calls, then embedding the verified response directly in the plan to avoid mock assumptions during development.

What is the best way to plan multi-step engineering work for subagent delegation?

The best way to plan multi-step engineering work for subagent delegation is to include explicit plan document headers that route execution through a subagent-driven-development approach for task-by-task building and review.

Can I use this planning approach for new features requiring exact testing instructions?

Yes, this approach is specifically designed for new features where the implementer needs exact file touchpoints, guided task granularity, and explicit testing instructions to minimize rework during multi-step engineering work.

Where should I save the build-ready implementation plan generated from my requirements?

Build-ready implementation plans generated from your requirements should be saved under the docs/plans directory to maintain organization and ensure easy access for subagent-driven execution.