Core Components

Plan Loader

Load markdown or JSON plans into Jetpack with automatic hierarchy inference. Headers map to task hierarchy.

Markdown Format

# Build Authentication System      <- Epic (not claimable)
## Login Feature                   <- Task group
- Create login endpoint            <- Leaf task (claimable)
- Add JWT token validation         <- Leaf task (claimable)
- Build login UI                   <- Leaf task (claimable)
## Registration Feature
- Create signup endpoint
- Add email verification

Loading Plans

# Preview the plan before loading
jetpack load plan.md --dry-run

# Load and create tasks
jetpack load plan.md --name "Auth System"

JSON Format

{
  "id": "plan-001",
  "title": "Build Authentication System",
  "items": [
    {
      "id": "epic-1",
      "title": "Login Feature",
      "items": [
        { "id": "task-1", "title": "Create login endpoint" },
        { "id": "task-2", "title": "Add JWT token validation" }
      ]
    },
    {
      "id": "epic-2",
      "title": "Registration Feature",
      "items": [
        { "id": "task-3", "title": "Create signup endpoint" },
        { "id": "task-4", "title": "Add email verification" }
      ]
    }
  ]
}

Hierarchy Rules

# creates an epic (not claimable)

## creates a task group

- creates a leaf task (claimable)

Dependencies can be specified with [depends: task-id] syntax