writing-plans

Generates step-by-step implementation plans with testing and documentation saved to docs/plans/YYYY-MM-DD-feature-name.md.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/abzhaw/juliaz_agents --skill writing-plans-abzhaw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/abzhaw/juliaz_agents/tree/main/.superpowers/skills/writing-plans
Command: npx skills add https://github.com/abzhaw/juliaz_agents --skill writing-plans-abzhaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. Frequent commits.

Announce at start: "I'm using the writing-plans skill to create the implementation plan."

Context: This should be run in a dedicated worktree (created by brainstorming skill).

Save plans to: docs/plans/YYYY-MM-DD-<feature-name>.md

Core Features & Use Cases

  • Write comprehensive, end-to-end, task-focused implementation plans that cover files touched, tests, and documentation.
  • Include a clear sequence of steps, success criteria, and potential edge cases.
  • Provide guidance on verification, review, and commit practices.

Quick Start

Provide a feature name and I will generate a date-stamped, step-by-step implementation plan saved to docs/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate a step-by-step implementation plan for a multi-step engineering task?▼

To generate a step-by-step implementation plan, provide a feature name to produce a comprehensive, task-focused roadmap. The output covers files touched, testing, and documentation, saved as a date-stamped markdown file under docs/plans.

What is the best way to document an implementation roadmap for developers with zero codebase context?▼

Documenting an implementation roadmap for zero-context developers requires detailing every file to touch, code to write, and test to run. Bite-sized tasks ensure explicit upfront planning, verification, and frequent commit practices are clearly defined.

How do I structure task analysis and design plans for frequent commits and testing?▼

Structure task analysis and design plans by breaking down multi-step engineering tasks into bite-sized actions. Each task details specific files, tests, documentation checks, and success criteria to guide implementation and support frequent commits.

Can I use this to create a feature roadmap without setting up external dependencies?▼

Yes, you can create a feature roadmap without external dependencies. The skill operates standalone to generate detailed plans, requiring only a feature name to output a date-stamped markdown file with task granularity and verification steps.

What limitations exist when generating detailed implementation plans for edge cases?▼

A limitation when generating detailed implementation plans is that it assumes execution in a dedicated worktree and strictly saves outputs to docs/plans. It focuses on explicit upfront planning rather than dynamic runtime edge case handling.