Video Tutorials

Step-by-step visual guides for spectryn.

🚀

Your First Sync
5 min • Set up and sync your first epic

🎮

Interactive Mode
3 min • Step-by-step guided sync

💾

Backup & Restore
4 min • Safe sync with rollback

⚙️

CI/CD Setup
6 min • Automate with GitHub Actions

Quick Demos

Dry Run Preview

$ spectryn --markdown EPIC.md --epic PROJ-123

╭──────────────────────────────────────────────────────────────╮
│  spectryn v1.0.0                                              │
│  Syncing: EPIC.md → PROJ-123                                 │
│  Mode: DRY RUN (use --execute to apply changes)              │
╰──────────────────────────────────────────────────────────────╯

📋 Found 3 stories in markdown

┌─────────────────────────────────────────────────────────────┐
│ US-001: User Authentication                                 │
├─────────────────────────────────────────────────────────────┤
│ 📝 Would update description                                 │
│ ➕ Would create 3 subtasks                                  │
│ ⏳ Would transition: Open → In Progress                     │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│ US-002: User Registration                                   │
├─────────────────────────────────────────────────────────────┤
│ 📝 Would update description                                 │
│ ➕ Would create 2 subtasks                                  │
│ ✓ Status unchanged                                          │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│ US-003: Password Reset                                      │
├─────────────────────────────────────────────────────────────┤
│ 📝 Would update description                                 │
│ ➕ Would create 2 subtasks                                  │
│ ✓ Status unchanged                                          │
└─────────────────────────────────────────────────────────────┘

Summary:
  Stories: 3
  Subtasks to create: 7
  Descriptions to update: 3
  Status transitions: 1

To apply these changes, run:
  spectryn --markdown EPIC.md --epic PROJ-123 --execute

Execute Sync

$ spectryn --markdown EPIC.md --epic PROJ-123 --execute

╭──────────────────────────────────────────────────────────────╮
│  spectryn v1.0.0                                              │
│  Syncing: EPIC.md → PROJ-123                                 │
│  Mode: EXECUTE                                               │
╰──────────────────────────────────────────────────────────────╯

⚠️  This will modify 3 stories in Jira. Continue? [y/N]: y

💾 Creating backup... backup_20250113_142530

Syncing stories ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 3/3

✓ PROJ-124: Updated description
  ✓ Created subtask PROJ-125
  ✓ Created subtask PROJ-126
  ✓ Created subtask PROJ-127
  ✓ Transitioned to In Progress

✓ PROJ-128: Updated description
  ✓ Created subtask PROJ-129
  ✓ Created subtask PROJ-130

✓ PROJ-131: Updated description
  ✓ Created subtask PROJ-132
  ✓ Created subtask PROJ-133

╭──────────────────────────────────────────────────────────────╮
│  ✅ Sync Complete                                            │
│                                                              │
│  Stories synced: 3                                           │
│  Subtasks created: 7                                         │
│  Transitions: 1                                              │
│  Duration: 4.2s                                              │
│                                                              │
│  Backup: backup_20250113_142530                              │
│  To rollback: spectryn --rollback --epic PROJ-123             │
╰──────────────────────────────────────────────────────────────╯