linear-migration-deep-dive

# Linear Migration Deep Dive ## Overview Comprehensive guide for migrating from Jira, Asana, or GitHub Issues to Linear. Covers assessment, workflow mapping, data export, transformation, batch import with hierarchy support, and post-migration validation. Linear also has a built-in importer (Settings > Import) for Jira, Asana, GitHub, and CSV. ## Prerequisites - Admin access to source system (Jira/Asana/GitHub) - Linear workspace with admin access - API keys for both source and Linear - Migration timeline and rollback plan ## Instructions ### Step 1: Migration Assessment Checklist ``` Data Volume [ ] Total issues/tasks: ___ [ ] Projects/boards: ___ [ ] Users to map: ___ [ ] Attachments: ___ [ ] Custom fields: ___ [ ] Comments: ___ Workflow Analysis [ ] Source statuses documented [ ] Status-to-state mapping defined [ ] Priority mapping defined [ ] Issue type-to-label mapping defined [ ] Automations to recreate: ___ Timeline [ ] Migration window: ___ [ ] Parallel run period: ___ [ ] Cutover date: ___ [ ] Rollback deadline: ___ ``` ### Step 2: Workflow Mapping **Jira -> Linear:** | Jira Status | Linear State (type) | |-------------|-------------------| | To Do | Todo (unstarted) | | In Progress | In Progress (started) | | In Review | In Review (started) | | Blocked | In Progress (started) + "Blocked" label | | Done | Done (completed) | | Won't Do | Canceled (canceled) | | Jira Priority | Linear Priority | |---------------|----------------| | Highest/Blocker | 1 (Urgent) ...