ci(pre-commit): enforce conventional-commits message structure

This adds pre-commit and ci checks to ensure that commit messages follow
[`conventional-commits`](https://www.conventionalcommits.org/en/v1.0.0/).

From their site: Conventional Commits is:
`A specification for adding human and machine readable meaning to commit messages`

Commit messages must follow the following format:
```
<type>[optional scope]: <description>

[optional body]

[optional footer(s)]
```

In general, this means that you will provide a topic:
* feat
* fix
* ci
* refactor

Followed by a description.

Following this standard allows for automatic semantic versioning and
release note generation.

* `.commitlintrc.yaml` - defines the commit message format for linting
* `.cz.json` - configuration for [`commitizen-cli`](http://commitizen.github.io/cz-cli/)

.commitlintrc.yaml

@@ -0,0 +1,2 @@
+extends:
+  - "@commitlint/config-conventional"

.cz.json

@@ -0,0 +1,4 @@
+{
+  "maxHeaderWidth": 72,
+  "path": "cz-conventional-changelog"
+}

.github/workflows/ci.yaml

@@ -12,9 +12,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
       - name: Set up Go
         uses: actions/setup-go@v2
         with:
           go-version: 1.15
       - uses: actions/setup-python@v2
       - uses: pre-commit/[email protected]
+      - uses: wagoid/commitlint-github-action@v2

.pre-commit-config.yaml

@@ -20,3 +20,9 @@ repos:
       - id: go-fmt
       - id: go-mod-tidy
       - id: go-build
+  - repo: https://github.com/alessandrojcm/commitlint-pre-commit-hook
+    rev: v5.0.0
+    hooks:
+      - id: commitlint
+        stages: [commit-msg]
+        additional_dependencies: ["@commitlint/config-conventional"]

README.md

@@ -73,6 +73,20 @@ the hooks by running the following command in the root of the repository:
 pre-commit install
 ```
 
+This repository following `Conventional Commits` for message formatting.
+See: https://www.conventionalcommits.org/en/v1.0.0/
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+You can use commitizen to help generate commit messages.
+See: http://commitizen.github.io/cz-cli/
+
 ### Running Project Built Locally
 
 #### Terraform v0.12