---
name: "pulumi-typescript-iac"
description: "Define cloud infrastructure using real programming languages (TypeScript) and type safety."
metadata:
  author: "Pulumi"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "create pulumi typescript stack"
  - "build pulumi componentresource"
  - "test pulumi iac jest"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Pulumi TypeScript Infrastructure as Code & ComponentResources

Builds cloud architectures with Pulumi: creating custom ComponentResources, managing stack references, dynamic providers, unit testing infrastructure with Mocha/Jest, and deploying with pulumi up.

## When to Invoke
Invoke this skill whenever you need to:
- create pulumi typescript stack
- build pulumi componentresource
- test pulumi iac jest

## Execution SOP & Rules
1. Initialize stack: pulumi new aws-typescript --name my-infra.
2. Define infrastructure components using native npm packages (@pulumi/aws, @pulumi/kubernetes).
3. Export stack outputs cleanly with export const lbUrl = alb.loadBalancer.dnsName.
4. Preview and apply changes using pulumi preview and pulumi up --yes.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.