Learn-skills.dev plan-to-tasks

Convert project plans to JSONL format (issues + dependencies). Use when users ask "convert plan to jsonl", "create jsonl from plan", "export plan as json" or "convert plan to taks", "create tasks from plan", "export plan as tasks".

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/adrianbrowning/agent-skills/plan-to-tasks" ~/.claude/skills/neversight-learn-skills-dev-plan-to-tasks && rm -rf "$T"

manifest: data/skills-md/adrianbrowning/agent-skills/plan-to-tasks/SKILL.md

source content

Plan to JSONL Converter

Transform project plans into JSONL format: Story (Epic) → Task → SubTask with embedded dependencies.

When to Apply

Use this skill when:

User provides a project plan/spec to break down
Converting markdown plans to JSONL format
Exporting task hierarchies as structured data
Creating work queues for external systems
User asks to "convert to jsonl", "create jsonl from plan", "export plan as json"

Core Conversion Process

Step 1: Analyze the Plan

Identify three levels:

Stories (Epics): Major features/components → Type:
```
epic
```
Tasks: Implementation work → Type:
```
task
```
SubTasks: Granular actions → Type:
```
task
```

CRITICAL: Extract ALL details from plan - see Information Extraction.

Step 2: Create Self-Contained Tasks

Each task must include complete context for agent to work independently. Agent selects by priority only - no hierarchy traversal.

See Self-Contained Tasks for template and examples.

Step 3: Add Dependencies

Use appropriate dependency types:

blocks

depends_on

related

discovered-from

See Dependency Types for patterns.

Rules Summary

Detailed rules in

rules/

directory:

TDD-First Approach - Mandatory Red→Green→Refactor for features/bugs
Type Schema - TypeScript type definition and task characteristics
Self-Contained Tasks - 1500+ char descriptions with complete context
Information Extraction - Extract requirements, user stories, specs
Dependency Types - blocks, related, discovered-from, parent-child
Priority Scale - P0-P4 rationale (hard tasks first)
Labels Organization - Feature grouping, TDD phases, stack tags
JSONL Queries - 50+ jq command examples
Best Practices - Output format, expected structure, final checklist

Example

Given:

Feature: User Authentication
- Login with email/password
- JWT tokens (15min access, 7day refresh)
- Rate limiting (5 attempts per 15min)

Convert to JSONL with:

Complete technical approach (bcrypt, JWT, Redis)
Implementation details (files, functions, config)
Error handling (400/401/403/429/500)
Testing requirements (coverage, test cases)
Dependencies (bcrypt, jsonwebtoken, ioredis)

See Self-Contained Tasks for full example.

Related Skills

```
/tdd-integration
```
- TDD Red-Green-Refactor cycle for implementation

Output Structure

└── plan/issues.jsonl  # One issue per line, dependencies embedded

Each line: complete JSON object following Type Schema.

STOP ONCE JSONL IS CREATED! DO NOT IMPLEMENT OR TEST ANYTHING YET!