The Complete Production SOP: How to Deploy and Run Husky 9 & lint-staged Fast Git Pre-Commit Workflows in Autonomous AI Agents

---
name: "husky-git-hooks-lint-staged"
description: "Automate linter and formatter execution on staged Git files using modern Husky 9 and lint-staged."
metadata:
  author: "typicode"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "install husky 9"
  - "configure lint-staged"
  - "pre-commit hook husky"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: true
  net_access: true
---

# Husky 9 & lint-staged Fast Git Pre-Commit Workflows

1. Initialize Husky 9: Run `npx husky init` to generate `.husky/pre-commit` and append `prepare: husky` to package.json.
2. Overwrite `.husky/pre-commit` with `npx lint-staged`.
3. Add configuration to `package.json` under `lint-staged` mapping target file extensions to linters/formatters.
4. Validate staged execution using `git add` and dry-run linting before committing.

{
  "scripts": {
    "prepare": "husky"
  },
  "lint-staged": {
    "*.{js,jsx,ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{json,md,css,scss}": [
      "prettier --write"
    ]
  }
}

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh" 2>/dev/null || true

npx lint-staged

# Test that lint-staged runs without triggering an actual commit
git add src/test-husky-lint.ts
npx lint-staged --dry-run

# Cleanup temporary test artifact
git reset HEAD src/test-husky-lint.ts
rm -f src/test-husky-lint.ts