Repolode
Submit
aws-samples

aws-samples/well-architected-iac-analyzer

Sample generative AI tool on Amazon Bedrock that evaluates IaC templates and architecture diagrams against AWS Well-Architected best practices.

View on GitHub
Stars
500
Forks
92
Open issues
9
Last commit
yesterday

What is it?

This sample project uses generative AI on Amazon Bedrock to review infrastructure code and architecture diagrams against AWS Well-Architected best practices. Users upload CloudFormation, Terraform, or AWS CDK templates, complete IaC projects as multiple files or ZIP archives, or architecture diagrams, and receive an assessment of how well the design aligns with those practices along with improvement suggestions.

The web application is built with React and the Cloudscape Design System. Best practices come from AWS Well-Architected whitepapers and are synchronized into an Amazon Bedrock knowledge base. For architecture diagrams, the tool can also generate matching IaC templates. Supporting PDF, TXT, or image documents can be added for extra context, and an Analyzer Assistant chatbot answers questions about the results.

The project is intended for non-production use. Its maintainers note that AWS has introduced a separate Well-Architected Agent in public preview, and that this sample will mainly receive security patches.

Key features

  • 01Analyzes CloudFormation, Terraform, and AWS CDK templates, plus multi-file projects and ZIP archives.
  • 02Assesses architecture diagrams (PNG, JPEG) and can generate IaC templates from them.
  • 03Supports multiple AWS Well-Architected lenses, including custom lenses.
  • 04Prioritizes unapplied best practices on an Eisenhower-style matrix and exports results to CSV.
  • 05Includes a chatbot for follow-up questions about analysis results.
  • 06Lets users choose the Claude model and batch size for parallel question processing at deployment.

Use cases

  • Reviewing infrastructure code for alignment with AWS best practices before deployment.
  • Checking an architecture diagram and generating a starting IaC template from it.
  • Evaluating a workload against a specialized lens such as Serverless or SaaS.
  • Adding internal security or compliance standards as a custom lens.

Topics

#aws#generative-ai#infrastructure-as-code#well-architected#cloudformation#terraform#cdk#amazon-bedrock#aws-well-architected#claude-ai

FAQ

What is well-architected-iac-analyzer?
Sample generative AI tool on Amazon Bedrock that evaluates IaC templates and architecture diagrams against AWS Well-Architected best practices. This sample project uses generative AI on Amazon Bedrock to review infrastructure code and architecture diagrams against AWS Well-Architected best practices. Users upload CloudFormation, Terraform, or AWS CDK templates, complete IaC projects as multiple files or ZIP archives, or architecture diagrams, and receive an assessment of how well the design aligns with those practices along with improvement suggestions.
Is well-architected-iac-analyzer free to use? What license does it have?
well-architected-iac-analyzer is open source under the MIT-0 license. Check the license terms before using it in commercial products.
Is well-architected-iac-analyzer still maintained?
Actively maintained. The last commit to well-architected-iac-analyzer was on Nov 6, 2026.
What can I use well-architected-iac-analyzer for?
Reviewing infrastructure code for alignment with AWS best practices before deployment. Checking an architecture diagram and generating a starting IaC template from it. Evaluating a workload against a specialized lens such as Serverless or SaaS. Adding internal security or compliance standards as a custom lens.
Where can I get well-architected-iac-analyzer?
The source code and installation instructions are on GitHub: https://github.com/aws-samples/well-architected-iac-analyzer

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects