writing-plans

Generate design-focused implementation plans with defined interfaces and validation rules.

8|1|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/HumanBean17/jrag --skill writing-plans-humanbean17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/HumanBean17/jrag/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/HumanBean17/jrag --skill writing-plans-humanbean17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of disorganized or incomplete development by forcing a structured, design-first approach that ensures every task is testable, self-contained, and clear to any engineer.

Core Features & Use Cases

  • Task Decomposition: Breaks complex features into bite-sized, independently testable units of work.
  • Contract-Driven Design: Defines exact interfaces, data shapes, and expected test outcomes before a single line of implementation code is written.
  • Use Case: When starting a new microservice feature, use this skill to generate a comprehensive plan that maps out file changes, interface contracts, and specific test scenarios, ensuring the implementation phase is predictable and error-free.

Quick Start

Use the writing-plans skill to generate a detailed implementation plan for the new authentication module based on the provided requirements.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I decompose complex software features into testable units?

Implementation plans decompose complex software features by breaking them down into granular, independently testable units with defined interfaces and validation rules. This ensures every task is self-contained and clear to any engineer.

What is design-first software planning and when do I need it?

Design-first software planning enforces a strict separation between architectural design and implementation logic before coding begins. You need it to prevent disorganized development and ensure code quality, testability, and maintainability.

How do I define interface contracts and data shapes before writing implementation code?

You define interface contracts by specifying exact data shapes and expected test outcomes during the task decomposition phase. This contract-driven design ensures implementation logic remains predictable and error-free.

Can I use task decomposition for microservice architecture features?

Yes, task decomposition works for microservice architecture features by mapping out required file changes, interface contracts, and specific test scenarios. This makes the implementation phase predictable for new modules.

Does this planning approach integrate with test-driven development?

Yes, this planning approach integrates with test-driven development by defining expected test outcomes and validation rules before implementation begins. It structures tasks as independently testable units to support TDD workflows.

Why should I separate architectural design from implementation logic?

Separating architectural design from implementation logic ensures code quality and maintainability by forcing a structured approach. It prevents incomplete development by guaranteeing every task is testable and self-contained.