writing-plans

Translate product specifications into step-by-step implementation plans with files, tests, and commit messages.

6|Updated Mar 24, 2019
One-click install
npx skills add https://github.com/rafifos/dotfiles --skill writing-plans-rafifos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/rafifos/dotfiles/tree/main/dot_agents/skills/writing-plans
Command: npx skills add https://github.com/rafifos/dotfiles --skill writing-plans-rafifos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers and teams transform a spec or requirements into a comprehensive, implementation-ready plan before touching code, reducing ambiguity and rework.

Core Features & Use Cases

  • Structured task decomposition: translate a high-level spec into granular tasks with clear ownership and dependencies.
  • Plan artifacts: specify which files to touch, how to test, and where docs live, in a reusable plan document.
  • Guided workflow: follows a pragmatic, TDD-aligned workflow with bite-sized steps and versioned commits.
  • Use Case: teams drafting project plans, brainstorming features, or onboarding new engineers.

Quick Start

Begin by outlining a complete implementation plan in a dedicated worktree, covering files, tests, and milestones.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I translate software requirements into an implementation plan?

Translating software requirements into an implementation plan involves decomposing a high-level spec into granular tasks. This skill structures those tasks by detailing required files, tests, documentation, and verification steps into a Markdown document.

What is the best way to structure an implementation plan for a multi-task feature?

The best way to structure an implementation plan for a multi-task feature is to specify which files to touch, how to test, and where docs live. A robust plan includes explicit commit messages and adheres to TDD, DRY, and YAGNI best practices.

How do I break down a complex feature spec into tasks for engineers?

Breaking down a complex feature spec into tasks requires structured task decomposition. This process translates a high-level product specification into granular, implementation-ready steps with clear ownership and dependencies.

Does writing implementation plans require adherence to specific development workflows?

Writing implementation plans requires adherence to a pragmatic, TDD-aligned workflow. This approach ensures the plan remains robust to typical edge cases and provides bite-sized steps with versioned commits.

Why should I create an implementation plan before touching code?

Creating an implementation plan before touching code reduces ambiguity and rework. It transforms a spec into a comprehensive, implementation-ready document that an engineer can follow without additional context.

Can I use task decomposition plans for onboarding new engineers?

Task decomposition plans can be used for onboarding new engineers. The structured workflow and reusable plan documents provide clear guidance on project milestones, files to modify, and testing requirements.