К основному содержанию
скилл CX Codex

terraform-best-practices · nickcrew — скилл для Claude Code

Скилл terraform-best-practices внедряет инженерные стандарты Terraform: разбиение на модули, блокировку стейта, разделение сред и валидацию в CI/CD.

MIT 109 установок ★ 71 обновлён 2026-06-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NickCrew/Claude-Cortex --skill terraform-best-practices -a claude-code
Открыть на GitHub

Что делает terraform-best-practices

Скилл ориентирует агента на архитектурные правила HashiCorp Terraform и Terragrunt. Он активируется при работе с файлами **/*.tf или путями **/terraform/**. Вместо монолитных манифестов агент предлагает делить инфраструктуру на независимые модули со стандартной файловой структурой: main.tf, variables.tf, outputs.tf, versions.tf и README.md.

Внутри заложены руководства по безопасности стейта через S3 с обязательным шифрованием KMS и блокировками в DynamoDB. Для продакшена предлагается изоляция по директориям, а для сходных контуров — воркспейсы. Для проверок прописаны пайплайны с pre-commit, terraform validate, сканерами tfsec и checkov, а также сквозные тесты на Terratest.

Если в окружении не настроены внешние утилиты проверки вроде tfsec или Go для Terratest, автоматический запуск тестов из предложенных инструкций не сработает.

Какие задачи решает

  • Спроектировать повторно используемые модули с блоками валидации и типами
  • Настроить удалённый бэкенд на базе S3 и DynamoDB с блокировкой состояния
  • Разделить окружения dev, staging и prod через директории или Terragrunt
  • Встроить статический анализ безопасности с tfsec и Checkov в CI/CD пайплайн

Примеры запросов агенту

  • Разбей инфраструктуру VPC на переиспользуемые модули со стандартной структурой файлов
  • Настрой бэкенд в backend.tf с блокировкой через DynamoDB и шифрованием KMS
  • Подготовь pre-commit конфигурацию для проверки terraform fmt и tfsec

Как установить terraform-best-practices

1Через Skills CLI (Vercel)

npx skills add NickCrew/Claude-Cortex --skill terraform-best-practices -a claude-code

2Вручную: положить файлы

~/.claude/skills/terraform-best-practices/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/terraform-best-practices/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о terraform-best-practices

Как установить terraform-best-practices в Claude Code?

Выполните в терминале команду npx skills add NickCrew/Claude-Cortex --skill terraform-best-practices -a claude-code.

Что делает скилл terraform-best-practices?

Он задаёт правила проектирования инфраструктуры как кода: стандарты оформления модулей, защиту стейта, многосредовую изоляцию и проверки безопасности.

Какие инструменты безопасности рекомендует этот скилл?

В процессах валидации применяются сканеры tfsec, Checkov и Terrascan, а управление секретами выносится в AWS Secrets Manager или HashiCorp Vault.

Исходный текст

SKILL.md · MIT
---
name: terraform-best-practices
description: Terraform infrastructure-as-code best practices for scalable and maintainable cloud infrastructure. Use when writing Terraform modules, managing infrastructure state, or implementing infrastructure automation at scale.
keywords:
  - HCL
  - IaC
  - infrastructure as code
  - infrastructure automation
  - remote state
  - state management
  - terraform
  - terraform module
  - terraform workspace
  - terragrunt
file_patterns:
  - '**/*.tf'
  - '**/terraform/**'
confidence: 0.9
---

# Terraform Best Practices

Expert guidance for building production-grade Terraform infrastructure with enterprise patterns for module design, state management, security, testing, and multi-environment deployments.

## When to Use This Skill

- Writing reusable Terraform modules for teams or organizations
- Setting up secure remote state management and backend configuration
- Designing multi-environment infrastructure (dev/staging/prod)
- Implementing infrastructure CI/CD pipelines with automated validation
- Managing infrastructure at scale across multiple teams or projects
- Migrating from manual infrastructure to infrastructure-as-code
- Refactoring existing Terraform for better maintainability
- Implementing security best practices for infrastructure code

## Core Concepts

