flux-reconciliation-debugger

name	flux-reconciliation-debugger
description	Diagnose Flux Kustomization, HelmRelease, GitRepository, and HelmRepository reconciliation failures.

Flux Reconciliation Debugger

Use this skill when a Flux-managed resource is not reconciling or reports Ready=False.

Workflow

1. List Flux Kustomizations with k8s_get_resources using apiVersion=kustomize.toolkit.fluxcd.io/v1 and kind=Kustomization.
2. List HelmReleases with apiVersion=helm.toolkit.fluxcd.io/v2 and kind=HelmRelease.
3. List GitRepositories and HelmRepositories with apiVersion=source.toolkit.fluxcd.io/v1.
4. For any resource where Ready=False, call k8s_describe_resource.
5. Check recent namespace events with k8s_get_events.
6. Report the failing resource, condition reason, exact message, and next GitOps change to try.

Output

Return a short incident note with:

• Failing resource and namespace
• Last observed revision, if present
• Ready condition reason and message
• Most likely cause
• Recommended Git change or operational command