tf-spec-writing

Draft implementation-agnostic Terraform feature specifications with acceptance criteria.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Terraform feature specification writing patterns help business stakeholders and engineering teams articulate requirements and success criteria without locking to specific implementations, enabling clearer alignment and reduced rework.

Core Features & Use Cases

  • User story formats: standardized templates to describe who, what, why, and acceptance conditions.
  • Requirements: functional requirements with clear success criteria and data considerations.
  • Success criteria templates: measurable, technology-agnostic success metrics to guide validation.
  • Terraform-specific conventions: guidance on infrastructure-focused spec language and non-implementation details.
  • Use Case: draft a spec for a new Terraform module that provisions a secure networking stack with clear acceptance criteria and data requirements.

Quick Start

Draft a Terraform feature spec for a new module that provisions a VPC with defined acceptance criteria.

Frequently Asked Questions about tf-spec-writing

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

FAQPage Schema
How do I write a Terraform feature specification that stays implementation-agnostic?

Terraform feature specifications use structured templates for user stories and acceptance criteria to articulate requirements without locking into specific implementations, ensuring clearer alignment and reduced rework.

What is the best way to define acceptance criteria for a new Terraform module?

Acceptance criteria for a Terraform module should use standardized templates to describe who, what, why, and acceptance conditions, ensuring the success metrics are measurable and technology-agnostic to guide validation.

How do I structure functional requirements for provisioning infrastructure with Terraform?

Functional requirements for provisioning infrastructure are structured using templates that define clear success criteria and data considerations, applying Terraform-specific conventions to keep spec language focused on infrastructure.

Can I use these specification patterns for policy-driven Terraform requirements?

Yes, these specification patterns apply to product, platform, and infrastructure teams defining policy-driven requirements, ensuring documentation satisfies quality rules and success criteria without relying on specific implementations.

When do I need a structured specification for Terraform configuration changes?

You need a structured specification for Terraform configuration changes when aligning business needs with engineering deliverables, ensuring the documentation captures testable and measurable requirements to reduce rework.

Does writing Terraform specifications require knowledge of specific cloud provider implementations?

No, writing these Terraform specifications focuses on technology-agnostic success metrics and non-implementation details, allowing business stakeholders and engineering teams to define requirements without specific cloud provider knowledge.