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.