diff --git a/.githooks/commit-msg b/.githooks/commit-msg
new file mode 100644
index 0000000..dd14401
--- /dev/null
+++ b/.githooks/commit-msg
@@ -0,0 +1,17 @@
+#!/bin/sh
+
+commit_msg_file=$1
+commit_msg=$(cat "$commit_msg_file")
+
+if echo "$commit_msg" | grep -Eq "^(feat|fix|refactor|perf|style|test|docs|build|chore|revert): .+"; then
+  if echo "$commit_msg" | grep -Eq "^(ref|close):\sN25B-.+"; then
+    echo "🎉 commit message is Valid"
+    exit 0
+  else
+    echo "❌ Commit message invalid! Must end with [ref/close]: N25B-000"
+    exit 1
+  fi
+else
+  echo "❌ Commit message invalid! Must start with <type>: <description>"
+  exit 1
+fi
\ No newline at end of file
diff --git a/.githooks/pre-commit b/.githooks/pre-commit
new file mode 100644
index 0000000..391d279
--- /dev/null
+++ b/.githooks/pre-commit
@@ -0,0 +1,18 @@
+#!/bin/sh
+
+# Get current branch
+branch=$(git rev-parse --abbrev-ref HEAD)
+
+if echo "$branch" | grep -Eq "(dev|main)"; then
+  echo 0
+fi
+
+# allowed pattern <type/>
+if echo "$branch" | grep -Eq "^(feat|fix|refactor|perf|style|test|docs|build|chore|revert)\/\w+-\w+-\w+"; then
+  echo "✅ Branch name valid: $branch"
+  exit 0
+else
+  echo "❌ Invalid branch name: $branch"
+  echo "Branch must be named <type>/<description-of-branch> (must have 2 stipes - -)"
+  exit 1
+fi
\ No newline at end of file
diff --git a/.githooks/prepare-commit-msg b/.githooks/prepare-commit-msg
new file mode 100644
index 0000000..5b706c1
--- /dev/null
+++ b/.githooks/prepare-commit-msg
@@ -0,0 +1,9 @@
+#!/bin/sh
+
+echo "#<type>: <description>
+
+#[optional body]
+
+#[optional footer(s)]
+
+#[ref/close]: <issue identifier>" > $1
\ No newline at end of file
diff --git a/README.md b/README.md
index 4c7a953..14afc54 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,18 @@
 # PepperPlus-CB
 
+## GitHooks
+
+To activate automatic commits/branch name checks run:
+
+```shell
+git config --local core.hooksPath .githooks
+```
+
+If your commit fails its either:
+branch name != <type>/description-of-branch
+commit name !=  <type>: description of the commit.
+                <ref>: N25B-Num's
+
 
 
 ## Getting started