| name | nvcf-explore-stack |
| description | Navigate and explain the NVCF self-hosted stack inside the monorepo. Maps helmfile releases to their charts, image-source subtrees, helm hooks, namespaces, and `needs:` dependency chains. Reads deploy/stacks/self-managed/helmfile.d/*.yaml.gotmpl and deploy/stacks/nvcf-compute-plane/helmfile.d/*.yaml.gotmpl as the source of truth for ordering and versions. Use when a user or developer asks "what deploys X", "what does X depend on", "what hooks run for X", "walk me through deployment order", "which subtree do I edit to change X", "what namespaces does the stack use", or mentions stack topology, helmfile stages, deployment DAG, or dependency map. |
| license | Apache-2.0 |
| compatibility | Requires a local checkout of the NVCF monorepo with deploy/stacks/self-managed/ and deploy/stacks/nvcf-compute-plane/ present |
| author | nvcf-core-eng <nvcf-core-eng@exchange.nvidia.com> |
| version | 1.1.0 |
| tags | ["nvcf","self-managed","self-hosted","helmfile","deployment","stack-topology"] |
| tools | ["Read","Grep","Glob"] |
| metadata | {"internal":false,"author":"nvcf-core-eng <nvcf-core-eng@exchange.nvidia.com>","version":"1.1.0","tags":["nvcf","self-managed","self-hosted","helmfile","deployment","stack-topology","dependencies","hooks"],"languages":["yaml","markdown"],"frameworks":["helmfile","helm","kubernetes"],"domain":"cloud-infrastructure"} |
NVCF Explore Stack
Help a user or developer navigate the NVCF self-hosted stack inside the monorepo. Identify what a release is, what installs it, what it depends on, and which subtree owns the chart and the runtime image.
Instructions
This skill is for both NVCF users and NVCF developers. Users use it to understand stack dependencies, deployment order, and CI/CD migration questions. Developers use it to find the owning chart, source subtree, hook, or helmfile stage before making changes.
Use this skill long enough to answer the question, then hand off to the right execution skill. Always cite the source file path so the user can verify.
Required inputs
Read these from the monorepo root.
Authoritative (always read first when answering):
deploy/stacks/self-managed/helmfile.d/00-observability-infrastructure.yaml.gotmpldeploy/stacks/self-managed/helmfile.d/01-dependencies.yaml.gotmpldeploy/stacks/self-managed/helmfile.d/02-core.yaml.gotmpldeploy/stacks/self-managed/helmfile.d/03-observability.yaml.gotmpldeploy/stacks/observability/helmfile.d/01-observability.yaml.gotmpldeploy/stacks/nvcf-compute-plane/helmfile.d/01-dependencies.yaml.gotmpldeploy/stacks/nvcf-compute-plane/helmfile.d/02-nvca.yaml.gotmpl
Chart-level (when the chart is checked into the monorepo):
deploy/helm/<chart>/Chart.yamldeploy/helm/<chart>/values.yaml
Common questions
What deploys X
: Look up release X in the helmfile stage files. Return chart name, version, namespace, and which gotmpl file declares it. If the chart is checked in, also point at deploy/helm/<chart>/.
What does X depend on
: Return the needs: chain for that release plus the stage gate it sits behind (control-plane stages 0 -> 1 -> 2 -> 3, then compute-plane). Include any profile, condition:, or component mode that gates whether X deploys at all.
What hooks run for X
: Read the checked-in chart under deploy/helm/<chart>/ when available. Search its templates/ directory for Helm hook annotations, weights, hook events (pre-install / post-install), images used, and purpose. Cite the chart-relative template file path. If the chart is not checked in, cite its Helmfile chart reference and state that local templates are unavailable.
Walk me through the full deployment order
: Summarize control-plane stages 0 through 3 from the self-managed gotmpl files. Stage 0 delegates to the shared observability Helmfile when is enabled. Stage 3 installs State Metrics and the function autoscaler for and . Then summarize the compute-plane stage from and . Call out which releases run in parallel inside a stage and which are serialized by .
