plan-to-tasks

name: plan-to-tasks description: 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".

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!