AgentSkillsCN

whirlwind-platform-architecture

在 Whirlwind 平台范围内，跨仓库进行架构设计与变更编排（Terragrunt 控制平面、Terraform 基础设施、网络 DNS，以及 Ansible 配置）。适用于设计或实施跨越多个仓库的平台级变更时使用。

SKILL.md
--- frontmatter
name: whirlwind-platform-architecture
description: Cross-repo architecture and change orchestration across the Whirlwind platform (Terragrunt control plane, Terraform infrastructure, networking DNS, and Ansible config). Use when designing or implementing platform-wide changes that span multiple repos.

Whirlwind Platform Architecture

Overview

Coordinate changes that span the full Whirlwind stack across Terragrunt, Terraform infrastructure, networking DNS, and Ansible configuration.

Cross-repo workflow

  1. •Define the change goal and the impacted runtime surface.
  2. •Map the change to repos using references/cross-repo-map.md.
  3. •Identify required contracts (DNS-01, SSM parameters, secrets, IAM roles).
  4. •Sequence the changes so shared networking and infrastructure land before configuration.
  5. •Validate with targeted applies and one environment before scaling out.

Common change patterns

  • •DNS-01 or hosted zone changes: update networking module, then Terragrunt stacks, then workloads.
  • •Ansible pipeline changes: update Terraform infra CI/CD, then Ansible repo variables and scripts.
  • •Compute changes (ASG or NLB): update Terraform infra modules, then Terragrunt wiring, then Ansible inventory strategy.

References

  • •references/cross-repo-map.md
  • •references/dns-01-architecture.md
  • •references/auto-scaling-plan.md
  • •references/operational-contracts.md
  • •references/runbook-dns-change.md
  • •references/runbook-ansible-pipeline-change.md
  • •references/runbook-autoscaling.md