explain-planlisted
Install: claude install-skill rhawk117/cc-terraform-harness
# Terraform plan explainer
A plan is the only honest preview of what `apply` will do, and almost nobody reads the whole thing. Reviewers skim for the `Plan:` line, miss the one `# forces replacement` buried in 400 lines of tag diffs, and find out about the database rebuild during the maintenance window. This skill exists to make the one paragraph that matters impossible to miss.
The reader might be the SRE approving the apply, the engineer who wrote the change, or a manager who has never seen HCL. Write so the first two lines serve all three and the rest rewards whoever keeps reading.
## Workflow
1. Get the plan as JSON in a file inside the project root. `plan_digest` reads only `terraform show -json` output and refuses any path outside the project root, so a file under `/tmp` cannot be digested. If the user has a binary plan file (`plan.out`, `tfplan`), render it with `terraform show -json plan.out > plan.json` in the module directory. If they pasted JSON, write it to a file in the project. Plan text is not supported: when that is all you have, ask for the plan file or the JSON rendering, and do not guess values from text.
2. Call the `plan_digest` tool with `path` set to the JSON file. It does the counting so you don't miscount by eye.
The result carries `counts` per action, every changed resource in `resource_changes` with its `actions`, the attributes that forced a replacement (`forced_by`), the names of its `sensitive_attributes` and its `flags`, the `output_cha