chore: add git hooks and commit conventions

.husky/commit-msg

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

.husky/install.mjs

@@ -0,0 +1,6 @@
+// Skip Husky install in production and CI
+if (process.env.NODE_ENV === 'production' || process.env.CI === 'true') {
+ process.exit(0);
+}
+const husky = (await import('husky')).default;
+console.log(husky());

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm exec nano-staged

CONTRIBUTING.md

@@ -76,6 +76,13 @@ pnpm skills:install # restore Skilld links for Codex
 
 Oxfmt owns formatting and Oxlint owns linting. Avoid unrelated formatting churn.
 
+`pnpm install` installs Git hooks through the `prepare` script (`.husky/install.mjs`), which skips hook installation in CI and production environments:
+
+- `pre-commit` runs `pnpm exec nano-staged`, which formats staged files with Oxfmt and re-stages them.
+- `commit-msg` runs `pnpm exec commitlint --edit`, which enforces Conventional Commit messages.
+
+If `pre-commit` fails, fix the reported error and commit again; formatting fixes are applied automatically. If `commit-msg` rejects your message, reword it to follow the Conventional Commit format below (after a failed commit, rerun `git commit` with a valid message; to fix the previous commit, use `git commit --amend`).
+
 Use Conventional Commit-style messages and PR titles:
 
 ```text

commitlint.config.mjs

@@ -0,0 +1,3 @@
+export default {
+ extends: ['@commitlint/config-conventional'],
+};

package.json

@@ -14,6 +14,7 @@
  "format:check": "oxfmt --check .",
  "lint": "TMPDIR=/tmp turbo run lint",
  "lint:ci": "pnpm format:check && pnpm lint",
+ "prepare": "node .husky/install.mjs",
  "skills:install": "skilld install --agent codex",
  "skills:list": "skilld list",
  "test": "TMPDIR=/tmp turbo run test --concurrency=1",
@@ -23,8 +24,12 @@
  },
  "devDependencies": {
  "@arethetypeswrong/cli": "^0.18.5",
+ "@commitlint/cli": "^21.2.1",
+ "@commitlint/config-conventional": "^21.2.0",
  "@redstardev/unplugin-version-injector": "0.0.2",
  "@types/node": "^24.3.0",
+ "husky": "^9.1.7",
+ "nano-staged": "^1.0.2",
  "oxfmt": "^0.62.0",
  "oxlint": "^1.44.0",
  "oxlint-tsgolint": "^7.0.2001",
@@ -36,8 +41,11 @@
  "typescript": "^5.9.2",
  "vitest": "^3.2.4"
  },
+ "nano-staged": {
+ "*.{js,mjs,cjs,ts,tsx,json,jsonc,yaml,yml,md}": "oxfmt --write"
+ },
  "engines": {
- "node": ">=20.11"
+ "node": ">=22.18"
  },
  "packageManager": "pnpm@10.15.0"
 }