Skip to content
Awesome LLM

uhg-grid

UHG Grid multi-cloud service mesh knowledge base with DNS patterns, Terraform registration, security model, and troubleshooting

v11.3.0
Claude Code

By Thomas Hudak ([email protected])

Plugin Structure

🤖
1
Agents
⚡
0
Skills
⌨️
6
Commands
🪝
2
Hooks
📋
0
Rules

Installation

Install this plugin using the Claude Code CLI:

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

Verification

After installation, verify the plugin is loaded:

claude plugin list

Documentation

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:

SkillTrigger 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:

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:

Credits

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

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