Featured

writing-plans

Name: writing-plans
Rating: 5 (9437 reviews)
Author: obra

Use when design is complete and you need detailed implementation tasks for engineers with zero codebase context - creates comprehensive implementation plans with exact file paths, complete code examples, and verification steps assuming engineer has minimal domain knowledge

TL;DR

Creates detailed, step-by-step implementation plans for engineers with no codebase context.

What Is It

Generates comprehensive implementation plans for zero-context engineers
Includes exact file paths, full code examples, and test steps
Assumes no prior knowledge of domain or codebase
Enables task-by-task execution with verification

Key Features

Exact file paths and code examples in every step
Failing test first (TDD), minimal implementation, frequent commits
Mandatory test writing and verification steps
Bite-sized, 2-5 minute tasks per action
Must include specific commands and expected outputs
Requires subagent or parallel session execution
DRY, YAGNI, TDD principles enforced
Plan saved to `docs/plans/YYYY-MM-DD-<feature>.md`

How to Use

1.Run when design is complete and engineer has no codebase context
2.Start with plan header including goal, architecture, tech stack
3.Structure tasks with files, steps, code, and commands
4.Include exact commands and expected failure/pass output
5.Choose execution path: subagent-driven or parallel session
6.Save plan to `docs/plans/YYYY-MM-DD-<feature>.md`

Guardrails & Gotchas

MUST use exact file paths, not vague references
MUST include full code examples, not just 'add validation'
MUST include exact commands and expected outputs
MUST reference relevant skills with @ syntax
MUST follow TDD, DRY, YAGNI, frequent commits
MUST start with required header format
MUST offer execution choice after plan creation

GitHub Stats

Author

@obra

Repository

obra/superpowers

Stars

9437

Explore More Skills

move-code-quality

@davila7

Analyzes Move language packages against the official Move Book Code Quality Checklist. Use this skill when reviewing Move code, checking Move 2024 Edition compliance, or analyzing Move packages for best practices. Activates automatically when working with .move files or Move.toml manifests.

12.4k

1.1k

1w ago

writing-plans

Explore More Skills

move-code-quality

e2e-testing-patterns

testing-anti-patterns