terraform/stack.yaml at main · agentic-stacks/terraform · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
name: terraform
owner: agentic-stacks
description: >
  Infrastructure as Code provisioning — teaches AI agents to operate
  Terraform and OpenTofu across the full lifecycle: project setup,
  provider configuration, state management, modules, CI/CD integration,
  upgrades, and troubleshooting.

target:
  software: terraform
  versions:
    - ">=1.5"

skills:
  - name: concepts
    entry: skills/foundation/concepts
    description: HCL language, Terraform architecture, provider model, state model, module system
  - name: project-structure
    entry: skills/foundation/project-structure
    description: Workspace-based vs environment-directory patterns with decision guide
  - name: providers
    entry: skills/foundation/providers
    description: Provider configuration, authentication, version pinning; AWS, GCP, Azure guides
  - name: init-plan-apply
    entry: skills/deploy/init-plan-apply
    description: Core workflow — initialization, planning, applying, destroying
  - name: state-backends
    entry: skills/deploy/state-backends
    description: Backend selection and configuration for S3, GCS, Azure Blob, TF Cloud, PostgreSQL
  - name: modules-consuming
    entry: skills/deploy/modules/consuming
    description: Finding, using, versioning, and pinning modules from registries
  - name: modules-authoring
    entry: skills/deploy/modules/authoring
    description: Writing reusable modules, input/output design, testing, publishing
  - name: state-management
    entry: skills/operations/state-management
    description: Import, move, remove, taint, replace, refresh operations
  - name: upgrades
    entry: skills/operations/upgrades
    description: Terraform/OpenTofu version upgrades and provider version migrations
  - name: drift-detection
    entry: skills/operations/drift-detection
    description: Detecting and reconciling out-of-band infrastructure changes
  - name: ci-cd
    entry: skills/operations/ci-cd
    description: Pipeline integration for GitHub Actions, GitLab CI, Atlantis, TF Cloud
  - name: common-errors
    entry: skills/diagnose/common-errors
    description: Symptom-based troubleshooting for frequent Terraform errors
  - name: state-recovery
    entry: skills/diagnose/state-recovery
    description: Recovering from state corruption, lock conflicts, and lost state
  - name: known-issues
    entry: skills/reference/known-issues
    description: Version-specific bugs and workarounds for Terraform and OpenTofu
  - name: compatibility
    entry: skills/reference/compatibility
    description: Provider and Terraform/OpenTofu version compatibility matrices
  - name: decision-guides
    entry: skills/reference/decision-guides
    description: Comparison guides for state backends, project layouts, and CI/CD platforms

project:
  structure:
    - environments/
    - modules/
    - .terraform.lock.hcl
    - "*.tf"
    - "*.tfvars"

requires:
  tools:
    - name: terraform
      description: Terraform CLI (or tofu CLI for OpenTofu)

depends_on: []