writing-plans

Generate task-level implementation plans with exact file paths and code samples.

4|1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/samjhecht/wrangler --skill writing-plans-samjhecht
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/samjhecht/wrangler/tree/main/skills/writing-plans
Command: npx skills add https://github.com/samjhecht/wrangler --skill writing-plans-samjhecht

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vague or incomplete implementation plans lead to confusion, rework, and delays, especially when executed by AI agents or engineers unfamiliar with the codebase.

Core Features & Use Cases

  • Bite-Sized Tasks: Creates comprehensive implementation plans broken down into small, actionable tasks (2-5 minutes each) for easy execution.
  • Exact Instructions: Includes precise file paths, complete code examples, exact commands, and expected outputs for every step, minimizing ambiguity.
  • Zero-Context Assumption: Assumes the executor has minimal domain knowledge, documenting everything needed for successful implementation.
  • Use Case: When a design is complete and you need to generate a detailed, actionable implementation plan for engineers or AI agents with minimal codebase context, ensuring smooth and accurate execution.

Quick Start

The design for the 'user-onboarding' feature is approved. Create a detailed implementation plan for it.

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 software feature?

Generate a comprehensive implementation plan by breaking the approved design into small, actionable tasks (2-5 minutes each) with exact file paths, complete code examples, precise commands with expected outputs, and acceptance criteria. This ensures engineers or AI agents can execute without ambiguity or rework.

What should a task-level implementation plan include?

A complete plan includes exact file paths, full code samples, testing steps, verification commands with expected outputs, five TDD steps, acceptance criteria, and cross-task references. This eliminates guesswork for executors unfamiliar with the codebase.

When should I use detailed implementation plans instead of high-level designs?

Use task-level plans when a design is complete and ready for execution by engineers or AI agents who have minimal codebase context. They prevent confusion, rework, and delays by documenting everything needed for accurate implementation.

Can implementation plans work with AI agent execution?

Yes. Plans designed with zero-context assumptions—exact file paths, complete code examples, precise commands, and expected outputs—enable AI agents to execute accurately without domain knowledge or codebase familiarity.

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

A design describes what to build and why; an implementation plan details how to build it step by step. Plans add executable specifics: file paths, code, commands, outputs, and MCP-tracked tasks that a design alone doesn't provide.

How do I structure tasks to be executable in 2-5 minutes?

Break the implementation into bite-sized tasks by isolating one logical unit per task: a single file modification, a test addition, or one command execution. Include all context—exact paths, complete code, expected results—so each task is self-contained and fast to execute.