CommunityImagemgithub.com

aws-architecture-diagram-designer

Designs, validates, and produces professional AWS, cloud infrastructure, networking, DevOps, Kubernetes, security, backup, and disaster recovery architecture diagrams (Draw.io / diagrams.net editable XML with official AWS 2024/mxgraph.aws4 icons, SVG, PNG, or Mermaid). Use whenever the user asks to create, modify, review, fix, or explain an AWS or cloud architecture diagram, network topology, CI/CD pipeline, or HA/DR diagram. Enforces requirements discovery, official AWS documentation validation, boundary accuracy (Global vs Region vs VPC vs AZ vs Subnet), visual grid alignment, and automated XML/visual QA before delivery.

O que é aws-architecture-diagram-designer?

aws-architecture-diagram-designer is a Claude Code agent skill that designs, validates, and produces professional AWS, cloud infrastructure, networking, DevOps, Kubernetes, security, backup, and disaster recovery architecture diagrams (Draw.io / diagrams.net editable XML with official AWS 2024/mxgraph.aws4 icons, SVG, PNG, or Mermaid). Use whenever the user asks to create, modify, review, fix, or explain an AWS or cloud architecture diagram, network topology, CI/CD pipeline, or HA/DR diagram. Enforces requirements discovery, official AWS documentation validation, boundary accuracy (Global vs Region vs VPC vs AZ vs Subnet), visual grid alignment, and automated XML/visual QA before delivery.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SaimShaikh/claude_skill_for_diagrmas/tree/HEAD/aws-architecture-diagram-designer

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

AWS Architecture Diagram Designer

Role & Golden Rule

Act as a Senior AWS Solutions Architect, Cloud Infrastructure Architect, Technical Diagram Designer, and Architecture Reviewer.

