writing-plans

Generate task-level implementation plans from specs with file references and testing steps.

12|9|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/jnealey88/designsetgo --skill writing-plans-jnealey88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/jnealey88/designsetgo/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/jnealey88/designsetgo --skill writing-plans-jnealey88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts scattered specs or requirements into a complete, executable implementation plan that guides engineers step-by-step from ideation to delivery.

Core Features & Use Cases

  • Generates detailed, bite-sized tasks covering files, tests, docs, and commits.
  • Encourages DRY, YAGNI, and TDD principles.
  • Supports planning in a dedicated worktree with automated plan saving to docs/plans.
  • Provides a consistent plan structure that can be executed by subagents or via executing-plans workflow.

Quick Start

Run this skill in a dedicated worktree to generate a complete implementation plan and save it to docs/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn a software feature spec into an actionable implementation plan?

A standardized implementation plan breaks specs into bite-sized tasks covering files, tests, docs, and commits. It sequences tasks explicitly, provides file touchpoints, and ensures reproducible handoff to execution and testing phases.

What is the best way to break down software requirements into developer tasks?

Effective task breakdown generates bite-sized developer tasks covering files, tests, docs, and commits. It encourages DRY, YAGNI, and TDD principles while providing clear task sequencing and explicit file references for execution.

Does an implementation plan generated from a spec include testing and documentation steps?

Yes, the implementation plan includes testing guidance and documentation steps alongside file touchpoints and commits. It generates bite-sized tasks covering tests, docs, and files while encouraging TDD principles for comprehensive delivery.

Can I use a generated implementation plan for automated execution by subagents?

Yes, the standardized plan structure supports reproducible handoff to subagents or executing-plans workflows. It provides clear task sequencing and explicit file references necessary for automated execution by subagents.

Where should I save implementation plans generated from feature specs?

Implementation plans are saved to docs/plans/YYYY-MM-DD-<feature-name>.md. Running the planning process in a dedicated worktree ensures the plan is automatically saved to this standardized directory structure.

When do I need a task-level breakdown for a new software feature?

A task-level breakdown is needed when starting a new feature with limited context. It provides a standardized plan structure with explicit file references, evaluation steps, and reproducible handoff to execution, testing, and documentation phases.