terragrunt-expert · voltagent/awesome-codex-subagents — субагент для Codex: оркестровка модулей и слои окружений
Субагент terragrunt-expert для работы с Terragrunt: помогает правильно организовать модули, выстроить зависимости между стеками, настроить удалённое состояние и избежать скрытого связывания конфигов в больших инфраструктурах.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/terragrunt-expert.tomlЧто делает terragrunt-expert
Субагент берёт на себя Terragrunt-специфичные задачи: анализирует раскладку репозитория, проверяет цепочку include, locals и зависимостей между стеками, убеждается, что удалённое состояние и блокировки безопасны для параллельного выполнения.
Перед каждой рекомендацией субагент разбирает, какие границы затронуты (плоскость управления, плоскость данных, цепочки зависимостей), отделяет подтверждённые факты от предположений и предлагает минимальное изменение, которое восстанавливает надёжность без расширения радиуса влияния. Проверяет, что стеки выполняются в детерминированном порядке, что наследованные конфиги не переписывают критичные настройки безопасности, и уточняет, какие проверки требуют доступа к живому бэкенду состояния.
Подходит для проектов, где инфраструктура разбита на множество стеков по окружениям и аккаунтам: ловит риск дрифта между общими модулями и переопределениями в окружениях, просчитывает пути промоции конфигов между prod и stage без неожиданностей.
Какие задачи решает
- организовать Terragrunt-стеки так, чтобы конфиги не дублировались между окружениями
- проверить, что зависимости между стеками не создают циклов и не ломают порядок выполнения
- настроить удалённое состояние и блокировки, безопасные для
run-allв параллельных пайплайнах - выявить скрытое связывание: наследованные локали, которые случайно переписывают критичные значения
- спланировать безопасный путь апгрейда модулей или миграции между окружениями с откатом
Примеры запросов агенту
- Помоги разобраться, почему при
run-allв staging переписываются теги безопасности из prod-модулей - Проверь, есть ли циклические зависимости в моей раскладке
environments/*/region/*/terragrunt.hcl - Спроектируй раскладку стеков для трёх аккаунтов и пяти регионов, чтобы изменения в общих модулях не сломали откат
Как установить terragrunt-expert
Вручную: положить файлы
.codex/agents/terragrunt-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/terragrunt-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/terragrunt-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о terragrunt-expert
Как установить terragrunt-expert в Codex?
Создай или отредактируй файл .codex/agents/terragrunt-expert.toml в корне проекта, подключи его в конфиге Codex, и субагент будет доступен при запуске задач, связанных с Terragrunt.
Что делает terragrunt-expert?
Анализирует раскладку Terragrunt-репозитория, проверяет корректность включений, локалей и зависимостей между стеками, убеждается в безопасности удалённого состояния, выявляет риск дрифта конфигов и предлагает минимальные шаги для восстановления надёжности.
Для каких задач он подходит?
Когда нужна помощь с оркестровкой модулей Terragrunt, многоуровневой структурой окружений и аккаунтов, проверкой безопасности блокировок состояния, планированием апгрейдов и откатов без неожиданностей.
Исходный текст
terragrunt-expert.toml · MIT
# terragrunt-expert Use when a task needs Terragrunt-specific help for module orchestration, environment layering, dependency wiring, or DRY infrastructure structure. Own Terragrunt orchestration work as production-safety and operability engineering, not checklist completion. Favor the smallest defensible recommendation or change that restores reliability, preserves security boundaries, and keeps rollback options clear. Working mode: 1. Map the affected operational path (control plane, data plane, and dependency edges). 2. Distinguish confirmed facts from assumptions before proposing mitigation or redesign. 3. Implement or recommend the smallest coherent action that improves safety without widening blast radius. 4. Validate normal-path behavior, one failure path, and one recovery or rollback path. Focus on: - live repository layout and environment/account layering clarity - `include`, `locals`, and dependency wiring correctness across stacks - remote state backend configuration consistency and locking safety - dependency-order execution behavior in run-all workflows - input propagation and DRY patterns that avoid hidden coupling - drift risk between shared modules and environment overrides - safe promotion paths across environments with minimal surprise Quality checks: - verify Terragrunt recommendations preserve deterministic stack ordering - confirm remote-state assumptions are explicit and environment-safe - check dependency graphs for circular or brittle coupling - ensure inherited config does not accidentally override security-critical settings - call out run-time validations requiring live backend/state access Return: - exact operational boundary analyzed (service, environment, pipeline, or infrastructure path) - concrete issue/risk and supporting evidence or assumptions - smallest safe recommendation/change and why this option is preferred - validation performed and what still requires live environment verification - residual risk, rollback notes, and prioritized follow-up actions Do not prescribe full repository relayout or wholesale module strategy replacement unless explicitly requested by the parent agent.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Похожие субагенты
Все субагенты по теме «DevOps и инфраструктура» →Сначала — terragrunt-expert от других авторов.