How does the automatic subtask breakdown work?

The skill analyzes the markdown hierarchy (headers and lists) to identify distinct implementation steps, creating up to three levels of depth: Epics, Tasks, and Subtasks.

Does it preserve code snippets from the original document?

Yes, when breaking down tasks, the skill extracts relevant section content, including code snippets and file paths, and includes them in the task description.

What markdown files are supported by dex-plan?

It supports any markdown file containing planning or design content, including SPEC.md, DESIGN.md, ARCHITECTURE.md, roadmaps, and Claude's internal plan files.

Can I use it with Claude's built-in plan mode?

Yes, it is specifically designed to take plans from ~/.claude/plans/*.md and convert them into trackable dex tasks instantly.

What if my plan is too small for subtasks?

The skill includes decision logic to skip breakdown for exploratory work or short plans (1-2 steps), keeping your task list clean and cohesive.

Dex Plan

Name: Dex Plan
Author: dcramer

bydcramer

•

148

Productivity & Workflow

Converts markdown planning documents into structured, trackable tasks and subtasks within the dex system.

About

dex-plan streamlines the transition from planning to execution by automatically transforming markdown specifications, design documents, and roadmaps into actionable tasks. It intelligently analyzes the structure of your markdown files—detecting numbered lists, headers, and implementation phases—to create a hierarchical task tree (Epics, Tasks, and Subtasks) within the dex task tracking system. This ensures that every requirement and implementation detail is captured and assigned a unique ID for seamless tracking throughout the development lifecycle.

Key Features

Support for 3-level task hierarchies including Epics, Tasks, and Subtasks.
Automated task creation from markdown specs, design docs, and roadmaps.
Smart context extraction that preserves implementation details and code snippets.
148 GitHub stars
Automatic stripping of 'Plan:' prefixes for clean task titles.
Intelligent subtask breakdown based on document headings and list items.

Use Cases

Converting a Claude-generated plan into trackable, manageable subtasks.
Turning a SPEC.md or DESIGN.md into a structured implementation checklist.
Decomposing a high-level roadmap into actionable developer tasks with parent-child relationships.

About

Key Features

Support for 3-level task hierarchies including Epics, Tasks, and Subtasks.
Automated task creation from markdown specs, design docs, and roadmaps.
Smart context extraction that preserves implementation details and code snippets.
148 GitHub stars
Automatic stripping of 'Plan:' prefixes for clean task titles.
Intelligent subtask breakdown based on document headings and list items.

Use Cases

Converting a Claude-generated plan into trackable, manageable subtasks.
Turning a SPEC.md or DESIGN.md into a structured implementation checklist.
Decomposing a high-level roadmap into actionable developer tasks with parent-child relationships.