Merge pull request #42 from chrisjwalk/dx/commitlint-34

dx: add commitlint with conventional commits

Author: chrisjwalk

.husky/commit-msg

@@ -0,0 +1 @@
+pnpm dlx commitlint --edit "$1"

AGENTS.md

@@ -22,31 +22,52 @@
 
 Both accounts are configured in the `gh` CLI on this machine.
 
-## PR Workflow
+## Complete Workflow — follow every step in order
 
-Always follow this pattern when pushing branches and creating PRs:
+**1. Create an issue first** (as `chrisjwalk`, the default account):
+
+```bash
+gh issue create --title "..." --body "..."
+# note the issue number, e.g. #42
+```
+
+**2. Create a branch** referencing the issue:
+
+```bash
+git checkout -b feat/short-description-42
+```
+
+**3. Implement, commit** (git is configured to commit as `chrisjwalk-bot`):
+
+```bash
+git commit -m "feat: description (closes #42)
+
+Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>"
+```
+
+**4. Push and open PR as `chrisjwalk-bot`**:
 
 ```bash
-# 1. Switch to bot before pushing
 gh auth switch --user chrisjwalk-bot
-git push origin <branch>
-gh pr create ...
+git push origin feat/short-description-42
+gh pr create --title "..." --body "Closes #42 ..."
+```
+
+**5. Switch back to owner**:
 
-# 2. Switch back to owner account afterwards
+```bash
 gh auth switch --user chrisjwalk
 ```
 
+> ⚠️ Never open a PR without a corresponding issue. Never push as `chrisjwalk-bot` without switching back to `chrisjwalk` afterwards.
+
 ## Git Commit Identity
 
 Git is configured locally in this repo to commit as the bot:
 
 - `user.name` = `chrisjwalk-bot`
 - `user.email` = `268224883+chrisjwalk-bot@users.noreply.github.com`
 
-## Issue Workflow
-
-Create issues as `chrisjwalk` (the default active account). Always create a GitHub issue before starting work on a feature or fix, and reference it in the branch name and PR.
-
 # Coding Conventions
 
 ## Styling: Tailwind over CSS

commitlint.config.js

@@ -0,0 +1,23 @@
+/** @type {import('@commitlint/types').UserConfig} */
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'test',
+        'chore',
+        'perf',
+        'ci',
+        'a11y',
+        'dx',
+      ],
+    ],
+  },
+};

package.json

@@ -89,6 +89,8 @@
     "@angular/cli": "21.2.2",
     "@angular/compiler-cli": "21.2.4",
     "@angular/language-service": "21.2.4",
+    "@commitlint/cli": "^20.4.4",
+    "@commitlint/config-conventional": "^20.4.4",
     "@eslint/eslintrc": "3.3.5",
     "@eslint/js": "10.0.1",
     "@nx/angular": "22.5.4",