skills.rest
jctanner
jctannerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

analyze-running-cluster

Compare GENERATED_ARCHITECTURE.md against live Kubernetes cluster resources and report drift.

Updated Apr 1, 2026
Search Tags:#architecture#documentation#rbac#kubernetes#drift#analyze#cluster
One-click install
npx skills add https://github.com/jctanner/platform-architecture-context-pipeline --skill analyze-running-cluster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: analyze-running-cluster
Source: https://github.com/jctanner/platform-architecture-context-pipeline/tree/main/.claude/skills/analyze-running-cluster
Command: npx skills add https://github.com/jctanner/platform-architecture-context-pipeline --skill analyze-running-cluster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate architecture documentation against a running Kubernetes cluster to identify drift between what's documented and what's actually deployed.

Core Features & Use Cases

  • Drift detection between GENERATED_ARCHITECTURE.md and the live cluster state
  • Validation of RBAC, network policies, deployments, services, secrets, and service mesh configurations
  • Generation of a drift report to guide remediation and updates to architecture docs

Quick Start

Run the drift analysis tool against the architecture document and the live cluster to produce a drift report.

Frequently Asked Questions about analyze-running-cluster

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

FAQPage Schema
How do I detect drift between Kubernetes architecture documentation and a live cluster?▼

You can detect Kubernetes documentation drift by loading architecture files and querying live cluster resources with kubectl or oc. This process produces a drift report detailing matches and discrepancies between documented and deployed states.

What Kubernetes resources can I validate against my architecture docs?▼

You can validate deployments, RBAC, services, secrets, network policies, and service mesh configurations across Kubernetes namespaces. The analysis compares these live cluster resources against your generated architecture files.

Does this drift analysis work with OpenShift clusters?▼

Yes, the analysis supports OpenShift clusters by querying resources with either kubectl or oc commands. It validates architecture files against the live cluster state regardless of which CLI tool you use.

How do I generate a drift report for my Kubernetes deployments and RBAC?▼

Generate a drift report by running the analysis tool against your GENERATED_ARCHITECTURE.md file and the live cluster. The report identifies mismatches in deployments, RBAC, and services to guide remediation.

Can I check service mesh configurations against my Kubernetes architecture documentation?▼

Yes, service mesh configurations are included in the drift validation scope. The analysis compares live service mesh settings across namespaces against your architecture documentation to identify discrepancies.

Related Skills

Explore More Software Engineering Skills→
paulanunes85paulanunes85
1

kubectl-cli

Execute kubectl commands to diagnose and fix Kubernetes cluster issues in AKS and ARO environments.

Community
Intermediate
anton-abyzovanton-abyzov
156

kafka-kubernetes

Deploy and operate Apache Kafka on Kubernetes with Strimzi or Confluent Operator.

Community
Advanced
zhanbei1zhanbei1
1

Kubernetes

Guide Kubernetes deployment manifests for resources, probes, labels, and RBAC.

Community
Intermediate
qwedsazxc78qwedsazxc78
10

kustomize-resource-validation

Validate Kubernetes kustomization.yaml files for references, orphans, and consistency.

Community
Intermediate