Use when you have a spec or requirements for a multi-step task. Creates comprehensive implementation plans with bite-sized tasks, exact file paths, and complete code examples.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Writing Implementation Plans
## Overview
Write comprehensive implementation plans assuming the implementer has zero context for the codebase and questionable taste. Document everything they need: which files to touch, complete code, testing commands, docs to check, how to verify. Give them bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.
Assume the implementer is a skilled developer but knows almost nothing about the toolset or problem domain. Assume they don't know good test design very well.
**Core principle:** A good plan makes implementation obvious. If someone has to guess, the plan is incomplete.
## When to Use
**Always use before:**
- Implementing multi-step features
- Breaking down complex requirements
- Delegating to subagents via subagent-driven-development
**Don't skip when:**
- Feature seems simple (assumptions cause bugs)
- You plan to implement it yourself (future you needs guidance)
- Working alone (documentation matters)
## Bite-Sized Task Granularity
**Each task = 2-5 minutes of focused work.**
Every step is one action:
- "Write the failing test" — step
- "Run it to make sure it fails" — step
…
The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_2ywvhi7h454mdoag
GET https://markdownregistry.com/api/v1/resolve?ref=martin-hausleitner/martins-awesome-skills/writing-plans
GET https://markdownregistry.com/api/v1/blob/15c28bcbd1ee956780059ebf26c846dde5abf56435fa00c45bc03cd5f103c0fe
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
martin-hausleitner/martins-awesome-skills · skills/creative/p5js/SKILL.md · Production pipeline for interactive and generative visual art using p5.js. Creates browser-based sketches, generative…
martin-hausleitner/martins-awesome-skills · skills/devops/webhook-subscriptions/SKILL.md · Use when external services should trigger agent runs through webhook events
martin-hausleitner/martins-awesome-skills · skills/email/himalaya/SKILL.md · CLI to manage emails via IMAP/SMTP. Use himalaya to list, read, write, reply, forward, search, and organize emails from…
martin-hausleitner/martins-awesome-skills · skills/github/github-auth/SKILL.md · Use when GitHub authentication is missing, broken, or needed before repository, issue, pull request, or CI work
martin-hausleitner/martins-awesome-skills · skills/github/github-issues/SKILL.md · Use when triaging, creating, labeling, searching, or closing GitHub issues
martin-hausleitner/martins-awesome-skills · skills/github/github-pr-workflow/SKILL.md · Use when creating, updating, reviewing, testing, or merging a GitHub pull request
a5c-ai/babysitter · library/methodologies/superpowers/skills/writing-plans/SKILL.md · Use when you have a spec or requirements for a multi-step task, before touching code. Creates bite-sized TDD…
ganyuanran/aegis · skills/writing-plans/SKILL.md · Use when you have an approved spec or written requirements for a multi-step task that needs a durable plan document…
optima-cityu/llm4ad_next · docker/knowledge-parser/skills/writing-plans/SKILL.md · Use before a multi-step document restructuring task to map the source, preserve important relationships, and decide…
xu123-bob/baize · agent/skills/superpowers/5.1.0/skills/writing-plans/SKILL.md · Use when you have a spec or requirements for a multi-step task, before touching code
