writing-plans

Generate comprehensive implementation plans from a spec for software teams.

1|1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/shmily1012/AutoWriter --skill writing-plans-shmily1012
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/shmily1012/AutoWriter/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/shmily1012/AutoWriter --skill writing-plans-shmily1012

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers translate a high-level spec into a complete, executable plan by detailing which files to touch, what code changes are needed, testing steps, and documentation requirements, so teams can start coding with a shared roadmap.

Core Features & Use Cases

  • Plan decomposition: map complex specs into bite-sized tasks with clear boundaries.
  • Best-practice guidance: enforce DRY, YAGNI, and TDD principles to keep plans concise and testable.
  • Contextual planning: assume zero context about the codebase and document discovery steps, ownership, and deliverables.
  • Plan artifacts: produce a plan document with a header, task structure, and traceable checkpoints for execution handoff.
  • Execution handoff: support a transition to implementation with review loops and handover artifacts.

Quick Start

Invoke the writing-plans skill to generate a complete implementation plan for a given 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 a software specification into an actionable implementation plan?

An implementation plan translates a high-level spec into executable tasks by mapping file structure, code changes, testing steps, and documentation requirements. This creates a shared roadmap for engineering teams to start coding with clear ownership boundaries.

How do I decompose complex feature specs into bite-sized development tasks?

Task decomposition maps complex specs into bite-sized tasks with clear boundaries by applying DRY, YAGNI, and TDD principles. This structured planning enforces repeatable checkpoints and produces a plan document with a header and task-level steps for execution handoff.

What is the best way to enforce TDD principles when planning software engineering work?

The best way to enforce TDD principles in implementation planning is to generate plan documents that explicitly detail testing steps and traceable checkpoints for each task. This ensures testable, concise plans that align with multi-step software development workflows.

Does implementation planning work for multi-step features requiring zero codebase context?

Yes, implementation planning works for multi-step features by assuming zero codebase context and documenting discovery steps, ownership, and deliverables. This approach ensures comprehensive coverage of file structures, task breakdowns, and documentation across engineering teams.

Why do I need a plan-review loop before starting implementation handoff?

A plan-review loop is needed before implementation handoff to validate that the plan document contains accurate task breakdowns, traceable checkpoints, and clear ownership. This review ensures teams can transition to coding with a repeatable, shared roadmap.

Can I generate a plan document that details which files to touch and what code changes are needed?

Yes, you can generate a comprehensive plan document that explicitly details which files to touch, what code changes are needed, and documentation requirements. This artifact includes a plan header, task-level steps, and execution handoff deliverables.