diff --git a/.github/semantic.yml b/.github/semantic.yml
new file mode 100644
index 0000000..c02477c
--- /dev/null
+++ b/.github/semantic.yml
@@ -0,0 +1,26 @@
+# Always validate the PR title, and ignore the commits
+titleOnly: true
+
+# By default types specified in commitizen/conventional-commit-types is used.
+# See: https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json
+# You can override the valid types
+types:
+  - feat [0-9]
+  - fix
+  - docs
+  - style
+  - refactor
+  - perf
+  - test
+  - build
+  - ci
+  - chore
+  - revert
+ 
+# Allow use of Merge commits (eg on github: "Merge branch 'master' into feature/ride-unicorns")
+# this is only relevant when using commitsOnly: true (or titleAndCommits: true)
+allowMergeCommits: true
+
+# Allow use of Revert commits (eg on github: "Revert "feat: ride unicorns"")
+# this is only relevant when using commitsOnly: true (or titleAndCommits: true)
+allowRevertCommits: true
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..af54883
--- /dev/null
+++ b/README.md
@@ -0,0 +1,2 @@
+Ansible role for Sensu
+Test format