build-ci-migration-assistant

Build/CI Migration Assistant

Automatically migrate build systems and CI/CD configurations to target platforms while preserving functionality.

Workflow

1. Analyze Source Configuration

Identify the current build system or CI/CD platform:

Build Systems:

• Maven (pom.xml)
• Gradle (build.gradle, build.gradle.kts)
• npm (package.json)
• Yarn (package.json + yarn.lock)
• Make (Makefile)
• CMake (CMakeLists.txt)

CI/CD Platforms:

• Travis CI (.travis.yml)
• CircleCI (.circleci/config.yml)
• Jenkins (Jenkinsfile)
• GitLab CI (.gitlab-ci.yml)
• GitHub Actions (.github/workflows/*.yml)

Read and parse the source configuration to understand:

• Dependencies and their versions
• Build commands and lifecycle
• Test configuration
• Environment variables and secrets
• Caching strategy
• Deployment steps

2. Map to Target Platform

Consult the appropriate reference guide:

• Build systems: See references/build-systems.md
• CI/CD platforms: See references/ci-platforms.md

Map source concepts to target equivalents:

• Dependencies → Target dependency format
• Build commands → Target command syntax
• Lifecycle phases → Target stages/jobs
• Environment variables → Target secrets/variables
• Caching → Target caching mechanism

3. Generate Target Configuration

Create the target configuration file(s):

For build systems:

• Generate new build file (build.gradle, pom.xml, etc.)
• Preserve dependency versions
• Map plugins and tasks
• Maintain build lifecycle

For CI/CD platforms:

• Generate workflow/pipeline file
• Convert jobs and stages
• Map triggers and conditions
• Configure runners/agents
• Set up caching and artifacts

4. Validate Migration

Test the generated configuration:

Build system validation:

# Maven
mvn clean install

# Gradle
./gradlew build

# npm
npm install && npm test

CI/CD validation:

• Create a test branch
• Push generated configuration
• Verify pipeline runs successfully
• Check all jobs complete
• Validate artifacts and deployments