repository-and-state-strategy

What problem does it solve?

This Skill addresses the complexity and risk associated with managing cloud infrastructure using Terraform, particularly concerning state management and repository organization, to prevent costly errors and enable scalable deployments.

Core Features & Use Cases

• Repository Strategy: Guides decisions between mono-repo and multi-repo approaches based on change cadence and ownership.
• Layered Architecture: Implements a numbered layer system (00-90) within repositories to define explicit dependency order.
• State Management: Enforces a strict "one state file per layer per environment" rule for isolation and blast radius containment.
• Cross-Layer Dependencies: Demonstrates how to safely reference outputs from lower layers using terraform_remote_state.
• Use Case: When setting up a new cloud environment, this Skill helps define a robust Terraform structure that minimizes the risk of accidental data loss or service disruption during deployments.

Quick Start

Use the repository-and-state-strategy skill to define a multi-repository structure with numbered layers for a new AWS environment.