writing-plans

Generate step-by-step implementation plans for multi-task specifications.

Updated Jul 8, 2022
One-click install
npx skills add https://github.com/limaon/dotfiles --skill writing-plans-limaon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/limaon/dotfiles/tree/main/.config/opencode/skills/writing-plans
Command: npx skills add https://github.com/limaon/dotfiles --skill writing-plans-limaon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams plan complex tasks by producing thorough implementation plans before coding.

Core Features & Use Cases

  • Structured task breakdown with explicit files to touch, tests to write, and documentation to check.
  • DRY, YAGNI, and TDD guidance to keep plans minimal yet thorough.
  • Save plans to a versioned location to enable sharing and traceability, e.g., docs/plans/YYYY-MM-DD-<feature-name>.md

Quick Start

Announce at the start: "I'm using the writing-plans skill to create the implementation plan." Then describe the feature and let the plan outline all tasks, files, tests, and docs to produce. Save the plan 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 create a step-by-step implementation plan from a software specification?

To create an implementation plan, break down the specification into structured tasks that explicitly list files to touch, tests to write, and documentation to check. This ensures a complete map of the work is established before coding begins.

What is the best way to plan complex programming tasks using TDD principles?

The best way to plan complex tasks with TDD is to enforce DRY, YAGNI, and TDD guidance during the task breakdown phase. This keeps the plan minimal yet thorough by explicitly defining required tests before implementation starts.

How do I generate a task breakdown that tracks all touched files and required tests?

Generate a task breakdown by mapping each specification requirement to explicit files to modify and tests to write. This structured breakdown provides a comprehensive map of touched files and documentation needs for the entire project.

How should I save and share implementation plans for versioning and traceability?

Save implementation plans to a versioned directory like docs/plans using a date-stamped filename, such as YYYY-MM-DD-<feature-name>.md. This enables team sharing and provides clear traceability for project requirements.

Do I need a detailed spec or requirements document before planning complex software tasks?

Yes, you need a spec or requirements document before planning complex tasks. This skill applies to projects where engineers already have requirements and need a complete map of touched files, tests, and documentation generated from that baseline.

Can I use this structured planning approach for multi-task projects without external dependencies?

Yes, you can use this structured planning approach for multi-task projects without external dependencies. It operates independently to produce comprehensive, step-by-step implementation plans directly from your project specifications.