writing-plans

Create implementation plans with file-level tasks and test-first steps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a specification or requirements brief into a complete implementation plan that an engineer can follow without needing prior context.

Core Features & Use Cases

  • Breaks a feature into focused file-level tasks with clear responsibilities.
  • Pairs each task with actionable test-first steps, exact commands, and commit guidance.
  • Uses self-review to catch missing requirements, placeholders, and type mismatches before handoff.

Quick Start

Ask the writing-plans skill to convert your spec into a bite-sized implementation plan and save it in the recommended planning location.

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 specification into an actionable implementation plan?

An implementation plan converts a specification into file-by-file task decomposition with actionable steps and test commands. It breaks a feature into focused file-level tasks with clear responsibilities, paired with test-first steps and commit guidance.

What is task decomposition for multi-step software features?

Task decomposition splits multi-step software features into focused file-level tasks with clear responsibilities. Each task includes actionable test-first steps, exact commands, and commit guidance, ensuring an engineer can follow the plan without prior context.

How do I break down a feature request into test-driven development tasks?

Break down a feature request by pairing each file-level task with actionable test-first steps and exact test commands. This approach ensures test-driven development by requiring concrete test commands and commit guidance for every task in the implementation plan.

Can I generate an engineer-ready implementation plan without providing exact file paths?

No, an engineer-ready implementation plan requires exact file paths. The plan needs actionable steps, concrete test commands, and self-review for completeness, consistency, and placeholder-free planning to ensure an engineer can execute it without needing prior context.

What's the best way to ensure an implementation plan has no missing requirements or placeholders?

Use a self-review process for completeness, consistency, and placeholder-free planning. This catches missing requirements, placeholders, and type mismatches before handoff, ensuring the final implementation plan is fully actionable and engineer-ready.

Does implementation planning work for multi-step software tasks using a worktree setup?

Yes, implementation planning applies to multi-step software tasks and supports specifications needing file-by-file decomposition. It accommodates worktree setups by providing focused file-level tasks with test-first task breakdown and commit guidance.