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.