writing-plans

Generate detailed implementation plans with file changes, code snippets, tests, and commit messages.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sharkitect-solutions/sharkitect-claude-toolkit --skill writing-plans-sharkitect-solutions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/sharkitect-solutions/sharkitect-claude-toolkit/tree/main/core/writing-plans
Command: npx skills add https://github.com/sharkitect-solutions/sharkitect-claude-toolkit --skill writing-plans-sharkitect-solutions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating clear, actionable, and comprehensive implementation plans for software development tasks, ensuring engineers have all necessary context and instructions.

Core Features & Use Cases

  • Structured Plan Generation: Creates detailed, step-by-step plans for multi-step tasks.
  • Contextualization: Assumes zero prior knowledge of the codebase or problem domain for the implementer.
  • Best Practice Enforcement: Incorporates principles like DRY, YAGNI, TDD, and frequent commits.
  • Use Case: Before starting a new feature, use this skill to generate a plan that outlines every file to touch, the exact code snippets, testing procedures, and commit messages.

Quick Start

Use the writing-plans skill to create an implementation plan for the new user authentication feature.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I create a detailed implementation plan for a software development task?

To create a detailed implementation plan, you need to outline file modifications, code snippets, testing steps, and commit messages. This skill generates bite-sized, step-by-step plans ensuring developers have all necessary context without prior codebase knowledge.

What's the best way to document software implementation steps for parallel session execution?

The best way to document implementation steps is to generate bite-sized plans with exact file modifications, code snippets, and testing procedures. This approach defines a clear handoff for plan execution through parallel sessions or subagent-driven development.

How do I write an implementation plan that ensures a developer needs zero prior context?

Writing an implementation plan with zero prior context requires detailing every file to touch, exact code snippets, and testing procedures. The plan assumes no prior knowledge of the codebase, ensuring clarity by providing comprehensive instructions for the implementer.

Can I include specific commit messages and testing steps in my code generation plan?

Yes, you can include specific commit messages and testing steps in your plan. The generated implementation plans outline every file to touch, exact code snippets, testing procedures, and frequent commit messages to ensure structured development.

Does this implementation planning approach work with TDD and DRY principles?

Yes, this implementation planning approach works with TDD and DRY principles. The generated plans explicitly adhere to Test-Driven Development, Don't Repeat Yourself, and YAGNI principles to ensure structured and maintainable software development.

When should I not use a detailed implementation plan for software development?

You should not use a detailed implementation plan for trivial software development tasks that do not require multi-step instructions. The plans are designed for complex multi-step tasks requiring file modifications, code snippets, and defined testing steps.