writing-plans

Transform software requirements into actionable implementation plans with file-level changes.

15|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/mahoushoujyo-eee/eshell --skill writing-plans-mahoushoujyo-eee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/mahoushoujyo-eee/eshell/tree/main/.codex/skills/writing-plans
Command: npx skills add https://github.com/mahoushoujyo-eee/eshell --skill writing-plans-mahoushoujyo-eee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms software specifications and multi-step requirements into clear, implementation-ready plans, reducing ambiguity and preventing engineers from getting stuck during development.

Core Features & Use Cases

  • Codebase Decomposition: Maps the files, responsibilities, interfaces, tests, and documentation affected by a feature before implementation begins.
  • Bite-Sized Task Planning: Breaks work into independently actionable steps with exact paths, commands, expected results, test-first guidance, and commit points.
  • Plan Quality Review: Checks specification coverage, placeholder-free instructions, type and interface consistency, and execution handoff options.
  • Use Case: Use it to turn a feature specification for a new application workflow into a test-driven plan that another engineer can execute with minimal repository context.

Quick Start

Use the writing-plans skill to analyze the provided requirements and save a complete implementation plan to the appropriate plans directory.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn software requirements into an actionable implementation plan?

To turn software requirements into an implementation plan, you map affected files, interfaces, and tests, then decompose the work into bite-sized, test-driven steps with exact paths, validation commands, and commit points.

What is codebase decomposition for task planning?

Codebase decomposition for task planning maps the specific files, responsibilities, interfaces, and tests affected by a feature before implementation begins, ensuring engineers have clear boundaries and concrete execution details.

How do I break down a multi-step engineering task into test-driven steps?

Break down multi-step engineering tasks by planning independent, bite-sized actions that specify exact file paths, expected results, test-first guidance, and commit points to ensure another engineer can execute the work with minimal context.

Can I use this to generate a plan for another engineer to execute?

Yes, you can generate a plan for another engineer to execute by ensuring the output is placeholder-free, covers specification requirements, checks type and interface consistency, and provides explicit execution handoff options.

What is the best way to validate specification coverage before coding?

The best way to validate specification coverage is to run a plan quality review that checks for placeholder-free instructions, type and interface consistency, and explicit execution handoff options before passing the plan to implementation.

When should I not use a structured implementation plan?

You should not use a structured implementation plan for single-step tasks lacking explicit boundaries, or when a feature requires no codebase decomposition, test planning, or file-level changes.