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.