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 embeddedEach line: complete JSON object following Type Schema.
STOP ONCE JSONL IS CREATED! DO NOT IMPLEMENT OR TEST ANYTHING YET!