Writing Plans
A Skill for creating comprehensive implementation plans with bite-sized tasks that assume the engineer has zero context.
Core Approach
Write plans assuming the engineer:
- Has zero context for our codebase
- Is a skilled developer but knows nothing about our toolset
- Doesn't know good test design very well
- Needs everything documented: which files to touch, how to test it, what to check
Task Granularity
Each step is one action (2-5 minutes):
- "Write the failing test" - step
- "Run it to make sure it fails" - step
- "Implement the minimal code to make the test pass" - step
Key Principles
- DRY: Don't Repeat Yourself
- YAGNI: You Aren't Gonna Need It
- TDD: Test-Driven Development
- Frequent Commits: Small, atomic commits
Plans saved to: docs/plans/YYYY-MM-DD-<feature-name>.md
Comments
No comments yet. Be the first to comment!
Related Tools
Writing Skills Skill
github.com/obra/superpowers
Test-Driven Development applied to process documentation - create and verify Skills work before deployment.
Brainstorming Skill
github.com/obra/superpowers
Explores user intent, requirements and design before implementation through collaborative dialogue.
Subagent-Driven Development Skill
github.com/obra/superpowers
Execute plans by dispatching fresh subagent per task with two-stage review - spec compliance then code quality.
Related Insights
Skills + Hooks + Plugins: How Anthropic Redefined AI Coding Tool Extensibility
An in-depth analysis of Claude Code's trinity architecture of Skills, Hooks, and Plugins. Explore why this design is more advanced than GitHub Copilot and Cursor, and how it redefines AI coding tool extensibility through open standards.
Seven AI Coding CLIs, Six Months: No Matter How Strong the Model, Work Needs Supervision
Claude Code, Codex, opencode, pi, omp and DeepSeek Harness all have personalities. After six months of deep use I run a division of labor: pi for the fastest cheapest reviews, omp for complex PRs, DeepSeek Harness on V4 Flash for high-frequency low-cost review, and Claude Code, Qoder and Cursor for writing. No matter how strong the model, work needs supervision — ideally from an independent third party.
Claude Code's Next Frontier: Not Code, But Your Local Obsidian Knowledge Base
Explore how Obsidian + Claude Code transforms from a knowledge management tool into your private AI assistant. Complete guide including obsidian-skills, Claudian plugin, Claudesidian template, and best practices for achieving both data privacy and AI capabilities.