Preview Jira Issues from Track Plan

Generate jira-export.md from the track's plan for review and editing before creating actual Jira issues.

Mapping Structure

Step 1: Load Context

1. •Find active track from draft/tracks.md (look for [~] In Progress or first [ ] track)
2. •If track ID provided as argument, use that instead
3. •Read the track's plan.md for phases and tasks
4. •Read the track's metadata.json for title and type
5. •Read the track's spec.md for epic description
6. •Read core/templates/jira.md for field structure

If no track found:

• •Tell user: "No track found. Run /draft:new-track to create one, or specify track ID."

Step 2: Parse Plan Structure

Extract from plan.md:

Epic (from track)

• •Summary: Track title from metadata.json or first # Plan: heading
• •Description: Overview section from spec.md
• •Type: Feature (from metadata.json type: feature|bugfix|refactor)

Stories (from phases)

For each ## Phase N: [Name] section:

• •Summary: Phase name
• •Goal: Extract from **Goal:** line
• •Verification: Extract from **Verification:** line

Sub-tasks (from tasks)

For each - [ ] **Task N.M:** within a phase:

• •Summary: Task description (text after **Task N.M:**)
• •Parent: The phase's story
• •Status: Map [ ] → To Do, [x] → Done, [~] → In Progress, [!] → Blocked

Story Points Calculation

Count tasks per phase and assign points to the story:

Step 3: Generate Export File

Create draft/tracks/<track_id>/jira-export.md:

# Jira Export: [Track Title]

**Generated:** [ISO timestamp]
**Track ID:** [track_id]
**Status:** Ready for review

> Edit this file to adjust story points, descriptions, or sub-tasks before running `/draft:jira-create`.

---

## Epic

**Summary:** [Track Title]
**Issue Type:** Epic
**Description:**
{noformat}
[Spec overview - first 2-3 paragraphs]
{noformat}

---

## Story 1: [Phase 1 Name]

**Summary:** Phase 1: [Phase Name]
**Issue Type:** Story
**Story Points:** [calculated based on task count]
**Epic Link:** (will be set on creation)

**Description:**
{noformat}
h3. Goal
[Phase goal]

h3. Verification
[Phase verification criteria]
{noformat}

### Sub-tasks

| # | Summary | Status |
|---|---------|--------|
| 1.1 | [Task 1.1 description] | To Do |
| 1.2 | [Task 1.2 description] | Done |
| 1.3 | [Task 1.3 description] | To Do |

---

## Story 2: [Phase 2 Name]

**Summary:** Phase 2: [Phase Name]
**Issue Type:** Story
**Story Points:** [calculated]
**Epic Link:** (will be set on creation)

**Description:**
{noformat}
h3. Goal
[Phase goal]

h3. Verification
[Phase verification criteria]
{noformat}

### Sub-tasks

| # | Summary | Status |
|---|---------|--------|
| 2.1 | [Task 2.1 description] | To Do |
| 2.2 | [Task 2.2 description] | To Do |

---

[Continue for all phases...]

Step 4: Report

Jira Preview Generated

Track: [track_id] - [title]
Export: draft/tracks/<id>/jira-export.md

Summary:
- 1 epic
- N stories (phases)
- M sub-tasks (tasks)
- P total story points

Breakdown:
- Phase 1: [name] - X pts, Y tasks
- Phase 2: [name] - X pts, Y tasks
- Phase 3: [name] - X pts, Y tasks

Next steps:
1. Review and edit jira-export.md (adjust points, descriptions, sub-tasks)
2. Run `/draft:jira-create` to create issues in Jira

Error Handling

If plan.md has no phases:

• •Tell user: "No phases found in plan.md. Run /draft:new-track to generate a proper plan."

If spec.md missing:

• •Use plan.md overview for epic description
• •Warn: "spec.md not found, using plan overview for epic description."

If jira-export.md already exists:

• •Warn: "jira-export.md already exists. Overwriting with fresh generation."
• •Proceed with overwrite (user can always re-edit)

If phase has no tasks:

• •Create story with 1 story point
• •Add note: "No sub-tasks defined for this phase"