From faa7b0fce87451760cb74d6d130c1d0c8b09fee8 Mon Sep 17 00:00:00 2001
From: carlos-alm <127798846+carlos-alm@users.noreply.github.com>
Date: Wed, 25 Mar 2026 23:32:44 -0600
Subject: [PATCH] docs: add harness engineering cross-reference in
 CONTRIBUTING.md

Point contributors to docs/contributing/harness-engineering.md for
Claude Code hook work.
---
 CONTRIBUTING.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e27865f3..0dd5074e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -263,6 +263,14 @@ generics, nested types):
 2. Add a `case` in the corresponding `extract<Lang>Symbols()` function
 3. Add a test case in `tests/parsers/<lang>.test.js`
 
+### Harness Engineering (Claude Code Hooks)
+
+If you're working on the Claude Code hooks in `.claude/hooks/`, see the dedicated guide:
+
+**[Harness Engineering Guide](docs/contributing/harness-engineering.md)**
+
+This covers the principles behind AI agent harnesses, how our hooks work, and how to add or modify them.
+
 ### Documentation
 
 Documentation improvements are always welcome. The main docs live in: