writing-plans

Generate implementation plans with TDD steps, commands, and saved file paths.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/thiansit/LuPang --skill writing-plans-thiansit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/thiansit/LuPang/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/thiansit/LuPang --skill writing-plans-thiansit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The writing-plans skill transforms vague specs or requirements into concrete, test-driven, bite-sized engineering tasks so developers can implement features with minimal ramp-up time and without prior knowledge of the codebase.

Core Features & Use Cases

  • Structured Implementation Plans: Produces a document with a required header, architecture summary, tech stack, and explicit tasks broken into 2-5 minute actionable steps.
  • TDD-first Task Breakdown: Each task contains exact file paths, failing-test examples, minimal implementation snippets, run commands with expected outcomes, and commit instructions.
  • Execution Handoff & Storage: Instructs how to save plans under docs/plans/YYYY-MM-DD-<feature-name>.md and offers execution modes (subagent-driven or parallel session) to hand off follow-up work.

Quick Start

Create an implementation plan for adding feature X that includes failing tests, exact file changes, test commands, expected results, and commit messages and save it to docs/plans/YYYY-MM-DD-feature-x.md.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn a software specification into a test-driven implementation plan?

To turn a software specification into a test-driven implementation plan, you provide the feature requirements to generate a structured document. The output includes architecture summaries, file-specific actions, failing-test examples, and exact run commands for step-by-step execution.

What is the best way to break down engineering tasks for developers lacking project context?

The best way to break down engineering tasks for developers lacking project context is generating bite-sized, 2-5 minute actionable steps. Each step contains explicit file paths, minimal implementation snippets, expected test outcomes, and commit instructions to minimize ramp-up time.

How do I generate TDD-style task breakdowns with exact commands and expected outputs?

You generate TDD-style task breakdowns by processing specifications into tasks that pair failing-test examples with minimal implementation snippets. The plan details exact run commands alongside their expected outputs and provides commit guidance for each incremental step.

Can I hand off implementation plan execution to subagents or parallel sessions?

Yes, you can hand off implementation plan execution to subagents or parallel sessions. The generated plan file includes explicit execution modes designed to distribute follow-up work directly to automated agents or separate developer worktrees without further manual task breakdown.

Where should generated implementation plan files be saved for developer onboarding?

Generated implementation plan files should be saved under the docs/plans/ directory using a YYYY-MM-DD-<feature-name>.md naming convention. This standardized storage path ensures new developers can easily locate and execute structured onboarding tasks.

Does writing-plans work for software refactors and documentation or only new features?

Writing-plans works for software refactors, tests, and documentation, not just new features. It applies to any multi-step engineering task requiring step-by-step preparation, transforming vague specs into structured, test-driven implementation plans for engineers.