writing-plans

Turn software specs into actionable implementation plans with YAML frontmatter and Markdown sections.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans from a spec or requirements so engineers have a clear, end-to-end roadmap. It documents which files to touch, what to code, test, and how to verify, ensuring zero-context handoffs and reducing guesswork.

Core Features & Use Cases

  • Comprehensive task decomposition with explicit file touchpoints, testing steps, and documentation requirements.
  • Guidance for commits, versioning, and iterative delivery using TDD and DRY principles.
  • Best-suited for onboarding new engineers, scoping features from vague specs, and aligning multiple teams on a plan.

Quick Start

Generate a comprehensive implementation plan and save it to docs/superpowers/plans/2026-04-01-writing-plans.md

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn a software spec into an implementation plan with task decomposition?

Turn a software spec into an implementation plan by decomposing requirements into actionable tasks with explicit file touchpoints, testing steps, and documentation requirements. This provides a clear end-to-end roadmap for engineers to follow.

What is the best way to document file touchpoints and testing steps for feature development?

Document file touchpoints and testing steps by generating a comprehensive implementation plan that maps out exactly which files to modify, what code to write, and how to verify results using TDD and DRY principles.

Can I use this implementation plan approach for onboarding new engineers and aligning cross-team initiatives?

Yes, this implementation plan approach is best-suited for onboarding new engineers, scoping features from vague specs, and aligning multiple teams on a plan by ensuring zero-context handoffs and reducing guesswork across initiatives.

Does the generated implementation plan include guidance for commits and versioning?

Yes, the generated implementation plan includes guidance for commits, versioning, and iterative delivery by enforcing TDD and DRY principles throughout the development lifecycle of the feature.

How do I structure a software implementation plan using YAML frontmatter and Markdown?

Structure an implementation plan using YAML frontmatter with name and description fields, followed by a Markdown body with required section headers, a single-line Quick Start, and metadata fields including complexity, category, keywords, dependencies, and components.