dia-migration

Migrate DIA projects between versions by transforming YAML frontmatter, file naming, and repository structure.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/salemaziel/digital-innovation-agents --skill dia-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dia-migration
Source: https://github.com/salemaziel/digital-innovation-agents/tree/main/skills/dia-migration
Command: npx skills add https://github.com/salemaziel/digital-innovation-agents --skill dia-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires detect_state.py, strip_frontmatter_status.py, strip_body_status.py, migrate_naming.py, flatten_analysis.py, build_backlog.py, migrate_status_vocabulary.py, migrate_skill_names.py, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of migrating existing Digital Innovation Agents (DIA) projects to the latest conventions, ensuring consistency and compatibility with modern DIA standards.

Core Features & Use Cases

  • Migration Automation: Automates the process of migrating DIA artifacts and configurations to the latest version.
  • Brownfield and Greenfield Support: Handles both brownfield (existing projects) and greenfield (new projects) scenarios.
  • Version Upgrade: Facilitates upgrades from DIA version 1 to the latest version.
  • Use Case: If you have a DIA v1 project and need to upgrade it to the current version without starting from scratch, this Skill can help you do it efficiently.

Quick Start

Run the dia-migration skill to start the migration process on your project.

Frequently Asked Questions about dia-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade a DIA v1 project to the latest version conventions?

DIA migration automates upgrading existing Digital Innovation Agents projects by transforming YAML frontmatter, file naming, and repository structure. It executes in seven phases on a feature branch to ensure idempotent consistency with modern conventions.

Can I migrate both brownfield and greenfield DIA repositories?

Yes, DIA migration handles both brownfield and greenfield scenarios. It transforms YAML frontmatter, file naming, and repository structures for existing or new projects, ensuring consistent alignment with the latest DIA conventions.

What do I need to set up before running a DIA repository migration?

DIA migration requires a tools/migration/ directory containing associated Python scripts and execution on a feature branch. This setup ensures safe, idempotent transformations of YAML frontmatter, file naming, and repository structure.

How does the DIA migration process handle idempotency and consistency?

DIA migration ensures idempotency by executing in seven structured phases. This approach safely applies transformations to YAML frontmatter, status vocabulary, and skill names, guaranteeing consistent repository migration results without duplicating changes.

What is the best way to automate YAML frontmatter and file naming updates for DIA projects?

The best way to automate YAML frontmatter and file naming updates is using DIA migration. It operates on a feature branch to systematically migrate status vocabulary, skill names, and repository structure conventions across seven phases.