writing-plans

Generate bite-sized TDD implementation plans from a spec into plan.md.

4|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Mrlyk/superharness --skill writing-plans-mrlyk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/Mrlyk/superharness/tree/main/skills/writing-plans
Command: npx skills add https://github.com/Mrlyk/superharness --skill writing-plans-mrlyk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Writing Plans skill helps engineers convert a spec or requirements into concrete, bite-sized implementation tasks, ensuring every necessary step is documented before coding begins.

Core Features & Use Cases

  • Generates a comprehensive task decomposition that maps to specific files, tests, and documentation.
  • Enforces TDD-driven workflow with clear, 2-5 minute steps and explicit commit points.
  • Useful for projects with unclear or high-ambiguity specs, enabling rapid, repeatable planning.

Quick Start

Summarize the spec into bite-sized, TDD-ready tasks and save the plan to .superharness/tasks/{MM}-{DD}-{name}/plan.md.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I decompose a software spec into TDD-ready implementation steps?

Decomposing a software spec into TDD-ready steps involves generating bite-sized tasks mapping to specific files and tests. This skill creates a plan.md with 2-5 minute steps, explicit commit points, and testing guidance saved to .superharness/tasks/.

What is the best way to create a task decomposition plan for high-ambiguity specs?

The best way to create task decomposition for high-ambiguity specs is converting requirements into concrete, documented tasks before coding. This approach enforces a TDD-driven workflow with clear modification guidance, testing steps, and commit-ready milestones.

How to generate an implementation plan with explicit commit points and testing steps?

Generating an implementation plan with explicit commit points requires breaking specs into 2-5 minute actionable steps. The output plan.md documents specific file modifications, maps testing procedures, and defines commit-ready milestones for repeatable TDD workflows.

Can I use this task planning workflow for projects with unclear requirements?

Yes, you can use this task planning workflow for projects with unclear requirements. It enables rapid, repeatable planning by summarizing ambiguous specs into bite-sized, TDD-ready tasks with comprehensive documentation mapping.

Does this planning approach require any specific dependencies or environment setup?

No, this planning approach requires no external dependencies or components. It operates standalone to produce a plan.md file saved directly to the .superharness/tasks/{MM}-{DD}-{name}/ directory structure.

Why does my TDD workflow need bite-sized task decomposition before coding begins?

Your TDD workflow needs bite-sized task decomposition to ensure every necessary step is documented before coding begins. It maps tasks to specific files, tests, and documentation, reducing ambiguity and enforcing a repeatable 2-5 minute step workflow.