chore: set up husky hooks and fix broken link

- Add husky, commitlint, and markdownlint configuration
- Create pre-commit hook for Python (ruff) and markdown linting
- Create commit-msg hook for commit message validation
- Add ruff configuration to pyproject.toml
- Fix broken link in hero button (use-case-tree.md -> use-case-tree/)
- Only lint staged files to avoid blocking on existing violations

Author: jgeluk

.husky/commit-msg

@@ -0,0 +1 @@
+pnpm exec commitlint --edit $1

.husky/pre-commit

@@ -0,0 +1,10 @@
+# Run Python linting if Python files exist and ruff is available
+if find . -name "*.py" -not -path "./.venv/*" -not -path "./site/*" | grep -q .; then
+  if command -v uv >/dev/null 2>&1 && uv run ruff --version >/dev/null 2>&1; then
+    uv run ruff check . || exit 1
+    uv run ruff format --check . || exit 1
+  fi
+fi
+
+# Run markdown linting
+pnpm lint:md || exit 1

commitlint.config.js

@@ -0,0 +1,19 @@
+/** @type {import('@commitlint/types').UserConfig} */
+const config = {
+  extends: ["@commitlint/config-angular"],
+  rules: {
+    // Angular style: stricter rules
+    "subject-case": [
+      2,
+      "never",
+      ["start-case", "pascal-case", "upper-case"],
+    ],
+    "subject-empty": [2, "never"],
+    "subject-full-stop": [2, "never", "."],
+    "type-case": [2, "always", "lower-case"],
+    "type-empty": [2, "never"],
+    "scope-case": [2, "always", "lower-case"],
+  },
+};
+
+module.exports = config;

docs/index.md

@@ -25,7 +25,7 @@ Deliver strategic business value and agility through connected
 enterprise knowledge — one use case at a time.
 
 <div class="hero-buttons">
-<a href="concept/use-case-tree.md" class="md-button md-button--primary">Explore the Use Case Tree</a>
+<a href="concept/use-case-tree/" class="md-button md-button--primary">Explore the Use Case Tree</a>
 <a href="https://catalog.ekgf.org/" class="md-button">Browse example use cases</a>
 </div>
 

ekg-method.code-workspace

@@ -5,6 +5,21 @@
     },
     {
       "path": "../ekg-catalog"
+    },
+    {
+      "path": "../ekg-maturity"
+    },
+    {
+      "path": "../ekg-principles"
+    },
+    {
+      "path": "../ekgf-website"
+    },
+    {
+      "path": "../business-composer"
+    },
+    {
+      "path": "../agnos-website"
     }
   ],
   "settings": {

package.json

@@ -1,5 +1,15 @@
 {
+	"scripts": {
+		"prepare": "husky",
+		"lint": "uv run ruff check . && uv run ruff format --check .",
+		"lint:md": "markdownlint '**/*.md' --ignore node_modules --ignore .husky --ignore site"
+	},
 	"devDependencies": {
+		"@commitlint/cli": "^20.3.0",
+		"@commitlint/config-angular": "^20.3.0",
+		"@commitlint/config-conventional": "^20.3.0",
+		"husky": "^9.1.7",
+		"markdownlint-cli": "^0.47.0",
 		"prettier": "^3.7.4"
 	}
 }