terraform-specialist — субагент для Claude Code: модули и state
Субагент по Terraform: помогает собирать модули, настраивать remote state и ловить drift. Пригодится, когда инфраструктура уже не влезает в один main.tf.
npx claude-code-templates@latest --agent devops-infrastructure/terraform-specialistЧто делает terraform-specialist
Субагент работает с Terraform и инфраструктурой как код: проектирует модули с входными переменными, настраивает backend для remote state, прописывает провайдеров с ограничениями по версиям. Отдельно берётся за workspace для нескольких окружений, импорт существующих ресурсов и обнаружение drift.
Внутри — набор правил, которых агент держится: не повторяться в описаниях, считать state-файлы неприкосновенными и делать бэкап, сначала смотреть plan, потом apply, фиксировать версии провайдеров и брать значения из data sources вместо захардкоженных. На выходе получаются модули, конфигурация backend, требования к провайдерам, скрипты или Makefile для частых операций и pre-commit хуки для валидации. Ещё агент показывает примеры .tfvars и вывод plan вместе с apply.
Инструменты у него простые: Read, Write, Edit и Bash. То есть правки в конфигурации он вносит сам, а команды запускает через шелл — значит, доступ к вашему рабочему каталогу и к провайдеру у него есть. Перед первым запуском стоит убедиться, что Terraform установлен и настроен доступ к вашему backend: без этого plan не построится. Если в проекте уже есть state, который правили руками, сначала сделайте бэкап — агент перестраивает конфигурацию под модульную схему, и расхождения всплывут на первом же плане.
Какие задачи решает
- разложить разросшийся
main.tfна переиспользуемые модули - вынести state в S3, Azure Storage или Terraform Cloud
- зафиксировать версии провайдеров, чтобы сборки не разъезжались
- развести окружения по workspace
- импортировать существующие ресурсы и найти расхождения с конфигурацией
Примеры запросов агенту
- Разбей этот
main.tfна модули с входными переменными и покажи пример.tfvars - Настрой remote state в S3 и добавь ограничения версий для провайдера AWS
- Проверь, есть ли drift между текущим state и конфигурацией, и предложи план импорта
Как установить terraform-specialist
1Через claude-code-templates
npx claude-code-templates@latest --agent devops-infrastructure/terraform-specialist2Вручную: положить файлы
.claude/agents/terraform-specialist.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/terraform-specialist.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/terraform-specialist.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о terraform-specialist
Как установить terraform-specialist в Claude?
Через шаблоны: npx claude-code-templates@latest --agent devops-infrastructure/terraform-specialist. После этого файл агента лежит в .claude/agents/terraform-specialist.md.
Что делает terraform-specialist?
Проектирует модули Terraform, настраивает backend для remote state, прописывает провайдеров с версиями, разводит окружения по workspace и ищет drift. Ещё готовит скрипты для частых операций и pre-commit хуки.
Какие инструменты доступны субагенту?
Read, Write, Edit и Bash. Поэтому он и правит конфигурацию, и запускает команды Terraform в вашем каталоге.
