writing-plans

Generates step-by-step implementation plans for multi-step software tasks with TDD, DRY, YAGNI adherence.

1|Updated May 25, 2025
One-click install
npx skills add https://github.com/circld/dotfiles --skill writing-plans-circld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/circld/dotfiles/tree/main/external/opencode/skills/writing-plans
Command: npx skills add https://github.com/circld/dotfiles --skill writing-plans-circld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps engineers create detailed, step-by-step implementation plans for complex tasks, ensuring clarity and reducing the need for extensive context transfer.

Core Features & Use Cases

  • Structured Planning: Generates plans with bite-sized tasks, including specific file modifications, test writing, and commit messages.
  • Contextual Guidance: Assumes minimal prior knowledge of the codebase or problem domain for the implementer.
  • Use Case: Before starting a new feature, use this Skill to generate a comprehensive plan that guides another developer through the entire implementation process, from writing failing tests to final commits.

Quick Start

Use the writing-plans skill to generate an implementation plan for adding a new user authentication module.

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 detailed implementation plan for a multi-step software development task?

To create a detailed implementation plan, generate step-by-step tasks providing exact file paths, code snippets for tests and implementations, and precise commands for verification and commits.

What is the best way to break down a complex feature into bite-sized coding tasks?

The best way to break down tasks is to structure the implementation plan with specific file modifications, test writing steps, and commit messages, ensuring adherence to TDD, DRY, and YAGNI principles.

How does test-driven development planning work for new software features?

Test-driven development planning works by guiding developers through the entire implementation process, starting from writing failing tests to final commits, while assuming minimal prior knowledge of the codebase.

Can I use this approach to generate a plan for a developer with minimal codebase knowledge?

Yes, you can use this planning approach because it provides contextual guidance and assumes minimal prior knowledge of the codebase or problem domain for the implementer executing the tasks.

What are the limitations of using automated task breakdown for software development?

A limitation of automated task breakdown is that it requires clear initial requirements to be effective, as it focuses on generating precise file modifications and test snippets rather than discovering project scope.

Does writing-plans support generating commit messages and verification commands?

Yes, writing-plans supports generating commit messages and verification commands by providing precise commands for commits and exact code snippets for tests and implementations during task execution.