# Add Terraform Module

> Scaffold a new Terraform module with variables, main, and outputs. Use when provisioning a new cloud resource (database, cache, storage, etc.) that needs its own Terraform module and optional IaC wrapper wiring.

- **Type:** Skill
- **Install:** `agentstack add skill-makigjuro-cloudstack-ai-plugins-add-terraform-module`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [makigjuro](https://agentstack.voostack.com/s/makigjuro)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [makigjuro](https://github.com/makigjuro)
- **Source:** https://github.com/makigjuro/cloudstack-ai-plugins/tree/main/plugins/cloud-infra/skills/add-terraform-module
- **Website:** https://github.com/makigjuro/cloudstack-ai-plugins#quick-start

## Install

```sh
agentstack add skill-makigjuro-cloudstack-ai-plugins-add-terraform-module
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Add Terraform Module

Scaffold a new Terraform module following project conventions.

## Arguments

- `{module-name}` — Name of the module (required, e.g., `redis`, `service-bus`, `postgresql`)
- `{description}` — What this module provisions (optional)

## Configuration

Read `cloudstack.json` from the project root at the start of execution. Extract:
- `TF_PATH` = `infrastructure.terraformPath` (default: `infra/terraform/modules`)
- `TG_PATH` = `infrastructure.terragruntPath` (default: `infra/terragrunt`)
- `IAC_WRAPPER` = `infrastructure.iacWrapper` (default: `none`)
- `CLOUD` = `infrastructure.cloud` (default: `azure`)

If `cloudstack.json` does not exist, auto-detect by scanning the project structure.

## Process

1. Read existing modules in `{TF_PATH}/` to follow established patterns.

2. Create the module directory:

```
{TF_PATH}/{module-name}/
├── variables.tf
├── main.tf
├── outputs.tf
```

3. **variables.tf** — Always include these standard variables:
```hcl
variable "environment" {
  description = "Environment name (e.g. dev, staging, prod)"
  type        = string
}

variable "location" {
  description = "Cloud region (e.g. westeurope, us-east-1)"
  type        = string
}

variable "project" {
  description = "Project prefix for resource naming"
  type        = string
}

variable "tags" {
  description = "Common tags applied to all resources"
  type        = map(string)
  default     = {}
}
```

Add module-specific variables after the standard ones.

4. **main.tf** — Follow the naming convention from existing modules. Derive a location short code from the region (e.g., `westeurope` -> `weu`, `us-east-1` -> `use1`):
```hcl
locals {
  location_short = # derive from var.location or use a lookup map
  name           = "${var.project}-{resource-abbrev}-${var.environment}-${local.location_short}"
}
```

Scan existing modules to discover the project's established naming convention and location short mapping. Use that pattern.

5. **outputs.tf** — Export `name`, `id`, and any connection strings or keys needed by downstream modules.

6. **IaC Wrapper Wiring (conditional on `IAC_WRAPPER`):**

   **If `IAC_WRAPPER` = `terragrunt`:** Create Terragrunt wiring for the dev environment:

   ```
   {TG_PATH}/dev/{module-name}/
   └── terragrunt.hcl
   ```

   With content:
   ```hcl
   include "root" {
     path = find_in_parent_folders()
   }

   terraform {
     source = "../../../terraform/modules/{module-name}"
   }

   dependency "resource_group" {
     config_path = "../resource-group"
   }

   inputs = {
     resource_group_name = dependency.resource_group.outputs.name
   }
   ```

   Adjust the `source` path to be the correct relative path from `{TG_PATH}/dev/{module-name}/` to `{TF_PATH}/{module-name}`. Add additional dependencies based on what the module needs.

   **If `IAC_WRAPPER` = `none`:** Skip wrapper wiring. Note that the user can run `terraform plan` directly from the module directory.

## Output

After scaffolding, report:
```
## Scaffolded: {module-name} Terraform module

Files created:
- `{TF_PATH}/{module-name}/variables.tf`
- `{TF_PATH}/{module-name}/main.tf`
- `{TF_PATH}/{module-name}/outputs.tf`
- `{TG_PATH}/dev/{module-name}/terragrunt.hcl` (if IAC_WRAPPER = terragrunt)

Next: Add resource definitions in `main.tf`, then run `/infra-lint` to validate.
```

## Error Handling

- **Module directory already exists:** Warn the user and ask whether to overwrite or extend.
- **Terraform not installed:** Suggest installing with `brew install terraform`.
- **IaC wrapper root config not found:** If using Terragrunt, check that `{TG_PATH}/terragrunt.hcl` exists as the root config.

## After Scaffolding

Remind to:
- Add module-specific resource definitions in `main.tf`
- Add any needed dependencies in the wrapper config (if applicable)
- Run `/infra-lint` to validate

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [makigjuro](https://github.com/makigjuro)
- **Source:** [makigjuro/cloudstack-ai-plugins](https://github.com/makigjuro/cloudstack-ai-plugins)
- **License:** MIT
- **Homepage:** https://github.com/makigjuro/cloudstack-ai-plugins#quick-start

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-makigjuro-cloudstack-ai-plugins-add-terraform-module
- Seller: https://agentstack.voostack.com/s/makigjuro
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.