UHG Grid - Claude Code Plugin

Expert knowledge and tooling for UHG's Grid multi-cloud service mesh. This plugin provides commands, skills, agents, and coding conventions for teams building on or connecting to the Grid platform.

Who Is This For?

• Application teams registering services on the Grid mesh via Terraform
• Platform engineers troubleshooting Grid connectivity, DNS, and TLS issues
• Infrastructure teams evaluating Grid vs NGCN for cross-cloud networking
• Anyone who needs to understand Grid architecture, security model, or performance characteristics

Installation

Prerequisites

• Claude Code CLI installed
• Access to the otc-awesome-llm repository

Install Steps

1. Add the marketplace (from the otc-awesome-llm repository root):

   claude plugin marketplace add /path/to/otc-awesome-llm
   

2. Install the plugin:

   claude plugin install uhg-grid@otc-awesome-llm
   

3. Verify installation:

   claude plugin list
   # Should show "uhg-grid" in the list
   

Commands

/uhg-grid:grid-register [service-type] - Register a Service

Generate Terraform code for registering a service on the Grid mesh. Walks through node creation, service registration, and health check configuration.

/uhg-grid:grid-register tcp
/uhg-grid:grid-register https
/uhg-grid:grid-register database

/uhg-grid:grid-dns [service-name] - DNS Lookup Helper

Construct and test Grid DNS names. Explains the difference between grid.uhg.com (via gateways) and mesh.uhg.com (direct to instances).

/uhg-grid:grid-dns my-api
/uhg-grid:grid-dns my-service --askid uhgwm110-022715 --region eastus

/uhg-grid:grid-troubleshoot [symptom] - Diagnose Connectivity Issues

Run the structured 5-phase diagnostic workflow for Grid connectivity problems.

/uhg-grid:grid-troubleshoot "service not accessible"
/uhg-grid:grid-troubleshoot "TLS certificate error"
/uhg-grid:grid-troubleshoot "cross-partition timeout"

/uhg-grid:grid-compare - Grid vs NGCN Comparison

Present a factual comparison of Grid and NGCN across performance, security, architecture, and operational metrics.

/uhg-grid:grid-compare
/uhg-grid:grid-compare security
/uhg-grid:grid-compare performance

/uhg-grid:grid-security [topic] - Security Model Reference

Explain Grid's identity-based security model including PKI hierarchy, Vault integration, mTLS, Consul ACLs, and certificate rotation.

/uhg-grid:grid-security
/uhg-grid:grid-security pki
/uhg-grid:grid-security vault

Agent

grid-troubleshooter

An autonomous diagnostic agent that systematically diagnoses DNS, TLS, connectivity, and cross-partition issues using a structured 5-phase workflow.

Activates when:

• Troubleshooting Grid connectivity failures
• Diagnosing DNS resolution problems with grid.uhg.com or mesh.uhg.com
• Investigating TLS/SSL certificate errors through Grid gateways
• Debugging cross-partition (cross-askid) communication failures
• Identifying reserved port conflicts

The agent walks through Symptom Classification, Information Gathering, Diagnostic Command Generation, Output Interpretation, and Remediation Guidance.

Skills

The plugin includes 7 knowledge skills that provide contextual expertise:

Skill	Trigger Phrases
grid-architecture	"grid architecture", "consul", "haproxy", "consul-template"
grid-dns-patterns	"grid dns", "mesh.uhg.com", "grid.uhg.com", "dns resolution"
grid-terraform-registration	"register service", "consul_node", "consul_service", "terraform grid"
grid-security-model	"grid security", "vault", "pki", "mtls", "certificate"
grid-cross-partition	"cross-partition", "cmdb dependency", "upstream", "cross-askid"
grid-performance	"grid performance", "latency", "throughput", "gbps"
grid-vs-ngcn	"grid vs ngcn", "aviatrix", "ngcn comparison", "palo alto"

Instruction

grid-terraform-conventions

Persistent coding conventions automatically loaded when writing Terraform code for Grid service registration. Covers:

• CGNAT IP addressing rules (100.64.0.0/10)
• consul_node + consul_service pairing requirement
• Mandatory health checks for all services
• Tag format (tag_key:<value>)
• Reserved ports to avoid
• Module structure and naming conventions
• Dual TFE cluster guidance (terraform.uhg.com vs tfe-arc.uhg.com)

Support and Resources

Documentation:

• Grid docs: https://docs.hcp.uhg.com/uhg-grid

Teams Channel:

• Search "UHG Grid" in Microsoft Teams

Office Hours:

• Monday, Tuesday, Wednesday, Friday at 9:00 AM CT
• Join via Teams meeting link in the channel

ServiceNow:

• Workgroup: "UHG GRID"
• Request Type: P5 Service Request
• Provide: Subscription/Account ID, regions, VNet/VPC details

Key Repositories:

• https://github.com/uhg-arc/uhg-grid - Multi-cloud shared components
• https://github.com/uhg-arc/uhg-grid-aws - AWS-specific automation
• https://github.com/uhg-arc/uhg-grid-azure - Azure-specific automation
• https://github.com/uhg-arc/uhg-grid-gcp - GCP-specific automation
• https://github.com/uhg-arc/uhg-grid-packages - Building .deb packages for Grid components
• https://github.com/uhg-arc/tfe-initializer - Onboarding automation (Initializers)

Credits

Grid knowledge base authored by Matt Iverson (miverso2_uhg), Grid platform engineer.

Plugin built as part of the otc-awesome-llm project.