skill-writing-plans

Decomposes approved specifications into executable multi-step implementation plans with task contracts.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/longdang193/project-OS-starter --skill skill-writing-plans-longdang193
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writing-plans
Source: https://github.com/longdang193/project-OS-starter/tree/main/generated_agents/claude/skills/skill-writing-plans
Command: npx skills add https://github.com/longdang193/project-OS-starter --skill skill-writing-plans-longdang193

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an approved specification into work that engineers or agents can execute often fails because plans invent design, leave placeholders, or skip verification. This Skill converts approved scope into an ordered, dependency-aware implementation plan with exact files, symbols, commands, and exit criteria so execution requires no further design decisions. ## Core Features & Use Cases - Implementation Decomposition: Maps every spec requirement to bounded tasks with dependency order, execution approach (inline sequential, subagent-ready, or parallel-capable), and coordination mode (none or git-tracked). - Task Contracts: Writes per-task contracts covering purpose, required skills, files and symbols, dependencies, authority, steps, verification, and exit criteria, with executor and template profile resolution rules. - Verification Design: Defines task-local and final proof strategies, including regression, backend boundary, performance, and rollback evidence, plus a one-pass self-review for spec coverage and placeholder removal. - Use Case: After a specification for a cross-boundary feature is approved, use this Skill to produce a canonical plan at docs/superpowers/plans/ with ordered tasks, shared-write ownership, and proof commands ready for handoff to execution. ## Quick Start Use the skill-writing-plans skill to turn the approved specification into an executable implementation plan with ordered tasks and verification steps.

Frequently Asked Questions about skill-writing-plans

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

FAQPage Schema
How do I write an implementation plan from a specification?▼

Confirm the approved scope, re-read the specification to map every requirement, reconcile it against actual repository files and symbols, then define outcomes, choose an execution approach, order tasks by dependency, and write task contracts with verification and exit criteria.

When should I create an implementation plan versus coding directly?▼

Create a plan when work needs several ordered edits, spans multiple maintained surfaces, carries migration or rollback risk, or needs a durable handoff. Skip planning for local, reversible, design-clear changes whose files, edit, and proof are already obvious.

What should each task in an implementation plan include?▼

Each task needs purpose, task function, template profile, specification coverage, required skills, exact files and symbols, dependencies, authority with stop conditions, executable steps, verification, and exit criteria. Tasks must name concrete paths and commands, never placeholders.

How do I choose between sequential and parallel task execution?▼

Use inline sequential as the default with one executor owning ordered tasks. Choose subagent-ready when tasks have clear independent ownership, and parallel-capable only when lanes have disjoint write sets with no hidden ordering dependencies.

What are the limitations of plan-driven development?▼

A plan cannot resolve unapproved behavioral decisions; unresolved behavior, interfaces, or acceptance criteria must go back to specification drafting first. Plans also do not own implementation, final completion claims, or Git disposition, which belong to execution and verification skills.