---

name: taskfile description: Execute Taskfile commands for the Summerhouse project. Use for terraform operations (init, plan, apply, destroy, output), backend/frontend development, testing, and linting. Terraform uses environments (dev, prod) in infrastructure/environments/.

Taskfile Commands

This skill helps execute Taskfile.yaml commands for the Summerhouse booking platform.

CRITICAL RULE

NEVER run terraform or terragrunt commands directly. ALL infrastructure commands MUST use the Taskfile.

Terraform Commands

Command Pattern

Copytask tf:<action>:<env>

Where:

• <action> is: init, plan, apply, destroy, output
• <env> is a directory name in infrastructure/environments/ (e.g., dev, prod)

Available Terraform Commands

Discovering Environments

Copy# List all available environments
task tf:envs

# Or directly check the directory
ls infrastructure/environments/

Environments are defined by directories in infrastructure/environments/<name>/. Each has:

• backend.hcl - S3 backend configuration
• terraform.tfvars.json - Environment-specific variables

Typical Terraform Workflow

Copy# 1. List available environments
task tf:envs

# 2. Initialize Terraform
task tf:init:dev

# 3. Preview changes
task tf:plan:dev

# 4. Apply changes (after review)
task tf:apply:dev

# 5. View outputs
task tf:output:dev

Backend Commands (Python/FastAPI)

Frontend Commands (Next.js)

Combined Commands

Other Commands

Instructions

When the user asks to run infrastructure or development operations:

1. Terraform operations: ALWAYS use task tf:<action>:<env> pattern
2. Identify environment: Ask which environment if not specified, or run task tf:envs
3. Destructive operations: For apply and destroy, show plan output first and confirm
4. Never bypass: If a task command fails, report the error - do NOT run raw terraform

Examples

User: "Initialize terraform for dev" Action: Run task tf:init:dev

User: "Plan changes for production" Action: Run task tf:plan:prod

User: "Deploy to dev" Action: Run task tf:plan:dev, show output, then task tf:apply:dev after confirmation

User: "What environments are available?" Action: Run task tf:envs

User: "Run backend tests" Action: Run task backend:test

User: "Start the dev servers" Action: Run task dev

User: "Validate terraform syntax" Action: Run task tf:init:dev first (if needed), then task tf:validate