extract-plan

# extract-plan

Extract actionable tasks from an implementation plan into structured JSON. Useful for importing plans into task management systems.

## Usage

```bash
cat implementation-plan.md | extract-plan
```

Or:

```bash
echo "Your plan text..." | extract-plan
```

## Input

Any implementation plan, design document, or task list. The tool handles various formats:

- Numbered lists
- Bullet points
- Phased plans
- Markdown documents
- Plain text descriptions

## Output

Structured JSON with phases and tasks:

```json
{
  "overview": "Brief summary of what the plan accomplishes",
  "phases": [
    {
      "name": "Phase 1: Foundation",
      "tasks": [
        {
          "text": "Set up project structure",
          "priority": "high",
          "file": "src/main.py",
          "notes": "Use standard layout"
        },
        {
          "text": "Add configuration module",
          "priority": "medium",
          "file": null,
          "notes": null
        }
      ]
    }
  ],
  "notes": "Optional overall notes"
}
```

### Task Fields

| Field | Description |
|-------|-------------|
| `text` | Actionable item in imperative form |
| `priority` | `high` (core/blocking), `medium` (standard), `low` (cleanup/optional) |
| `file` | Filename if mentioned in the plan |
| `notes` | Additional context or implementation details |

### Priority Assignment

- **high**: First steps, core features, blockers
- **medium**: Standard implementation tasks
- **low**: Documentation, cleanup, nice-to-haves

## Example

```bash
cat << 'EOF' | extract-plan
# Authentication Implementation

## Phase 1: Core Auth
1. Add JWT token generation
2. Create login endpoint
3. Add password hashing

## Phase 2: Session Management
1. Implement refresh tokens
2. Add logout endpoint
3. Create session storage
EOF
```

## Provider

Default: `opencode-deepseek` - change to your preferred provider in the Tool Builder UI.