writing-plans

Generate step-by-step implementation plans from feature briefs for software projects.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/Suara17/guanlan-sina --skill writing-plans-suara17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/Suara17/guanlan-sina/tree/main/.opencode/skills/writing-plans
Command: npx skills add https://github.com/Suara17/guanlan-sina --skill writing-plans-suara17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly generate a complete, repeatable implementation plan for complex tasks before coding, ensuring alignment on scope, required files, tests, docs, and commits.

Core Features & Use Cases

  • Structured planning: produces a bite-sized task breakdown covering code, tests, docs, and commits.
  • DRY, YAGNI, TDD emphasis: guides teams to write minimal, testable steps.
  • Plan templating & saving: saves plans to docs/plans/YYYY-MM-DD-<feature-name>.md and includes a standard Plan Document Header.

Quick Start

Use the writing-plans skill to generate an implementation plan for a given feature and save it to the designated docs path. The plan should include the header, task sections, and explicit file paths and commands, following the exact structure shown in the Skill's example.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate a step-by-step implementation plan from a feature brief?

To generate an implementation plan from a feature brief, the skill outputs a structured document with a standard header, bite-sized task breakdown, explicit file paths, and commands. It targets software projects where a spec exists but code has not yet been written, ensuring pre-development alignment across engineers and stakeholders.

What is the best way to break down software development tasks before coding?

Breaking down software tasks before coding requires producing bite-sized task granularity that covers code, tests, docs, and commits. The skill enforces DRY, YAGNI, and TDD principles to guide teams toward writing minimal, testable steps, ensuring complete alignment on required files and scope.

How does task decomposition work for test-driven development planning?

Task decomposition for test-driven development planning works by enforcing DRY, YAGNI, and TDD emphasis to guide teams in writing minimal, testable steps. It automatically generates a complete, repeatable implementation plan that covers code, tests, docs, and commits, ensuring alignment on scope before any code is written.

Can I save generated implementation plans to a specific reproducible file path?

Yes, generated implementation plans can be saved to a reproducible file path. The skill automatically saves plans to docs/plans/YYYY-MM-DD-<feature-name>.md, including a standard Plan Document Header, task sections, and explicit file paths and commands following a specific structure.

Do I need an existing software specification to use this implementation plan generator?

Yes, you need an existing software specification. The skill specifically targets software projects where a spec exists but code has not yet been written, using the feature brief to enable pre-development alignment across engineers, testers, and stakeholders before generating the step-by-step plan.

Why should teams create implementation plans before writing code for complex features?

Creating implementation plans before writing code helps teams quickly generate a complete, repeatable plan for complex tasks. This ensures alignment on scope, required files, tests, docs, and commits, preventing miscommunication across engineers, testers, and stakeholders during the development process.