writing-plans

Convert project specs into task-by-task implementation plans with file paths and tests.

1|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/xiaobin/superpowers-kimi --skill writing-plans-xiaobin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/xiaobin/superpowers-kimi/tree/main/.agents/skills/writing-plans
Command: npx skills add https://github.com/xiaobin/superpowers-kimi --skill writing-plans-xiaobin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automates turning project specs into comprehensive, executable implementation plans. This skill guides engineers to document everything needed to implement a feature, including tasks, files touched, tests, docs, and validation steps to ensure a smooth build.

Core Features & Use Cases

  • Decomposition guidance: breaks a spec into concrete tasks with precise file paths, expected changes, and test coverage.
  • Context-rich planning: provides a clear, auditable blueprint that a junior engineer can follow and a reviewer can validate.
  • Use Case: when starting from a multi-step feature spec, generate bite-sized tasks that map to code, tests, docs, and commits.

Quick Start

Describe the project spec in one sentence and I will produce a complete, task-by-task implementation plan ready for execution.

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 project spec into an executable implementation plan?

An implementation plan decomposes a spec into bite-sized tasks that map directly to code, tests, docs, and commits. It provides a clear, auditable blueprint with precise file paths and validation steps that a junior engineer can follow and a reviewer can validate.

What is the best way to break down a multi-step feature spec for developers?

Task decomposition works by breaking a spec into concrete tasks with precise file paths, expected changes, and test coverage. It delivers a context-rich Markdown plan with per-task steps, test instructions, and explicit validation requirements to guide implementation.

Can I generate a plan with exact file paths and test instructions from a spec?

Yes, generating a plan with exact file paths and test instructions is the core function. It applies to brainstorming contexts where a spec exists, producing a comprehensive Markdown plan with per-task steps, exact file paths, test and commit instructions, and explicit validation requirements.

Does implementation planning work for brainstorming contexts where a spec exists?

Yes, implementation planning applies directly to brainstorming contexts where a spec exists. It produces a comprehensive, executable implementation plan with bite-sized tasks that map to code, tests, docs, and commits, ensuring a smooth build process.

Are there limitations when decomposing complex project specs into task plans?

The primary limitation is that a project spec must already exist before decomposition can occur. The skill automates turning specs into plans, so without an initial spec, it cannot generate the per-task steps, file paths, and test instructions needed for implementation.