writing-plans

Converts a spec or requirements into a detailed implementation plan with tasks, files, tests, and commits.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill writing-plans-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/MINT-IA/MINT --skill writing-plans-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When starting a multi-step task, teams often struggle to convert a spec into actionable steps, required files, tests, and a release plan. This skill ensures a complete, organized plan before touching code.

Core Features & Use Cases

  • Converts a spec into a detailed implementation plan with task boundaries, required files, tests, and commits.
  • Guides engineers through design and planning activities (DRY, YAGNI, TDD) before coding.
  • Useful for onboarding, project scoping, and ensuring repeatable planning for future features.

Quick Start

Create a new plan document in docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md that outlines tasks, involved files, testing strategy, and commit steps.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I translate a project spec into an actionable implementation plan?

To translate a spec into an implementation plan, you map requirements to precise task boundaries, required files, testing strategies, and version-control steps. This ensures organized, repeatable planning for multi-subsystem projects before touching code.

What is the best way to break down complex engineering workflows into coding tasks?

Breaking down complex engineering workflows involves applying design principles like DRY, YAGNI, and TDD to decompose requirements. This process specifies exact task boundaries, file modifications, and commit history for reliable execution.

How do I structure implementation plans for multi-subsystem projects?

Structuring implementation plans for multi-subsystem projects requires defining clear task boundaries, file mappings, documentation, and commit steps. This organized plan prevents scope creep and ensures reliable execution across interconnected subsystems.

When do I need a detailed implementation plan before starting version-control commits?

You need a detailed implementation plan before version-control commits when handling multi-step tasks or complex workflows. It ensures required files, testing, and commit history are specified upfront to avoid disorganized code changes.

How do I create a planning document for project scoping and onboarding?

To create a planning document for project scoping, outline tasks, involved files, testing strategy, and commit steps in a structured markdown file. This ensures repeatable planning and smooth engineer onboarding for future features.