writing-plans

Translate software specifications into step-by-step implementation plans with testing and commit guidance.

115|54|Updated May 25, 2026
One-click install
npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill writing-plans-totvs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/totvs/engpro-advpl-tlpp-skills/tree/main/skills/superpowers/writing-plans
Command: npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill writing-plans-totvs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns ambiguous requirements into a concrete, test-driven implementation plan that a developer can execute without prior knowledge of the codebase.

Core Features & Use Cases

  • Multi-step implementation planning: Produces bite-sized tasks organized as a sequence that supports TDD, DRY, YAGNI, and frequent commits.
  • Repository-aware instructions: Specifies exact files to create/modify/test and includes concrete command examples with expected outcomes.
  • Execution handoff for subagents: Saves plans to a dated docs path and optionally dispatches execution using a required sub-skill for task-by-task implementation.

Quick Start

Use this Skill when you have a spec or requirements for a multi-step change and ask an AI to produce an implementation plan saved to docs/plans with an execution-ready handoff.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn software specifications into a step-by-step implementation plan?▼

Implementation planning for multi-stage engineering tasks translates specs into actionable, bite-sized steps. It specifies exact files to modify, test commands, and commit guidance, allowing execution without prior codebase knowledge.

How do I create a test-driven development plan with task breakdown for a new feature?▼

You can generate a TDD task breakdown by processing requirements through this Skill. It structures work into bite-sized steps adhering to DRY and YAGNI principles, providing concrete test commands and expected outcomes for each file modification.

Can I generate implementation plans that specify exact files to modify and test commands to run?▼

Yes, generating implementation plans with exact file modifications and test commands is supported. The output provides repository-aware instructions, specifying files to create or modify alongside concrete command examples and expected outcomes for each task.

Does implementation planning work for developers with minimal codebase context?▼

Yes, implementation planning works for developers with minimal codebase context by assuming low prior knowledge. It provides explicit file touch points, test strategies, and execution commands required to complete multi-stage engineering tasks without guessing.

What is the best way to structure multi-stage engineering tasks for subagent execution?▼

The best way to structure multi-stage engineering tasks for subagent execution is saving the plan to a dated docs/plans path. This creates an execution-ready handoff enabling downstream sub-skills to implement the work task-by-task.

When should I avoid using automated implementation planning for task breakdown?▼

You should avoid using automated implementation planning for task breakdown when a change is not a multi-stage engineering task. It is designed for complex sequences requiring explicit test strategies and commit guidance, not simple, single-file edits.