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.