What problem does it solve? Terraform module READMEs constantly drift out of sync with the actual code, and edits made inside the terraform-docs marker block are silently destroyed on the next generation run. This Skill sets up terraform-docs and tflint correctly so documentation is generated from source and staleness fails CI instead of being overwritten. ## Core Features & Use Cases - terraform-docs setup: Installs a .terraform-docs.yml template that injects generated content between BEGIN_TF_DOCS/END_TF_DOCS markers, pulls the header from a /** */ block in main.tf, and appends a footer.md support section. - tflint configuration: Provides a .tflint.hcl template enabling documented-variables, documented-outputs, naming-convention, unused-declarations, and deprecated-index rules, with terraform_comment_syntax deliberately disabled. - Gate integration: Wires terraform fmt, terraform validate, tflint, and terraform-docs --output-check into .crew/verify.json so undocumented variables fail the check instead of mutating the README mid-gate. - Use Case: A team adds a new variable to a Terraform module without a description; the verification gate fails on the stale README check, forcing the documentation to be regenerated before merge. ## Quick Start Set up terraform-docs and tflint for my Terraform module and wire the checks into the verification gate.
