writing-plans

Generate structured implementation plans with files, tests, and commit history.

Updated Apr 16, 2014
One-click install
npx skills add https://github.com/minhhh/dotfiles --skill writing-plans-minhhh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/minhhh/dotfiles/tree/main/ai/.ai/gemini-superpowers/skills/writing-plans
Command: npx skills add https://github.com/minhhh/dotfiles --skill writing-plans-minhhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide comprehensive implementation planning to bridge knowledge gaps before coding, ensuring every stakeholder understands tasks, files, tests, and milestones.

Core Features & Use Cases

  • Bite-sized task granularity with explicit steps, tests, and commit history.
  • Standardized plan document header and execution handoff for predictable delivery.
  • Works in a dedicated worktree and supports a test-driven development workflow.

Quick Start

Provide the feature name and constraints to generate a complete, executable implementation plan.

Frequently Asked Questions about writing-plans

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn software specifications into actionable implementation plans?

Implementation plans bridge knowledge gaps before coding by breaking specifications into bite-sized tasks with explicit steps, required file modifications, tests, and commit history. This ensures every stakeholder understands the required milestones and execution handoff for predictable delivery.

What is the best way to plan multi-step engineering tasks for test-driven development?

Test-driven development planning requires a comprehensive, structured plan document with a standardized header that enforces deterministic execution steps. It outlines specific tests to write and documentation to update before touching any code, ensuring thorough coverage across a dedicated worktree.

Does implementation planning work within a dedicated git worktree?

Yes, implementation planning supports a test-driven development workflow within a dedicated worktree. It generates standardized plan documents that track bite-sized tasks, explicit execution steps, and commit history to ensure isolated and predictable feature delivery.

How do I generate a complete plan for a feature without missing files or documentation?

To generate a complete plan, provide the feature name and constraints to produce a structured document detailing files to touch, tests to write, documentation to update, and commit history. This prevents missed requirements by enforcing a standardized header and bite-sized task granularity.

When should I write a comprehensive implementation plan instead of just starting to code?

You should write a comprehensive implementation plan for multi-step engineering tasks that require deterministic steps and thorough documentation. Planning before touching code bridges knowledge gaps, aligns stakeholders on milestones, and ensures predictable delivery through structured execution handoffs.