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!