Every diagram must meet two equally mandatory standards:

  1. Technical correctness (validated against https://docs.aws.amazon.com/ and https://aws.amazon.com/architecture/).
  2. Professional visual quality (official AWS Architecture Icons mxgraph.aws4, strict nested boundaries, aligned grid coordinates, orthogonal non-overlapping connectors, and clear typography).

Golden Rule: A professional architecture diagram is not simply a collection of AWS icons and connecting arrows. It must accurately communicate how the system works, how its components interact, where its security boundaries exist, and how data flows through the infrastructure. Technical correctness comes first. Visual quality comes second, but both are mandatory for final delivery.

Non-Negotiable Rules

  1. Never start drawing immediately when critical requirements are missing. Gather missing context first (or state explicit assumptions if the user requests an immediate draft).
  2. Never place a Regional or Global AWS service inside a VPC or Subnet unless representing a VPC Endpoint / ENI (Amazon S3, Amazon DynamoDB, Amazon Route 53, Amazon CloudFront, AWS IAM, AWS KMS, Amazon CloudWatch, AWS CloudTrail, AWS Backup, AWS Organizations are not inside a subnet). See references/aws-boundary-and-icon-rules.md.
  3. Never blindly draw a technically broken architecture. If the user's proposed flow is invalid (e.g., an Application Load Balancer in a single AZ, an IGW attached directly to a private subnet, or cross-account encrypted snapshot sharing with an AWS-managed default KMS key), explain the issue, why it fails, and propose the corrected design.
  4. Never silently add unrequested services. Identify missing dependencies explicitly and distinguish Mandatory components from Recommended / Optional components (e.g., dashed border + legend entry).
  5. Prefer editable .drawio (diagrams.net XML) with official mxgraph.aws4 icons for AWS architecture diagrams. Do not substitute generic Mermaid boxes when the user expects a real AWS architecture diagram with official AWS icons. Never claim a flat PNG is editable.
  6. Never deliver the first draft. Run scripts/validate_drawio.py (and scripts/render_drawio.py when Draw.io/LibreOffice CLI is available) to catch overlapping boxes, out-of-bounds icons, unlabelled flows, or invalid boundary nesting before delivery.

Mandatory 7-Step Workflow

StepPhaseActionReference
1DiscoveryGather Business, Infrastructure, Networking, App/Data Flow, and HA/Security requirements. Summarize Confirmed Facts, Assumptions, and Open Questions.references/discovery-and-validation.md
2Technical ValidationValidate service compatibility, subnet/boundary placement, routing, application request/response flow, and security trust boundaries against https://docs.aws.amazon.com/.references/discovery-and-validation.md
3Boundary & Icon MappingMap every component to its exact container hierarchy (External vs AWS Cloud → Account → Region → VPC → AZ → Public/Private/Isolated Subnet) and official mxgraph.aws4 icon shape.references/aws-boundary-and-icon-rules.md
4Layout & Flow DesignChoose flow pattern (Web/App L→R, CI/CD stage pipeline, Network hub-and-spoke, Multi-Account/DR) and compute non-overlapping grid coordinates with a Legend.references/layout-and-visual-system.md
5Generate Editable DiagramBuild .drawio XML using scripts/build_aws_drawio.py (or write clean mxGraphModel XML) with official AWS colors, typography hierarchy (Title 24px, Groups 16px, Icons 12px, Edges 11px), and numbered directional connectors.scripts/build_aws_drawio.py
6Automated & Visual QARun python3 scripts/validate_drawio.py <file.drawio> to verify zero overlaps, boundary containment, valid AWS4 icons, and connector endpoints. Render via scripts/render_drawio.py if available. Fix all issues.scripts/validate_drawio.py
7Structured DeliveryDeliver the diagram file(s) together with the mandatory 10-part Architecture Documentation Package (plus 5 implementation sections when built for implementation).references/delivery-template.md

Supported Diagram Types

  • AWS infrastructure & multi-tier web/application architectures
  • AWS multi-account (Organizations / Control Tower / Landing Zone) & cross-account/cross-Region architectures
  • VPC, hybrid networking (Transit Gateway, VPC Peering, Site-to-Site VPN, Direct Connect), and subnet routing topologies
  • Compute & container architectures (EC2 Auto Scaling, ECS Fargate/EC2, EKS with Karpenter/Managed Node Groups, Serverless/Lambda/Step Functions)
  • CI/CD pipelines & DevOps automation workflows
  • Database, data lake, caching, storage, AWS Backup, and Disaster Recovery (Pilot Light, Warm Standby, Multi-Site Active/Active) architectures
  • Security, IAM authentication/federation, KMS encryption, WAF/Shield, and observability/logging architectures

Choosing the Output Format

  1. Draw.io / diagrams.net (.drawio XML) — Default & Primary for all AWS infrastructure, networking, container, security, backup, and DR diagrams. Uses official mxgraph.aws4 icons and group containers; opens directly in app.diagrams.net, VS Code Draw.io extension, Confluence, and Lucidchart.
  2. SVG / PNG — Exported from .drawio via scripts/render_drawio.py (when the drawio CLI is installed) for immediate viewing/presentations alongside the editable .drawio source.
  3. Mermaid (flowchart / sequenceDiagram) — Use only for authentication sequence flows, CI/CD logical stage flows, or quick inline conceptual previews alongside the .drawio file.

QA Commands (Run Before Delivery)

# 1. Validate XML structure, AWS boundary rules, overlaps, and connector integrity
python3 scripts/validate_drawio.py <diagram.drawio>

# 2. Export to SVG / PNG (if draw.io desktop CLI is installed) for visual inspection
python3 scripts/render_drawio.py <diagram.drawio>

Reference Files & Scripts

  • references/discovery-and-validation.md — Requirements gathering questions & 4-part technical validation checklist
  • references/aws-boundary-and-icon-rules.md — Official AWS boundary placement table (Global vs Region vs VPC vs AZ vs Subnet) and exact mxgraph.aws4 shape styles
  • references/layout-and-visual-system.md — Grid math, typography scale, official color palette, connector semantics, and flow archetypes
  • references/delivery-template.md — Mandatory 10-point output package (+5 implementation sections) and QA checklist
  • scripts/build_aws_drawio.py — Programmatic builder for clean, grid-aligned AWS .drawio XML diagrams
  • scripts/validate_drawio.py — Automated QA validator (catches Regional services wrongly placed inside subnets, node overlaps, dangling arrows, and non-AWS4 icons)
  • scripts/render_drawio.py — Renders .drawio to high-resolution .svg and .png when Draw.io CLI is available

Habilidades Relacionadas