trace-manifestwork

What problem does it solve?

This skill helps trace ManifestWork resources through the Maestro system to find relationships between user-created work names, database resource IDs, and applied manifests, or to debug manifest application issues across the management cluster and database.

Core Features & Use Cases

• Bidirectional tracing between: User-created work name, Database Resource ID, AppliedManifestWork, and deployed manifests
• Cross-cluster visibility: query service cluster (database) and management cluster (AppliedManifestWorks and manifests) to assemble a complete trace
• Debug lifecycle issues: creation, update, and deletion flows, including verification of what was applied vs. what exists in the cluster
• Use Case examples: determine resource ID from a work name, locate the AppliedManifestWork for a manifest, or verify what manifests are tied to a work

Quick Start

• Trace by Resource ID: .claude/skills/trace-manifestwork/scripts/trace.sh --resource-id "<resource-id>"
• Trace by Manifest: .claude/skills/trace-manifestwork/scripts/trace.sh --manifest-kind deployment --manifest-name maestro-e2e-upgrade-test --manifest-namespace default --svc-context <svc-context> --mgmt-context <mgmt-context>
• Trace by User Work Name: .claude/skills/trace-manifestwork/scripts/trace.sh --work-name "<work-name>"