tf-module-implement

Generate and validate Terraform modules from design.md using a test-driven workflow.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/hashi-demo-lab/terraform-provider-aap --skill tf-module-implement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tf-module-implement
Source: https://github.com/hashi-demo-lab/terraform-provider-aap/tree/main/.claude/skills/tf-module-implement
Command: npx skills add https://github.com/hashi-demo-lab/terraform-provider-aap --skill tf-module-implement

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps development teams translate an existing design spec into a production-ready Terraform module pipeline using a test-driven development approach. It ensures tests are written up-front, modules are scaffolded consistently, and changes are validated before PR creation.

Core Features & Use Cases

  • Generates Terraform modules from specs/{FEATURE}/design.md, aligning implementation with design expectations.
  • Enforces a TDD workflow: write tests first, then implement code, validate, and integrate via PRs.
  • Supports a repeatable, audit-friendly process for feature delivery, including validation checkpoints and progress updates.

Quick Start

Provide the feature name and run the module-assembly workflow to generate and validate the Terraform module from specs/{FEATURE}/design.md.

Frequently Asked Questions about tf-module-implement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Terraform module from a design document?

To generate a Terraform module from a design document, you need an existing design.md file located at specs/{FEATURE}/design.md. The automation workflow parses this design specification to scaffold consistent module code aligned with your feature expectations.

What is test-driven development for Terraform modules?

Test-driven development for Terraform modules involves writing tests up-front before implementing any module code. This approach validates the module against design expectations early, ensuring changes are thoroughly tested, linted, and validated before pull request creation.

How do I automate Terraform module validation and PR preparation?

You can automate Terraform module validation and PR preparation by running the module-assembly workflow with a specified feature name. This process executes automated validations, runs tests, generates code, and prepares the pull request for delivery.

Do I need a design.md file to scaffold Terraform modules automatically?

Yes, a design.md file is strictly required at the specs/{FEATURE}/design.md path to scaffold Terraform modules automatically. The workflow parses this existing design specification to drive test generation, code implementation, and validation.

Does the Terraform TDD workflow support automated linting and testing?

Yes, the Terraform TDD workflow supports automated linting and testing through validation checkpoints. It scaffolds modules consistently and applies automated agents to run validations, ensuring the generated code meets quality standards before integration.

What are the limitations of automating Terraform module generation from specs?

The limitation of automating Terraform module generation is its strict dependency on an existing design.md file at specs/{FEATURE}/design.md. Without this specific prerequisite file properly structured, the automated scaffolding, testing, and PR workflow cannot execute.