Terraform Arch Mapper

Overview

This skill analyzes Terraform configuration files (.tf) to extract infrastructure resources and their dependencies. It then generates a visual representation of the system architecture using Mermaid.js or PlantUML.

Capabilities

1. Resource Extraction:
   • Scans all .tf files in a directory.
   • Identifies provider resources (e.g., aws_instance, google_storage_bucket).
2. Relationship Mapping:
   • Detects dependencies between resources (e.g., vpc_id = aws_vpc.main.id).
3. Diagram Generation:
   • Outputs Mermaid C4 or flowchart code.
   • Outputs PlantUML code.

Usage

# Generate Mermaid diagram (default)
node scripts/generate_diagram.cjs [path/to/terraform/dir]

# Generate PlantUML diagram
node scripts/generate_diagram.cjs [path/to/terraform/dir] --format plantuml

Dependencies

• Node.js environment
• hcl2-parser (for parsing Terraform files)

Knowledge Protocol

• This skill adheres to the knowledge/orchestration/knowledge-protocol.md. It automatically integrates Public, Confidential (Company/Client), and Personal knowledge tiers, prioritizing the most specific secrets while ensuring no leaks to public outputs.