writing-plans

Convert software requirements into test-first engineering implementation plans.

8|1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill writing-plans-joecp17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/JoeCP17/LLM-Dot-files/tree/main/claude/skills/superpowers/writing-plans
Command: npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill writing-plans-joecp17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

writing-plans helps you convert requirements into a clear, test-first, step-by-step plan before you touch any code, reducing ambiguity and rework.

Core Features & Use Cases

  • Multi-step plan writing: Breaks implementation into bite-sized tasks designed to be actionable by an engineer with limited context.
  • File-precise guidance: Instructs exactly which files to create or modify, including where tests live and what commands to run.
  • Execution handoff: Saves the plan to a dated docs location and offers a choice between immediate subagent execution or parallel execution in a worktree.
  • Use case: You receive a feature spec and want a TDD-oriented plan that enumerates failing tests, minimal implementations, exact test runs, and frequent commits.

Quick Start

Use the writing-plans skill to produce a complete implementation plan from your feature requirements and save it to docs/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 feature specs into step-by-step implementation plans?

Turn feature specs into implementation plans by converting multi-step requirements into file-level instructions with exact paths, test-first TDD steps, and 2–5 minute bite-sized tasks before coding. The plan is saved to docs/plans with a dated template for execution handoff.

What's the best way to break down software requirements into test-first engineering tasks?

Break down software requirements by enumerating failing tests, minimal implementations, exact test run commands, and frequent git commits into 2–5 minute tasks. This test-first approach produces file-precise guidance for engineers with limited context to execute efficiently.

How do I generate a TDD implementation plan for parallel execution in a git worktree?

Generate a TDD implementation plan by defining file-level instructions and test-first steps, then save it to docs/plans. The execution handoff offers a choice between immediate subagent execution or parallel execution in a git worktree.

Can I use implementation planning for subagent execution workflows?

Implementation planning supports subagent execution workflows by producing bite-sized 2–5 minute tasks with exact file paths, test commands, and commit instructions. The saved plan document provides the explicit header and structure required for handoff to a subagent.

Does implementation planning require dependencies to generate file-level coding instructions?

Implementation planning requires no dependencies to generate file-level coding instructions. It operates as a standalone workflow that processes multi-step software requirements into a dated docs/plans template with exact paths and test-first commands.

Why use a dedicated implementation plan instead of directly coding from a feature spec?

Use a dedicated implementation plan instead of direct coding to reduce ambiguity and rework. It converts requirements into explicit, file-precise instructions with test-first steps before you touch any code, ensuring actionable guidance for engineers with limited context.