writing-plans

Translate implementation specifications into step-by-step TDD engineering plans.

35|5|Updated Sep 20, 2025
One-click install
npx skills add https://github.com/zhanglongxiao111/indesign-cli --skill writing-plans-zhanglongxiao111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/zhanglongxiao111/indesign-cli/tree/main/.codex/skills/writing-plans
Command: npx skills add https://github.com/zhanglongxiao111/indesign-cli --skill writing-plans-zhanglongxiao111

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing correct, actionable implementation plans is hard when you are starting from a spec and need to coordinate files, tests, and execution without wasting time on placeholders or guesswork.

Core Features & Use Cases

  • Spec-to-plan decomposition: Checks whether the spec spans independent subsystems and recommends splitting into separate plans so each produces working, testable software on its own.
  • File-structure driven task breakdown: Maps which exact paths will be created or modified and uses that to decide task boundaries and responsibilities.
  • Bite-sized TDD execution steps: Forces each task step to be an atomic action (2–5 minutes) with explicit failing tests, expected outcomes, implementation snippets, and commands to verify.
  • Deterministic plan documents: Requires a strict plan header format and a fully fill-in-complete workflow with no placeholders.

Quick Start

Use the writing-plans skill to create a step-by-step implementation plan for your feature spec before you start changing the codebase.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate an implementation plan from a feature spec before coding?

To generate an implementation plan from a feature spec, use this skill to translate specifications into actionable step-by-step engineering plans. It maps exact file paths and decomposes multi-step feature work into bite-sized TDD execution steps with expected outcomes.

What is task decomposition for test-driven development planning?

Task decomposition for test-driven development planning breaks down feature specs into atomic actions spanning two to five minutes. It enforces bite-sized TDD execution steps by defining explicit failing tests, expected outcomes, implementation snippets, and verification commands.

How do I break down multi-step feature work into atomic TDD execution steps?

You break down multi-step feature work by mapping exact file paths to be created or modified, which decides task boundaries. This file-structure driven approach produces deterministic plan documents containing minimal code blocks and run commands with no placeholders.

Does this implementation planning approach work for independent subsystems?

Yes, implementation planning works for independent subsystems by checking if the spec spans them and recommending splits into separate plans. This ensures each plan produces working, testable software on its own with clear boundaries for file edits and tests.

What is the best way to coordinate file edits, tests, and documentation before changing code?

The best way to coordinate file edits, tests, and documentation before coding is generating a buildable TDD-oriented plan. It requires a strict plan header format and a fully fill-in-complete workflow, ensuring the agent coordinates changes with clear boundaries.

When do I need an agentic workflow for developer documentation and test planning?

You need an agentic workflow for developer documentation and test planning when starting from a spec and code changes have not started yet. It applies to multi-step feature work where the agent must coordinate file edits and execution without wasting time on guesswork.