workspace-to-stack

Migrate HCP Terraform workspaces into Terraform Stacks using hcptf CLI commands.

4|3|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/thrashr888/hcptf-cli --skill workspace-to-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-to-stack
Source: https://github.com/thrashr888/hcptf-cli/tree/main/.skills/workspace-to-stack
Command: npx skills add https://github.com/thrashr888/hcptf-cli --skill workspace-to-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the complex process of refactoring existing HCP Terraform workspaces into more robust and manageable Terraform Stacks, enabling better multi-environment orchestration and component isolation.

Core Features & Use Cases

  • Guided Migration: Provides step-by-step instructions and hcptf commands for auditing, designing, and implementing the migration.
  • Stack Design: Offers guidance on structuring single-component vs. multi-component stacks based on existing workspace complexity.
  • Use Case: You have a monolithic HCP Terraform workspace that has become difficult to manage across multiple environments (dev, staging, prod). This Skill will guide you through converting it into a single stack with distinct deployments for each environment, improving maintainability and deployment coordination.

Quick Start

Use the workspace-to-stack skill to begin migrating the 'my-app-workspace' in 'my-org' to a new stack.

Frequently Asked Questions about workspace-to-stack

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

FAQPage Schema
How do I migrate HCP Terraform workspaces to stacks?

Migrating HCP Terraform workspaces to stacks involves auditing configurations, designing single or multi-component stack architectures, generating definition files, and executing the process via `hcptf` CLI commands.

What is the best way to manage monolithic HCP Terraform workspaces across multiple environments?

Refactoring monolithic HCP Terraform workspaces into Terraform Stacks isolates multi-environment orchestration by creating distinct deployments for dev, staging, and prod within a single stack architecture.

When do I need to use Terraform Stacks for infrastructure management?

You need Terraform Stacks when component-based infrastructure requires enhanced orchestration, modularity, and multi-environment consolidation to resolve workspace management complexity.

Does the workspace to stack migration process support multi-component architectures?

Yes, the workspace to stack migration supports multi-component architectures by structuring stack definition files to isolate components and consolidate multi-environment deployments effectively.

Can I consolidate multiple HCP Terraform workspaces into a single stack?

Yes, you can consolidate multiple HCP Terraform workspaces into a single stack by designing multi-component architectures and generating stack definition files to coordinate deployments cohesively.