superspec:plan

Generate plan.md and tasks.md from validated specs with test-first tasks.

3|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/HankLiu447/SuperSpec --skill superspec-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superspec:plan
Source: https://github.com/HankLiu447/SuperSpec/tree/main/skills/plan-writing
Command: npx skills add https://github.com/HankLiu447/SuperSpec --skill superspec-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of implementation plans for spec-driven development, ensuring teams translate validated specs into concrete, trackable work items.

Core Features & Use Cases

  • Plan generation from validated specs with explicit traceability to requirements and designs.
  • Enforces a bite-sized, test-first workflow (RED → GREEN → REFACTOR) for each task.
  • Generates a structured Plan Document (plan.md) and a companion tasks checklist (tasks.md) to guide execution and commits.

Quick Start

Announce at the start: "I'm using the plan-writing skill to create the implementation plan." Then generate plan and tasks according to the spec.

Frequently Asked Questions about superspec:plan

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

FAQPage Schema
How do I generate an implementation plan from a validated spec?

To generate an implementation plan from a validated spec, this Skill automates the creation of a structured plan.md and companion tasks.md. It converts validated specifications into bite-sized, test-first work items with clear traceability to design artifacts and requirements.

What is a test-first execution plan and how does it structure development tasks?

A test-first execution plan structures development tasks using a RED, GREEN, REFACTOR workflow for each item. This approach enforces bite-sized, test-driven development cycles and generates an auditable Run and Expected workflow integrated with execution processes.

How do I ensure traceability between my design artifacts and implementation tasks?

To ensure traceability between design artifacts and implementation tasks, the plan-driven generation process explicitly links every bite-sized work item back to the validated specs. This creates an auditable track connecting your requirements directly to the test-first execution plan.

Do I need validated specs before creating a test-first execution blueprint?

Yes, you need validated specs before creating a test-first execution blueprint. This Skill targets the specific development stage where teams must convert already validated specifications into concrete, trackable work items and structured plan documents.

What files are required for spec-based planning and task tracking?

Spec-based planning requires generating a Plan Document structure, typically named plan.md, alongside a companion tasks checklist named tasks.md. These files guide the test-first execution workflow and track commits according to the validated spec.

When should I not use an automated plan-writing approach for spec-driven development?

You should not use an automated plan-writing approach if your specifications are not yet validated or if your project does not require strict test-first, traceable task structures. It is specifically designed for converting validated specs into structured, auditable work items.