● Comunidad
LukasNiessen
⚡ Instantáneo
terrashark
por LukasNiessen · LukasNiessen/terrashark
Skill de Terraform que realmente sigue las mejores prácticas de HashiCorp — elimina alucinaciones del LLM con IaC fundamentada y modular.
TerraShark previene el modo de fallo común de Claude de alucinar argumentos de recursos de Terraform, fundamentándose en las mejores prácticas oficiales de HashiCorp. Favorece código modular, disposición sensata del estado y valores por defecto de seguridad. Bueno para infraestructura nueva y para arreglar Terraform generado por LLM que no planifica limpiamente.
Por qué usarlo
Características clave
- Fundamentada en las mejores prácticas de Terraform de HashiCorp
- Elimina argumentos de recursos alucinados
- Estructura modular por defecto (modules/, envs/)
- Valores por defecto enfocados en seguridad (menor privilegio, cifrado activado)
- Guía de disposición de estado (backend remoto, patrones de espacios de trabajo)
- Funciona con Claude Code y Codex
Demo en vivo
Cómo se ve en la práctica
terrashark-skill.replay
▶ listo
Casos de uso
Usos del mundo real: terrashark
Cuándo usarlo: Primer día de una nueva cuenta de AWS; quieres un módulo de VPC que no te avergüence en 6 meses.
Flujo
-
Genera el módulo
Usa terrashark. Módulo de AWS VPC, 3 zonas de disponibilidad, subredes públicas + privadas + base de datos, puertas de enlace de NAT por AZ, logs de flujo activados.✓ Copiado
→ Módulo con variables.tf, main.tf, outputs.tf — sin argumentos alucinados
-
Añade valores por defecto de seguridad
Asegura que el grupo de seguridad por defecto deniega todo, los logs de flujo van a CloudWatch con cifrado CMK de KMS.✓ Copiado
→ Grupo de seguridad + logging + KMS conectados
-
Valida
Ejecuta terraform init + validate + plan con ejemplo tfvars.✓ Copiado
→ Salida de plan limpia, sin errores
Resultado: Un módulo de VPC que terraform valida limpiamente y sigue las mejores prácticas de AWS.
Errores comunes
- El LLM sugiere argumento aws_vpc_endpoint obsoleto — TerraShark se fundamenta en documentación actual; si la divergencia aún sucede, pídele que cite la página de HashiCorp
- Módulo demasiado monolítico — Pide división: módulo de networking vs. módulo de endpoints por separado
Cuándo usarlo: Otro LLM te dio Terraform que se ve razonable pero terraform plan falla en argumentos desconocidos.
Flujo
-
Apunta al archivo roto
terraform plan falla en modules/rds. Usa terrashark para arreglar cada argumento inválido con la forma correcta actual.✓ Copiado
→ Corrección por error con referencia de documentación HashiCorp
-
Valida
Re-ejecuta plan; si algún error permanece, itera.✓ Copiado
→ Plan limpio
Resultado: Un archivo que planifica limpiamente.
Cuándo usarlo: Tienes dev + staging + prod y un gigantesco terraform.tfstate.
Flujo
-
Propón disposición
Diseña backend remoto de S3 con archivos de estado por entorno y bloqueo de DynamoDB. 3 entornos.✓ Copiado
→ Configuración de backend por entorno con separación de claves + bloqueo
-
Plan de migración
Planifica la migración de un estado local único a esta disposición, paso a paso.✓ Copiado
→ pasos de terraform state mv + puntos de control de seguridad
Resultado: Una disposición de estado a la que puedas migrar sin perder estado.
Errores comunes
- Eliminación accidental de estado durante migración — Siempre extrae y respalda archivos de estado antes de cualquier operación mv
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
AWS skill dimensiona la arquitectura, TerraShark implementa IaC
Diseña la arquitectura con aws-skill, implementa como Terraform con terrashark.✓ Copiado
Revisión de seguridad del IaC generado
Después de que terrashark estructura el módulo, ejecuta revisión de seguridad OWASP en los bloques de IAM y networking.✓ Copiado
Coste y límites
Lo que cuesta ejecutarlo
- Cuota de API
- Ninguno
- Tokens por llamada
- 10-30k por módulo
- Monetario
- Gratuito
- Consejo
- Genera módulo por módulo, no todo el entorno de una sola vez.
Seguridad
Permisos, secretos, alcance
Almacenamiento de credenciales: Sin credenciales. TerraShark no ejecuta terraform apply en sí mismo.
Salida de datos: Los prompts van a Claude. Terraform plan/apply accede a tu proveedor de nube usando tus credenciales locales.
- Siempre revisa las políticas de IAM generadas antes de apply. Los LLMs pueden otorgar en silencio excesivamente.
Resolución de problemas
Errores comunes y soluciones
terraform validate falla en argumento desconocido
Pide a TerraShark que reconcilie contra la URL de documentación del proveedor actual; la versión del proveedor puede ser más nueva que el contexto del prompt de la skill.
Verificar: terraform providers
Plan crea destrucciones no deseadas
Usualmente desajuste de estado o renombramiento implícito. Ejecuta terraform plan -target para aislar antes de apply.
Alternativas
terrashark vs otros
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| Escritura manual con documentación oficial abierta | Conoces el proveedor profundamente | Más lento |