# Compatibilidad con Terraform en Maguyva: contexto de infraestructura para agentes de IA

Canonical source: https://maguyva.ai/es/languages/terraform

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Maguyva es compatible con Terraform mediante análisis AST y extracción de símbolos, de modo que los agentes de IA puedan rastrear módulos, locals, variables, referencias a recursos y patrones dinámicos de infraestructura antes de sugerir cambios.

## Resumen de soporte

- Nivel: Soporte de AST y símbolos
- Infraestructura
- Extensiones: .tf, .tfvars
- Análisis AST real para búsqueda con reconocimiento de sintaxis y contexto estructural.
- Los símbolos con nombre alimentan la búsqueda semántica y las referencias cruzadas. La navegación por grafo está disponible cuando la extracción de relaciones está habilitada.
- Este lenguaje está indexado para búsqueda, pero actualmente no se persiste en el grafo de código.
- Están disponibles tanto el análisis AST como la extracción de símbolos.

## Mejor uso

- Equipos de plataforma que gestionan módulos de Terraform reutilizables, carpetas de entornos y patrones de infraestructura compartidos.
- Repositorios donde los cambios en el código de la aplicación suelen requerir ediciones de infraestructura correspondientes o una revisión de impacto.
- Flujos de trabajo de agentes que necesitan entender las referencias y el radio de impacto antes de tocar definiciones de infraestructura.

## Flujos de trabajo del agente

- Rastrear cómo se conectan las variables, los locals, los módulos y los recursos antes de editar un plan.
- Comparar variantes de entornos y el uso de módulos para mantener los cambios consistentes.
- Inspeccionar el probable impacto en cascada antes de que el agente sugiera una modificación de infraestructura.

## Por qué Terraform necesita contexto a nivel de repositorio

El código de infraestructura es donde muchas herramientas de IA caen silenciosamente en un manejo superficial de texto. Eso no es suficiente. Los cambios en Terraform suelen ser sensibles, con muchas referencias, y están distribuidos entre módulos, locals, variables, fuentes de datos y carpetas específicas de cada entorno. La parte difícil es entender cómo encaja la configuración antes de cambiarla.

Por eso el soporte de Terraform importa incluso si tu código de aplicación principal vive en otro lugar. Si el repositorio contiene código de infraestructura, el agente necesita verlo como parte del mismo sistema, no como un anexo sobre el que debe adivinar.

## Qué ayuda a entender Maguyva a los agentes en Terraform

Maguyva es compatible con Terraform de forma estructural, lo cual es la base útil para seguir referencias entre módulos, flujos de variables y relaciones entre recursos. Eso importa todavía más una vez que el código usa `count`, `for_each`, bloques dinámicos y módulos compartidos que hacen más difícil recuperar la forma real del plan con una revisión rápida.

El beneficio práctico es que el agente puede responder preguntas a nivel de repositorio como «¿dónde se reutiliza este módulo?», «¿qué depende de esta variable?» o «¿qué carpetas de entorno se desvían del patrón?» antes de proponer un cambio.

## Qué demuestra esto sobre la cobertura de lenguajes de Maguyva

Terraform es una buena prueba de si la cobertura de lenguajes es realmente útil. Muestra si Maguyva puede tratar el código de aplicación, el código operativo y la infraestructura como un solo problema a nivel de repositorio en lugar de islas separadas.

Si tu infraestructura está junto al código de servicios, la [guía de Go](/es/languages/go) es el emparejamiento de backend más cercano. Si el mismo repositorio incluye paquetes web o de plataforma, la [guía de TypeScript](/es/languages/typescript) es la página adyacente correcta.

## Cuándo es útil esta página

Usa esta página si la pregunta es «¿el agente también puede conservar el contexto de infraestructura?». Esa es una pregunta más realista que preguntar solo por los lenguajes de aplicación. Para la matriz completa, usa [compatibilidad](/es/docs/compatibility).

## Detalles del motor

- La normalización de imports elimina `module` y `source`, lo que facilita comparar referencias a nivel de módulo.
- Las reglas del lenguaje Terraform reconocen referencias a `var`, `local`, `module`, `data` y recursos para la extracción de relaciones, pero la política de grafos actual no las conserva en el grafo de código de Maguyva.
- El flujo de control específico de Terraform, como `count`, `for_each` y los bloques dinámicos, se trata como estructura de primera clase en lugar de texto plano.

## Puntos de entrada MCP útiles

- `get_task_context`: Úsala para prompts como “rastrea cómo la salida del módulo VPC alimenta al servicio ECS” cuando necesites una respuesta que reúna el contexto relevante rápidamente.
- `text_pattern_search`: Usa texto exacto para direcciones de recursos, nombres de módulos o claves de variables, antes de ampliar el análisis.
