feat: Add Q0: Pre-commit hooks setup.

This should automatically check for problems on build.

README.md

@@ -20,7 +20,10 @@ cd core
 # install dependencies
 python -m venv .venv
 source .venv/bin/activate
-pip install -e .[tests,docs]
+pip install -e ".[dev,tests,docs]"
+
+# set up pre-commit hooks and verify tooling
+bash scripts/setup-dev.sh
 
 # verify the CLI
 agents --help
@@ -29,15 +32,27 @@ agents --version
 
 ## Developing
 
+Pre-commit hooks run automatically on every `git commit` (formatting, linting, type
+checking, security scanning). To run checks manually:
+
 ```bash
-# run validation suites
-nox -s format
-nox -s lint
-oxt -s typecheck
-nox -s unit_tests
-nox -s integration_tests
+# core validation
+nox -s format            # ruff auto-formatting
+nox -s lint              # ruff linting
+nox -s typecheck         # pyright type checking
+nox -s unit_tests        # behave unit tests
+nox -s integration_tests # robot integration tests
+
+# quality & security
+nox -s security_scan     # bandit security scanning
+nox -s dead_code         # vulture dead code detection
+nox -s complexity        # radon complexity analysis
+nox -s pre_commit        # run all pre-commit hooks
+nox -s adr_compliance    # verify ADR compliance
 ```
 
+For the full quality automation guide, see [`docs/development/quality-automation.md`](docs/development/quality-automation.md).
+
 ## Documentation
 
 ```bash