writing-plans

Generate test-driven implementation plans with granular engineering steps.

2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/NagyVikt/codex-plugins --skill writing-plans-nagyvikt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/NagyVikt/codex-plugins/tree/main/plugins/superpowers/skills/writing-plans
Command: npx skills add https://github.com/NagyVikt/codex-plugins --skill writing-plans-nagyvikt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of ambiguous or poorly scoped development tasks by forcing a rigorous, TDD-focused planning phase before any code is written.

Core Features & Use Cases

  • Bite-Sized Tasking: Breaks complex features into granular, 2-5 minute actionable steps.
  • TDD Enforcement: Mandates the creation of failing tests before implementation code.
  • Execution Handoff: Provides a clear choice between subagent-driven iteration or parallel session execution.
  • Use Case: When starting a new feature, use this to generate a comprehensive plan that ensures every file, test, and commit is accounted for, preventing scope creep and ensuring high code quality.

Quick Start

Use the writing-plans skill to generate an implementation plan for the new user authentication module based on the provided requirements.

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 TDD-ready implementation plan for complex software features?

To generate a TDD-ready implementation plan, you provide high-level requirements and the skill breaks them into granular, 2-5 minute actionable steps. It mandates failing tests before implementation, ensuring every file and commit is accounted for to prevent scope creep.

What is the best way to break down ambiguous development tasks into actionable engineering steps?

The best way to break down ambiguous development tasks is enforcing a rigorous planning phase that transitions high-level requirements into bite-sized tasks. This structured documentation ensures adherence to DRY and YAGNI principles before any code is written.

How does test-driven development planning handle execution handoffs for parallel sessions?

Test-driven development planning handles execution handoffs by providing a clear choice between subagent-driven iteration or parallel session execution. This structured documentation operates within a dedicated worktree to maintain clear, actionable engineering steps.

Can I use structured implementation planning to prevent scope creep in new feature development?

Yes, you can use structured implementation planning to prevent scope creep by ensuring every file, test, and commit is accounted for before coding begins. This rigorous, TDD-focused phase enforces DRY and YAGNI principles for high code quality.

When should I not use a TDD-focused planning phase for my development workflow?

You should not use a TDD-focused planning phase for trivial tasks that require immediate code changes without structured documentation. It is designed for complex software features needing granular, test-driven implementation plans and strict scope enforcement.