dex-plan

# Converting Markdown Documents to Tasks

## Command Invocation

Use the bundled `./dex` script in this skill directory to run dex commands:

```bash
./dex <command>
```

The script automatically finds a local `dex` installation or falls back to `npx @zeeg/dex`.

Use `/dex-plan` to convert any markdown planning document into a trackable dex task.

## When to Use

- After completing a plan in plan mode
- Converting specification documents to trackable tasks
- Converting design documents to implementation tasks
- Creating tasks from roadmap or milestone documents
- Tracking any markdown planning or design content

## Supported Documents

Any markdown file containing planning or design content:
- Plan files from plan mode (`~/.claude/plans/*.md`)
- Specification documents (`SPEC.md`, `REQUIREMENTS.md`)
- Design documents (`DESIGN.md`, `ARCHITECTURE.md`)
- Roadmaps and milestone documents (`ROADMAP.md`)
- Feature proposals and technical RFCs

## Usage

```bash
/dex-plan <markdown-file-path>
```

### Examples

**From plan mode:**
```bash
/dex-plan /home/user/.claude/plans/moonlit-brewing-lynx.md
```

**From specification document:**
```bash
/dex-plan @SPEC.md
```

**From design document:**
```bash
/dex-plan docs/AUTHENTICATION_DESIGN.md
```

**From roadmap:**
```bash
/dex-plan ROADMAP.md
```

## What It Does

1. Reads the markdown file
2. Extracts title from first `#` heading (or uses filename as fallback)
3. Strips "Plan: " prefix if present (case-insensitive)
4. Creates dex task with full markdown content as context
5. Analyzes plan structure for potential subtask breakdown
6. Automatically creates subtasks when appropriate
7. Returns task ID and breakdown summary

## Examples

**From plan mode file:**
```markdown
# Plan: Add JWT Authentication

## Summary
...
```
→ Task description: "Add JWT Authentication" (note: "Plan: " prefix stripped)

**From specification document:**
```markdown
# User Authentication Specification

## Requirements
...
```
→ Task description: "Us