### Module Design Philosophy
- **Composition over monoliths**: Break infrastructure into reusable child modules
- **Standard structure**: main.tf, variables.tf, outputs.tf, versions.tf, README.md
- **Type constraints**: Use validation blocks and complex types for safety
- **Dynamic blocks**: Enable flexible configuration without duplication

### State Management Principles
- **Remote backends**: S3+DynamoDB or Terraform Cloud for team collaboration
- **State encryption**: KMS encryption at rest and in transit (mandatory)
- **State locking**: Prevent concurrent modifications with DynamoDB
- **Workspace strategy**: Directory-based for production, workspaces for similar envs

### Security Fundamentals
- **Secret management**: AWS Secrets Manager, HashiCorp Vault (never hardcode)
- **Least privilege**: Separate IAM roles per environment
- **Security scanning**: tfsec, Checkov, Terrascan in CI/CD
- **Resource tagging**: Enable cost tracking, ownership, compliance

### Testing & Validation
- **Pre-commit hooks**: Format, validate, lint before commits
- **Plan review**: Always save and review plans before apply
- **Automated testing**: Terratest for critical infrastructure modules
- **Policy as code**: OPA/Sentinel for compliance enforcement

## Quick Reference

| Task | Load reference |
| --- | --- |
| Module structure, variables, outputs, dynamic blocks | `skills/terraform-best-practices/references/module-design.md` |
| Remote backends, state encryption, workspace strategies | `skills/terraform-best-practices/references/state-management.md` |
| Variable precedence, tfvars, Terragrunt DRY config | `skills/terraform-best-practices/references/environment-management.md` |
| Secrets, IAM, scanning tools, resource tagging | `skills/terraform-best-practices/references/security.md` |
| Pre-commit hooks, Terratest, policy as code | `skills/terraform-best-practices/references/testing-validation.md` |
| Comprehensive checklist for all areas | `skills/terraform-best-practices/references/best-practices-summary.md` |

## Workflow

### 1. Project Setup
```bash
# Initialize directory structure
mkdir -p {modules,environments/{dev,staging,prod}}

# Set up remote backend (bootstrap S3 + DynamoDB first)
# Configure backend.tf with encryption and locking
```

### 2. Module Development
```bash
# Create module with standard structure
cd modules/my-module
touch main.tf variables.tf outputs.tf versions.tf README.md

# Add validation to variables
# Use complex types for structured inputs
# Document outputs with descriptions
```

### 3. Security Hardening
```bash
# Mark sensitive variables
# Use secret management for credentials
# Configure state encryption
# Set up security scanning in CI/CD
```

### 4. Testing Pipeline
```bash
# Install pre-commit hooks
pre-commit install

# Run validation locally
terraform init
terraform validate
terraform fmt -check

# Security scanning
tfsec .
checkov -d .

# Automated tests (critical modules)
cd tests && go test -v
```

### 5. Deployment Process
```bash
# Plan with output file
terraform plan -out=tfplan

# Review plan thoroughly
terraform show tfplan

# Apply only after approval
terraform apply tfplan

# Verify deployment
terraform output
```

### 6. Multi-Environment Management
```bash
# Use directory-based isolation for production
cd environments/prod
terraform init
terraform workspace list

# Or use Terragrunt for DRY backend config
terragrunt plan
```

## Common Mistakes

❌ **Hardcoding secrets in code** → Use secret management services
❌ **No state locking** → Enable DynamoDB locking to prevent conflicts
❌ **Skipping plan review** → Always save and review execution plans
❌ **No version constraints** → Pin provider and module versions
❌ **Local state in teams** → Use remote backends for collaboration
❌ **No security scanning** → Integrate tfsec/Checkov in CI/CD
❌ **Missing resource tags** → Tag all resources for cost/ownership tracking
❌ **No automated testing** → Write Terratest for critical modules
❌ **Monolithic modules** → Break into composable child modules
❌ **No backup strategy** → Enable S3 versioning on state buckets

## Resources

