terraform-diagrams

Terraform Diagram Generator

Generates architecture diagrams directly from Terraform .tf files. Specializes in parsing Terraform code and visualizing infrastructure resources, modules, and their relationships.

When to Use

Activate this skill when:

• User has Terraform files (.tf, .tfvars) and wants to visualize the infrastructure
• User asks to "diagram my Terraform" or "visualize this infrastructure"
• User mentions Terraform, HCL, or infrastructure-as-code
• User wants to see the architecture of their Terraform-managed resources

How It Works

This skill generates Terraform-specific diagrams by parsing Terraform code and calling the Eraser API directly:

1. Parse Terraform Files: Identify resources, modules, data sources, and variables
2. Extract Relationships: Map dependencies, resource connections, and module hierarchies
3. Generate Eraser DSL: Create Eraser DSL code from Terraform resources
4. Call Eraser API: Use /api/render/elements with diagramType: "cloud-architecture-diagram"

Instructions

When the user provides Terraform code:

1. Parse the Terraform

   • Identify all resource blocks (AWS, Azure, GCP, etc.)
   • Extract module blocks and their configurations
   • Note data sources and their dependencies
   • Identify variable and output definitions

2. Map Relationships

   • Track resource dependencies (e.g., subnet_id = aws_subnet.public.id)
   • Group resources by provider (AWS, Azure, GCP)
   • Identify VPCs/VNets as containers for other resources
   • Note security groups, IAM roles, and networking rules

3. Generate Eraser DSL Convert Terraform resources to Eraser DSL:

   • CRITICAL: Label Formatting Rules
     • Labels MUST be on a single line - NEVER use newlines inside label attributes
     • Keep labels simple and readable - prefer separate labels over concatenating too much metadata
     • Format DSL with proper line breaks (one node/group per line, but labels stay on single lines)
     • If including metadata like CIDR blocks or instance types, include them in the same quoted label string: [label: "VPC 10.0.0.0/16"]