writing-plans

Generate implementation-ready plans with files, tests, and documentation steps.

1|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/pantheon-org/opencode-plugins --skill writing-plans-pantheon-org
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/pantheon-org/opencode-plugins/tree/main/.opencode/skills/writing-plans
Command: npx skills add https://github.com/pantheon-org/opencode-plugins --skill writing-plans-pantheon-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, comprehensive plan for implementing complex tasks before touching code. It helps engineers outline files to touch, tests, docs, and milestones, ensuring alignment and minimizing wasted work.

Core Features & Use Cases

  • Structured implementation plans: outlines tasks, files, tests, and documentation before coding.
  • Brainstorming in a dedicated worktree: encourages thorough preparation and traceable commits.
  • Supports TDD and incremental delivery with bite-sized tasks.
  • Use Case: Given a feature spec, generate an actionable plan pinned to docs/plans/YYYY-MM-DD-<feature-name>.md.

Quick Start

Use the writing-plans skill to create an implementation plan and save it to docs/plans/YYYY-MM-DD-writing-plans.md. Then review before starting development.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I create an implementation plan for a multi-step software feature?▼

To create an implementation plan, provide a feature spec to generate a structured document outlining files to touch, tests to write, and documentation to review. The plan is saved as a markdown file for review before coding.

What is the best way to structure tasks for test-driven development workflows?▼

Structuring tasks for TDD workflows involves breaking feature specs into actionable, bite-sized steps that define files to create, tests to write, and documentation to review. This approach enforces a deterministic, incremental delivery process.

Does this planning approach support incremental delivery and milestones?▼

Yes, this planning approach supports incremental delivery by breaking complex requirements into bite-sized tasks with defined milestones. It ensures alignment across iterations by structuring tests and documentation before coding begins.

How do I document files to modify and tests to write before starting development?▼

You document files and tests by generating a concrete implementation plan that specifies files to create or modify, tests to write, and docs to review. The plan is pinned to a markdown file in your docs directory for traceable commits.

Can I use this plan generation method in a dedicated git worktree?▼

Yes, you can use this method in a dedicated git worktree to encourage thorough preparation and traceable commits. The generated plan provides a structured roadmap for implementation before you start modifying code.

When do I need a structured implementation plan for software engineering tasks?▼

You need a structured implementation plan when tackling complex, multi-step tasks before touching code. It helps outline files, tests, docs, and milestones, ensuring alignment and minimizing wasted work during development.