writing-plans

Generate structured implementation plans with tasks, files, and tests.

299|56|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/jd-opensource/JoySafeter --skill writing-plans-jd-opensource
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/jd-opensource/JoySafeter/tree/main/skills/writing-plans
Command: npx skills add https://github.com/jd-opensource/JoySafeter --skill writing-plans-jd-opensource

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams convert vague requirements into a structured, executable plan for multi-step software tasks, reducing ambiguity and accelerating delivery.

Core Features & Use Cases

  • Structured plan generation: translates specs into task-level steps with proposed file changes, tests, and documentation.
  • Multi-step task decomposition: breaks complex work into bite-sized tasks aligned with TDD and best practices.
  • Documentation and reproducibility: outputs plan artifacts suitable for version control and collaboration.
  • Use Case: When handed a new feature spec, the skill produces a ready-to-implement plan for engineers and QA.

Quick Start

Provide a high-level spec and I will generate a complete implementation plan with tasks, files, tests, and timelines.

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 specification into an actionable implementation plan?

To turn a feature specification into an actionable implementation plan, provide a high-level spec to generate structured, task-level steps with proposed file changes, tests, and documentation. It outputs a structured markdown file ready for execution.

What is the best way to break down multi-step software tasks for engineers?

The best way to break down multi-step software tasks is to decompose complex work into bite-sized tasks aligned with TDD, DRY, and YAGNI principles. This approach specifies exact files to touch, tests to write, and testing methods, assuming zero codebase context.

Does the generated implementation plan include test-driven development steps?

Yes, the generated implementation plan includes test-driven development steps. It ensures plans follow DRY, YAGNI, and TDD principles by specifying the exact tests to write and detailing how to test each bite-sized task for multi-step features.

Can I save task planning documentation directly to my repository?

Yes, you can save task planning documentation directly to your repository. The skill outputs plan artifacts as structured markdown files to the docs/plans/YYYY-MM-DD-<feature-name>.md path, suitable for version control and team collaboration.

When do I need a structured plan for multi-step tasks?

You need a structured plan for multi-step tasks when converting vague requirements into executable work for engineers and QA. It translates new feature specs into bite-sized, documented tasks to reduce ambiguity and accelerate delivery.