openworker/coworker/personas/builtin/cloud-posture/skills/iac-scan/SKILL.md

name, description

name	description
iac-scan	Scan Terraform/IaC with trivy or tfsec and fix what matters in code

Scan the repo's infrastructure-as-code and turn findings into minimal, safe Terraform changes.

1. Pick the scanner that's present (check in this order, ask before installing):
   • trivy config . --format json -o /tmp/iac.json (also covers Dockerfiles/k8s)
   • tfsec . --format json --out /tmp/iac.json
   • checkov -d . -o json > /tmp/iac.json
2. Triage by real exposure, reading the surrounding Terraform for each finding:
   • Internet-reachable (0.0.0.0/0 ingress, public buckets/ALBs) first.
   • Then identity blast radius (wildcard IAM, broad assume-role trust).
   • Then encryption/logging hygiene. Mark deliberate-looking configuration (a public website bucket, a bastion SG) as "intentional?" and ask rather than auto-fix.
3. Fix in the module where the resource is DEFINED (follow module sources), matching the repo's Terraform style — variables, locals, and tags the way the codebase already does them.
4. Validate every change: terraform fmt on touched files, then terraform init -backend=false && terraform validate when possible. Include terraform plan output in the PR when the user can run it — NEVER run terraform apply.
5. Deliver: exposure-ranked findings table (resource · issue · verdict · action), the fix branch/PR, and any "intentional?" items awaiting a human decision. Offer a pinned scanner config (e.g. .trivyignore with justifications) only for findings the team explicitly accepts.