Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.
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
# Planning and Task Breakdown
## Overview
Decompose work into small, verifiable tasks with explicit acceptance criteria. Good task breakdown is the difference between an agent that completes work reliably and one that produces a tangled mess. Every task should be small enough to implement, test, and verify in a single focused session.
## When to Use
- You have a spec and need to break it into implementable units
- A task feels too large or vague to start
- Work needs to be parallelized across multiple agents or sessions
- You need to communicate scope to a human
- The implementation order isn't obvious
**When NOT to use:** Single-file changes with obvious scope, or when the spec already contains well-defined tasks.
## The Planning Process
### Step 1: Enter Plan Mode
Before writing any code, operate in read-only mode:
- Read the spec and relevant codebase sections
- Identify existing patterns and conventions
- Map dependencies between components
- Note risks and unknowns
**Do NOT write code during planning.** The output is a plan document, not implementation.
### Step 2: Identify the Dependency Graph
Map what depends on what:
```
Database schema
│
…
The line at the top of this page pins the label git:20260410.1a22ea0, 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_e52th6yf4mlrgss6
GET https://markdownregistry.com/api/v1/resolve?ref=shashankswe2020-ux/whoop-mcp/planning-and-task-breakdown
GET https://markdownregistry.com/api/v1/blob/d9dc9a1bea50a0bb2b5c51ed59833b65969b5b0bda2c8dacefb5560275443a35
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.
shashankswe2020-ux/whoop-mcp · .github/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
shashankswe2020-ux/whoop-mcp · .github/skills/browser-testing-with-devtools/SKILL.md · Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect…
shashankswe2020-ux/whoop-mcp · .github/skills/ci-cd-and-automation/SKILL.md · Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to…
shashankswe2020-ux/whoop-mcp · .github/skills/code-review-and-quality/SKILL.md · Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another…
shashankswe2020-ux/whoop-mcp · .github/skills/code-simplification/SKILL.md · Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but…
shashankswe2020-ux/whoop-mcp · .github/skills/context-engineering/SKILL.md · Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching…
shashankswe2020-ux/whoop-mcp · .github/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you…
shashankswe2020-ux/whoop-mcp · .github/skills/deprecation-and-migration/SKILL.md · Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one…
shashankswe2020-ux/whoop-mcp · .github/skills/documentation-and-adrs/SKILL.md · Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features…
shashankswe2020-ux/whoop-mcp · .github/skills/frontend-ui-engineering/SKILL.md · Builds production-quality UIs. Use when building or modifying user-facing interfaces. Use when creating components…
shashankswe2020-ux/whoop-mcp · .github/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…
addyosmani/agent-skills · skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…
skillmds/skillmd · plugins/create-agent-skills/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-claude/.claude/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-cursor/.cursor/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/planning-and-task-breakdown/SKILL.md · Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into…