- **Official Docs**: https://developer.hashicorp.com/terraform/docs
- **Style Guide**: https://developer.hashicorp.com/terraform/language/syntax/style
- **Module Registry**: https://registry.terraform.io/
- **Terragrunt**: https://terragrunt.gruntwork.io/
- **Terratest**: https://terratest.gruntwork.io/
- **tfsec**: https://aquasecurity.github.io/tfsec/
- **Checkov**: https://www.checkov.io/
- **Best Practices**: https://www.terraform-best-practices.com/
- **AWS Provider**: https://registry.terraform.io/providers/hashicorp/aws/latest/docs

© NickCrew · MIT · NickCrew/Claude-Cortex

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — terraform-best-practices от других авторов.

terraform-best-practices c0x12c Скилл terraform-best-practices помогает писать и проверять Terraform-код по правилам организации файлов, модулей, состояния и безопасности. Пригодится при настройке инфраструктуры AWS. CX Codex +1 ★ 111звёзд репо terraform-expert PCL Team Скилл terraform-expert для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который даёт агенту экспертизу по Terraform: модули, remote state, жизненный цикл ресурсов. CX Codex +1 190установок terraform-generator akin-ozer Скилл terraform-generator для Claude Code пишет конфигурации Terraform: ресурсы, модули, провайдеры, переменные и outputs. Генерирует набор .tf файлов и проверяет их через валидатор, пока конфигурация не пройдёт все проверки. CX Codex +1 713установок terraform microsoft Задаёт соглашения для Terraform-кода: структуру файлов, именование ресурсов и переменных, работу с модулями и выражениями. Применяется к .tf и .tfvars. CX Codex +1 ★ 1 627звёзд репо terraform-skill Anton Babenko Диагностирует риски и управляет кодом Terraform и OpenTofu в ассистенте. Помогает при рефакторинге модулей, миграциях стейта и настройке безопасного пайплайна. CX Codex +1 8 200установок terraform-stacks hashicorp Помогает описывать конфигурации Terraform Stacks, связывать модули в компоненты и настраивать файлы развёртывания для мультирегиональной инфраструктуры. CX Codex +1 5 900установок terraform-infrastructure manutej Скилл terraform-infrastructure учит агента писать код Terraform на HCL: настраивать провайдеров AWS и Azure, собирать модули, валидировать переменные и разделять стейт по окружениям. CX Codex +1 439установок

Из того же набора21

Весь набор →
secure-coding-practices Скилл secure-coding-practices для Claude Code помогает применять защитные практики при работе с авторизацией, пользовательским вводом и чувствительными данными. Подключается и для проверки кода на уязвимости. CX Codex +1 134установок ux-review Скилл ux-review проверяет компонент или поток с трёх сторон: удобство, доступность по WCAG 2.1 AA и поведение интерфейса. Отдаёт отчёт с находками по приоритетам. CX Codex +1 119установок event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы на событиях: event sourcing, CQRS, саги и обмен сообщениями. Охватывает микросервисы и распределённые транзакции. CX Codex +1 118установок dashboard-designer Скилл dashboard-designer для Claude Code помогает спроектировать дашборд: выбрать KPI, расположить блоки и настроить визуальную иерархию. Запускается на запросы о структуре панели мониторинга или выборе BI-инструмента. CX Codex +1 109установок mermaid-diagramming Скилл mermaid-diagramming учит агента рисовать диаграммы Mermaid: блок-схемы, sequence-диаграммы, ERD, состояния, Gantt и архитектурные виды, отдельно базовую и стилизованную версию. CX Codex +1 105установок kubernetes-security-policies Скилл kubernetes-security-policies для Claude Code помогает настроить Pod Security Standards, сетевые политики и RBAC в Kubernetes. Ужесточает защиту прод-окружения. CX Codex +1 104установок user-journey-mapping Скилл user-journey-mapping для Claude Code помогает составить карту пути пользователя с этапами, точками контакта, эмоциями и проблемами. Запускается при анализе пользовательского опыта или конверсии. CX Codex +1 102установок tutorial-design Скилл tutorial-design помогает проектировать пошаговые туториалы, воркшопы и практические руководства с контрольными точками и разбором частых ошибок. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой