Skip to main content

Story 7: Migration Support and Installation Modes

Status: COMPLETE ✅
Priority: HIGH
Estimated Effort: [TBD]
Last updated: 2025-12-10 (v0.4.7.3+1 – Task 3 complete: Documentation and guides updated)
Version: v0.4.7.3+1
Status: COMPLETE ✅
Code: E4S07

Goal​

Provide safe adoption paths for projects with pre-existing Kanban/Sprint/Issue structures by adding detection, analysis, migration utilities, and installation modes.

Tasks​

  • E4:S07:T01 – BR-006: Detection/analysis utilities for existing structures ✅ COMPLETE (v0.4.7.1+1)

    • Implemented detection utility (detect_existing_structure.py) - scans for epic directories, detects epic/story documents, identifies tasks, generates detection report
    • Implemented analysis utility (analyze_structure.py) - maps existing items to E/S/T format, identifies conflicts and gaps, generates migration plan
    • Created scripts README with usage documentation
    • Tested on current project structure (10 epics, 46 stories, 335 tasks detected)
    • Linked BR: BR-006-missing-migration-support-pre-existing-kanban.md (GitHub issue #2)
    • Acceptance: ✅ Criteria 1-4 of BR-006 satisfied and documented.

  • E4:S07:T02 – FR-007: Migration utilities and installation modes ✅ COMPLETE (v0.4.7.2+1)

    • Implemented migration utility (migrate_structure.py) - creates backups, migrates epics/stories/tasks, preserves forensic markers, supports all installation modes
    • Implemented installation script (install_kanban_framework.py) - interactive mode selection, integrates detection/analysis/migration, supports Fresh/Migration/Update/Hybrid modes
    • Updated scripts README with migration utility documentation and integrated workflow
    • All installation modes implemented: Fresh (clean install), Migration (migrate existing), Update (update framework), Hybrid (preserve project epics, install framework epics)
    • Backup functionality implemented with timestamp-based directories
    • Linked FR: FR-007-migration-utilities-and-installation-modes.md (GitHub issue #3)
    • Acceptance: ✅ AC-1..AC-8 of FR-007 satisfied and documented.

  • E4:S07:T03 – Documentation and guides update ✅ COMPLETE (v0.4.7.3+1)

    • Updated packages/frameworks/kanban/README.md with migration support section, installation options (interactive vs manual), migration workflow documentation, and package contents update
    • Added migration support section covering pre-existing Kanban, Sprint-based systems, issue trackers, and older framework versions
    • Updated Quick Start section with Option 1 (Interactive Installation) and Option 2 (Manual Installation)
    • Added migration workflow examples and quick start commands
    • Updated package contents to include scripts directory and utilities
    • Linked BR/FR: BR-006 / FR-007.
    • Acceptance: ✅ BR-006 criteria 9-12 and FR-007 AC-6..AC-8 addressed in docs.

References​

  • BR-006: docs/project-management/kanban/fr-br/BR-006-missing-migration-support-pre-existing-kanban.md
  • FR-007: docs/project-management/kanban/fr-br/FR-007-migration-utilities-and-installation-modes.md
  • UXR-001 (inputs): docs/project-management/kanban/fr-br/UXR-001-migration-user-experience-research.md

Template Usage: Story follows Kanban framework story template; Tasks trace to BR/FR for forensic linkage.