gitops-workload-refactoring

Community

Safely refactor Kubernetes workloads in GitOps.

AuthorHugoAlmeidaMoreira
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Safe practices for renaming or refactoring applications managed by GitOps (e.g., FluxCD) to avoid destructive side effects on PersistentVolumeClaims, multi-document YAML formatting, and CRD API version mismatches.

Core Features & Use Cases

  • Renaming Stateful Workloads (PVCs): Avoids data loss or downtime by guidelines like preserving the old claimName or performing careful data migration when PVCs must be renamed.
  • Multi-Document YAML Formatting: Prevents YAML corruption during edits by recommending proper tooling and avoiding brittle in-place edits; emphasizes using dedicated patching or scripting rather than ad-hoc text replacements.
  • Verifying CRD API Versions: Ensures manifests target supported CRD versions by checking cluster capabilities before applying changes.

Quick Start

Follow these steps to safely refactor and rename a GitOps-managed Kubernetes workload without data loss or API incompatibilities.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: gitops-workload-refactoring
Download link: https://github.com/HugoAlmeidaMoreira/zeus-agent/archive/main.zip#gitops-workload-refactoring

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.