writing-plans

Draft detailed implementation plans with file paths, code snippets, and verification steps.

42|2|Updated Mar 17, 2019
One-click install
npx skills add https://github.com/starwards/starwards --skill writing-plans-starwards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/starwards/starwards/tree/main/.claude/skills/writing-plans
Command: npx skills add https://github.com/starwards/starwards --skill writing-plans-starwards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vague or incomplete implementation instructions lead to confusion, rework, and delays, especially for engineers new to a codebase. This skill ensures the creation of highly detailed, actionable implementation plans that leave no room for ambiguity.

Core Features & Use Cases

  • Atomic Task Granularity: Breaks down features into 2-5 minute steps, including exact file paths, code snippets, and verification commands.
  • Comprehensive Documentation: Follows a mandatory structure with goal, architecture, tech stack, and detailed tasks for clarity.
  • Use Case: After a design phase, use this skill to generate a step-by-step guide for a complex feature, enabling any engineer to implement it efficiently and correctly, even with zero prior context.

Quick Start

"I have a new feature design. Help me write a detailed implementation plan for it."

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I write a detailed implementation plan for a software feature?

An implementation plan breaks down a feature design into atomic 2-5 minute tasks with exact file paths, code snippets, and verification commands. Start with your architecture and tech stack, then list each task with dependencies, edge cases, and commit messages so any engineer can execute it without ambiguity.

What should a detailed implementation plan include?

A complete plan contains goal, architecture, and tech stack as mandatory headers, followed by granular tasks specifying file locations, exact code examples, verification steps, required dependencies, edge cases, and documentation standards. This structure eliminates confusion and rework.

Can I use implementation plans for onboarding new engineers to a codebase?

Yes. Implementation plans are designed for engineers with zero prior context. They provide step-by-step guidance with exact file paths and code snippets, making them ideal for onboarding and reducing ramp-up time on complex features.

How granular should tasks be in an implementation plan?

Tasks should be atomic and completable in 2-5 minutes. Each task includes exact file paths, code snippets, verification commands, and commit messages. This granularity prevents ambiguity and enables parallel execution by multiple engineers.

When should I create an implementation plan during the development process?

Create an implementation plan after your design phase is complete. Once architecture is defined and technical decisions are locked, generate the plan to provide engineers with precise execution guidance for the implementation phase.

What problems do vague implementation instructions cause?

Vague instructions lead to confusion, rework, and delays, especially for new team members. Detailed plans with exact file paths, code examples, and verification steps eliminate ambiguity and ensure consistent, efficient implementation across the team.