plan-go-major-upgrades

Orchestrate staged Go module major-version upgrades with validation gates.

2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/NagyVikt/codex-plugins --skill plan-go-major-upgrades
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-go-major-upgrades
Source: https://github.com/NagyVikt/codex-plugins/tree/main/plugins/docker/skills/plan-go-major-upgrades
Command: npx skills add https://github.com/NagyVikt/codex-plugins --skill plan-go-major-upgrades

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill mitigates the risks associated with major Go module version upgrades by replacing blind, bulk dependency changes with a structured, staged, and verifiable execution plan.

Core Features & Use Cases

  • Staged Sequencing: Organizes upgrades from low-coupling libraries to high-blast-radius modules to minimize system instability.
  • Validation Gates: Enforces mandatory checkpoints including linting, testing, and tidy operations after every step.
  • Risk Management: Provides a clear risk assessment table and rollback strategy for every upgrade step to ensure production safety.

Quick Start

Use the plan-go-major-upgrades skill to generate a safe migration sequence for the major version updates identified in the current Go project.

Frequently Asked Questions about plan-go-major-upgrades

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

FAQPage Schema
How do I safely upgrade Go modules to a major version without breaking transitive dependencies?

To safely upgrade Go modules to a major version, sequence the updates from low-coupling libraries to high-blast-radius modules. This staged approach enforces validation gates and provides rollback strategies to manage transitive dependency impacts.

What is the best way to sequence major version dependency upgrades in a complex Go project?

The best way to sequence major version dependency upgrades is through a staged migration plan. This involves branch-based isolation and checkpoint-driven verification, enforcing linting, testing, and tidy operations after every step to ensure stability.

How does staged sequencing work for Go major version upgrades?

Staged sequencing works by organizing Go major version upgrades into granular steps based on dependency coupling. It enforces mandatory validation checkpoints with explicit go/no-go decision gating and risk assessments after each module update.

Can I use branch-based isolation to manage API breakage during a Go major upgrade?

Yes, branch-based isolation is used to manage API breakage during a Go major upgrade. It allows for checkpoint-driven verification and explicit go/no-go decision gating to control complex dependency management scenarios safely.

When should I not use a bulk dependency change for Go module upgrades?

You should not use a bulk dependency change when dealing with complex Go module upgrades where API breakage and transitive impacts require granular control. Instead, a structured, staged execution plan with validation gates is needed to minimize system instability.

What validation gates are enforced during a Go major version upgrade sequence?

Validation gates enforced during a Go major version upgrade include mandatory checkpoints for linting, testing, and tidy operations. These gates provide explicit go/no-go decision gating and risk assessment tables after every upgrade step.