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.