write-plans

Convert approved designs into task-by-task plans with file touches, tests, and documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mengdehong/opencode-dotfiles --skill write-plans-mengdehong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-plans
Source: https://github.com/mengdehong/opencode-dotfiles/tree/main/skills/write-plans
Command: npx skills add https://github.com/mengdehong/opencode-dotfiles --skill write-plans-mengdehong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams translate approved designs, specs, or requirements into clear, executable task plans, reducing ambiguity and enabling faster handoff from design to development.

Core Features & Use Cases

  • Design-to-plan mapping: converts a design or requirements document into a structured task list with owners, milestones, and acceptance criteria.
  • Task decomposition: breaks work into manageable steps with explicit file touches, tests, and documentation.
  • Use Case: when a project involves multiple subsystems, generates independent, deployable task sets that align with the overall design.

Quick Start

Provide an approved design or requirements, and this skill will generate a complete task-by-task execution plan saved to changes/<change-id>/tasks.md.

Frequently Asked Questions about write-plans

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

FAQPage Schema
How do I convert an approved design document into an actionable execution plan?

To convert an approved design into an execution plan, provide the design or requirements document to generate a structured task list. This process maps the design into manageable steps with explicit file touches, tests, documentation, and commit-ready actions.

What is task decomposition for multi-step engineering changes?

Task decomposition for multi-step changes is the process of breaking down approved designs into independent, deployable task sets. It structures work into manageable steps with owners, milestones, acceptance criteria, and specific file modifications.

How do I generate a task plan that includes file touches, tests, and documentation steps?

You can generate a task plan with file touches, tests, and documentation by submitting your approved requirements. The output produces a detailed plan document saved to changes/<change-id>/tasks.md, containing structured steps for engineering execution.

Can I use this task decomposition approach for projects involving multiple subsystems?

Yes, task decomposition applies to projects involving multiple subsystems by generating independent, deployable task sets that align with the overall design. This ensures each subsystem receives explicit steps for tests, documentation, and file modifications.

What is the best way to transition from design specs to development handoff without ambiguity?

The best way to transition from design specs to development handoff is converting approved requirements into clear, executable task plans. This reduces ambiguity by defining explicit file touches, acceptance criteria, and commit-ready steps for faster engineering execution.

Do I need an approved design or requirements document before generating an execution plan?

Yes, you need an approved design or requirements document to generate an execution plan. The skill translates existing specifications into actionable task-by-task plans, requiring completed design inputs to produce accurate file touches and acceptance criteria.