writing-plans

Create implementation plans with file paths, test templates, and commit steps.

2|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/marktantongco/promptc-os --skill writing-plans-marktantongco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/marktantongco/promptc-os/tree/main/skills/writing-plans
Command: npx skills add https://github.com/marktantongco/promptc-os --skill writing-plans-marktantongco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a written spec or requirements for a multi-step task into a complete, developer-ready implementation plan so engineers with no context can implement features reliably. It removes ambiguity about which files to change, what tests to write, and how to validate and commit each incremental step.

Core Features & Use Cases

  • Complete plan header that standardizes goal, architecture, and tech stack and instructs where to save the plan in docs/plans.
  • Bite-sized TDD steps with explicit failing-test templates, commands to run tests, minimal implementations, and exact commit instructions for each task.
  • Exact file and command guidance including create/modify file paths, test file locations, and expected command outputs to enable quick handoffs, contractor onboarding, and disciplined feature development.

Quick Start

Ask the skill to generate a complete implementation plan for a named feature from your spec and save it to docs/plans/YYYY-MM-DD-feature-name.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 feature spec into a test-driven implementation plan?

To turn a feature spec into a test-driven implementation plan, you provide the written requirements to generate bite-sized TDD steps. The output includes exact file paths, failing test templates, minimal implementations, and commit instructions saved to docs/plans/YYYY-MM-DD-<feature-name>.md.

What is the best way to break down multi-step engineering tasks for developers lacking context?

The best way to break down multi-step engineering tasks is by generating a standardized plan header and explicit step-by-step instructions. This approach removes ambiguity by detailing which files to change, what tests to write, and expected command outputs for quick handoffs.

How do I generate failing test templates and commit instructions for TDD workflow changes?

To generate failing test templates and commit instructions for TDD workflow changes, the plan output prescribes exact test file locations, commands to run tests, and minimal implementations for each incremental task. This ensures disciplined feature development and reliable validation.

Can I use this implementation plan approach for small-to-medium codebase tasks and contractor onboarding?

Yes, you can use this implementation plan approach for small-to-medium codebase tasks and contractor onboarding. It produces exact file and command guidance with expected outputs, enabling quick handoffs for engineers who have no prior context about the codebase.

Does the generated implementation plan include exact file paths and commands to run tests?

Yes, the generated implementation plan includes exact file paths and commands to run tests. It provides create/modify file locations, test file directories, expected command outputs, and explicit commit steps to validate each incremental change.

When do I need a prescribed plan header saved to docs/plans for feature development?

You need a prescribed plan header saved to docs/plans when starting feature development or TDD-driven changes. It standardizes the goal, architecture, and tech stack, ensuring engineers with no context can follow explicit step-by-step instructions reliably.