writing-plans

Create detailed implementation plans with granular tasks and exact file paths.

14|1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/a-ariff/ariff-claude-plugins --skill writing-plans-a-ariff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/a-ariff/ariff-claude-plugins/tree/main/plugins/writing-plans/skills/writing-plans
Command: npx skills add https://github.com/a-ariff/ariff-claude-plugins --skill writing-plans-a-ariff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn designs into actionable implementation plans with granular tasks and runnable steps.

Core Features & Use Cases

  • Plan headers
  • Task granularity with steps
  • Tests and commits integration

Quick Start

Create a plan to implement a feature with 5 tasks.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I break down a feature design into implementation tasks?

Implementation planning transforms designs into granular tasks by scoping post-design work, defining architecture notes and tech stack, estimating task effort, and writing concrete steps with exact file paths, test commands, and environment details. This enables precise handoffs and reproducible execution.

What should be included in a detailed implementation plan?

A complete implementation plan contains a header, architecture notes, tech stack specification, estimated tasks with granular steps, exact file paths for changes, test integration points, commit markers, concrete commands to run, and environment requirements—everything needed for reproducible execution without additional context.

How do I create bite-sized tasks from a large feature?

Break features into bite-sized tasks by defining each task's scope, listing specific steps with file paths and commands, integrating tests at each step, marking commit boundaries, and specifying environment setup. This granularity ensures developers can execute each task independently and verify progress.

Can I use implementation plans to onboard developers faster?

Yes. Detailed implementation plans with exact file paths, concrete commands, test integration, and environment requirements guide developers who lack context, reducing onboarding time and enabling reproducible execution without requiring design knowledge or prior codebase familiarity.

What's the difference between a design document and an implementation plan?

A design outlines what to build and why; an implementation plan specifies how to build it. Plans add post-design, pre-code detail: estimated tasks, granular steps with exact file paths, concrete commands, test requirements, commits, and environment setup—the actionable bridge between design and execution.