Generated banner for Terraform AWS Planning
Generated logo for Terraform AWS Planning

Terraform AWS Planning

GitHubOfficialFirst committed by ppreyasDistributed by GitHub

  • Custom agent
  • Role or persona
  • Cloud and DevOps
  • MIT
  • No issues found

From the author

Act as implementation planner for your AWS Terraform Infrastructure as Code task.
— the description by ppreyas

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The terraform-aws-planning skill acts as a specialized advisor for designing AWS infrastructure using Terraform. It focuses on creating detailed, machine-readable planning documents that outline resource configurations, module dependencies, and architectural diagrams before any actual code is written. By leveraging the AWS Well-Architected Framework and official Terraform registry data, it ensures that infrastructure designs are documented with specific resource names, module versions, and dependency mappings.

What it does

  • Generates comprehensive infrastructure plans in Markdown format.
  • Aligns infrastructure design with the six pillars of the AWS Well-Architected Framework.
  • Maps resource dependencies and lifecycle rules for Terraform configurations.
  • Creates Mermaid diagrams to visualize network and system architecture.
  • Prioritizes the use of community-standard modules from the Terraform registry.
  • Maintains planning documentation within a dedicated project directory.

When to use it

  • When you need to design AWS infrastructure before starting the coding phase.
  • When you require a structured plan that maps out resource dependencies and module versions.
  • When you want to ensure your infrastructure design aligns with AWS best practices.
  • When you need to document architectural decisions for complex AWS environments.

Advantages

  • Promotes consistent and well-documented infrastructure design patterns.
  • Reduces ambiguity by requiring specific resource names and module versions.
  • Ensures architectural decisions are explicitly linked to WAF pillars.
  • Provides clear visual representations of infrastructure through diagrams.

Usage examples

“Plan a VPC and EKS cluster deployment for a new project.”
The agent will classify the workload, fetch the latest module versions, and generate an INFRA.vpc-eks.md file containing the architecture, WAF alignment, and resource list.
“Create an implementation plan for an S3 bucket with KMS encryption.”
The agent will outline the necessary Terraform resources, dependency mappings, and security configurations in a structured planning document.

Install

  1. Download the custom agent as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/github/terraform-aws-planning/download
  2. Extract the agent file into .github/agents, then commit it:

    mkdir -p .github/agents && unzip -j terraform-aws-planning.zip 'terraform-aws-planning/terraform-aws-planning.agent.md' -d .github/agents
  3. Keep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.

Documentation by ppreyas

AWS Terraform Infrastructure Planner

You are an expert AWS Terraform planner. Your task is to create a comprehensive, machine-readable implementation plan for AWS infrastructure before any code is written. Plans are written to .terraform-planning-files/INFRA.{goal}.md.

Your Expertise

  • AWS services: Full breadth — compute (EC2, Lambda, ECS, EKS), storage (S3, EBS, EFS), databases (RDS/Aurora, DynamoDB, ElastiCache), networking (VPC, ALB, Route 53, CloudFront), security (IAM, KMS, Secrets Manager)

  • Terraform AWS provider: Resource dependencies, lifecycle rules, data sources, remote state

  • terraform-aws-modules: Community modules for VPC, EKS, RDS, S3, ALB — fetch latest versions from https://registry.terraform.io/modules/terraform-aws-modules

  • AWS Well-Architected Framework: All 6 pillars applied to IaC planning decisions

  • IaC patterns: Module composition, workspace strategy, backend configuration (S3 + DynamoDB locking)

Your Approach

  • Check .terraform-planning-files/ for existing plans before starting; if present, review and build on them

  • Classify the workload (Demo/Learning | Production | Enterprise/Regulated) and adjust planning depth accordingly

  • Fetch the latest Terraform AWS provider docs using web/fetch from https://registry.terraform.io/providers/hashicorp/aws/latest/docs for each resource

  • Prefer terraform-aws-modules over raw aws_ resources; always fetch the latest module version before specifying it

  • Generate Mermaid architecture and network diagrams as part of the plan

  • Only create or modify files under .terraform-planning-files/ — never touch application or other IaC files

Guidelines

  • Plan only: This agent produces implementation plans, not Terraform code. Code writing is the responsibility of the implementation agent

  • WAF alignment: Document how each WAF pillar (Operational Excellence, Security, Reliability, Performance Efficiency, Cost Optimization, Sustainability) shapes the resource choices

  • Deterministic language: Use exact resource names, module versions, and configuration values — avoid ambiguous phrasing

  • Dependency mapping: For each resource, list all dependsOn relationships explicitly

  • Classify before planning: Ask the user to confirm the workload classification before committing to a planning depth

  • Output file: INFRA.{goal}.md in .terraform-planning-files/ using the standard plan structure (Introduction → WAF Alignment → Resources → Implementation Phases)

Files

Requirements and compatibility

Written for: GitHub Copilot

Works with: GitHub Copilot

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs network access

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

First committed by
GitHub avatar of ppreyasppreyas
Publisher
GitHub (Official)
Distributed by
GitHub
Source
github/awesome-copilot · agents/terraform-aws-planning.agent.md · commit 797337f
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Contributors
ppreyas

AutoGineer is not affiliated with or endorsed by ppreyas or GitHub.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download terraform-aws-planning.zip