Terraform Consumer Design

User Input

$ARGUMENTS

1. Read Issue Template: Read .github/ISSUE_TEMPLATE/terraform-agent-provisioning.yml to understand required fields
2. Gather User Inputs: Use user's natural language request to populate issue fields wherever possible
3. Create GitHub Issue:
   • Use gh issue create with the user provided input and template values
   • Title format: [AGENT PROVISION] <descriptive-name>
   • Labels: agent-driven, terraform, infrastructure, provisioning
   • Populate all fields from the template
4. Validate Issue: Confirm the GitHub issue is valid and contains all required information
5. Mark as In Progress: Add in-progress label when starting work using gh issue edit <issue-number> --add-label "in-progress"
6. Update Issue with Progress: Comment on the issue at the start and completion of each Github spec-kit stage with a short summary and link to the generated artifacts:
   • Format: 🤖 **[Stage Name]** - [Started/Completed]: Brief summary
   • Example: 🤖 **speckit.specify** - Started: Creating feature specification from requirements
   • Example: 🤖 **speckit.specify** - Completed: Generated spec.md with 5 core requirements

Environment

All files and folders exist in /workspace/ directory. All speckit scripts are located in /workspace/.specify/scripts/bash directory.

You should not require to change to any other directory.

Execution Workflow

For each task use concurrent subagents to speed up the process. At each stage, commit changes and update the GitHub issue with progress comments. Allocate subtask efficiently, some tasks like writing a file should only be created once, I will breakdown tasks to you.

0. Create and configure tracking GitHub issue from template. Github issue should be created and labeled appropriately. Confirm the gh issue is valid, when you start mark the issue to in-progress using the label in-progress, update the github issue with comments when you start and finish each speckit stage with a short summary
1. Validate environment and credentials by running .specify/scripts/bash/validate-env.sh
2. Use concurrent subagent speckit.specify - Create feature specification from the issue details and continue to next stage. Output Github issue number and branch to gh-issue.json for use by implementation agent
3. commit and update Git issue and continue to next stage
4. Use concurrent subagent speckit.clarify and continue to next stage
5. commit and update Git issue and continue to next stage
6. Use concurrent subagent speckit.plan and continue to next stage
7. commit and update Git issue and continue to next stage
8. Use concurrent subagent speckit.tasks and continue to next stage
9. commit and update Git issue and continue to next stage
10. Request user to review and approve design (human-in-the-loop) before implementation phase
11. Update Git issue with user details and approval status.
12. Ensure that gh-issue.json contains all necessary details for implementation agent to proceed.

GitHub Issue Template Mapping

When creating the issue, map user inputs to these key template fields:

Required Fields:

• hcp_org: HCP Terraform organization name
• hcp_project: HCP Terraform project name
• workspace_name: Workspace name (use pattern: sandbox_<REPO_NAME> for testing)
• terraform_version: Terraform version (default: "Latest (recommended)")
• project_name: Project/application name
• cloud_provider: AWS, Azure, GCP, Multi-cloud, or Other
• cloud_region: Primary cloud region
• environment: development, staging, production, sandbox, test, or dr
• infrastructure_components: Detailed list of components to provision

Optional but Important:

• additional_regions: Multi-region deployments
• existing_infrastructure: Existing resources to reference
• module_preference: "Private Registry Only (recommended)" is default
• security_requirements: Security controls checklist
• configuration_values: Key configuration parameters
• network_requirements: Network features needed
• agent_autonomy: Level of autonomy (default: "Fully Autonomous")

Agent Instructions

When user provides infrastructure request:

1. Extract all available information from natural language input
2. Read the issue template to understand all required and optional fields
3. Map user's request to template fields (infer reasonable defaults where needed)
4. Create GitHub issue with gh issue create using extracted values
5. Validate the created issue has all critical information
6. Add in-progress label before starting work
7. Post progress comments at start/completion of each Speckit phase
8. Request user to review and approve design (human-in-the-loop) before implementation phase