feat(hooks): add build-check Stop/SubagentStop hook

When Claude or a subagent finishes, run `make compile` to catch
syntax/compilation errors early; on failure, block and feed a parsed
error summary back to Claude (falling back to the tail of the output
when no error lines match). Written in Bash; matches on hook_event_name
Stop/SubagentStop and parses the payload with jq.

Stacked on hooks-1-editorconfig.

Signed-off-by: Edmund Miller <edmund.miller@seqera.io>

Author: edmundmiller

.claude/README.md

@@ -23,6 +23,13 @@ understood on its own. This file documents the hooks that are currently wired up
   skips silently if it is not present)
 - **Failure mode**: non-blocking — prints a warning, never stops Claude
 
+### 2. Build check (Stop + SubagentStop)
+- **Script**: `hooks/check-build.sh`
+- **Trigger**: when Claude (or a subagent) finishes responding
+- **Action**: runs `make compile` to catch syntax/compilation errors early
+- **Failure mode**: blocking — feeds a parsed error summary back to Claude so it
+  can fix the breakage before yielding
+
 ## Enabling / disabling
 
 Hooks are configured in `.claude/settings.json`. Disable one by removing its entry;

.claude/hooks/check-build.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+#
+# Build check hook for Nextflow development.
+#
+# On Stop / SubagentStop, run `make compile` to catch syntax and compilation
+# errors. On failure, block and feed a parsed error summary back to Claude.
+#
+# Reads the Claude Code hook payload as JSON on stdin (requires `jq`).
+
+set -uo pipefail
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+input=$(cat)
+event=$(jq -r '.hook_event_name // ""' <<<"$input")
+
+case "$event" in
+  Stop|SubagentStop) ;;
+  *) exit 0 ;;
+esac
+
+start=$SECONDS
+if out=$(make compile 2>&1); then
+  jq -n --arg s "$(( SECONDS - start ))" \
+    '{suppressOutput: true, systemMessage: ("✓ Build check passed (" + $s + "s)")}'
+else
+  summary=$(printf '%s\n' "$out" | grep -iE 'error|failed|exception' | tail -n 10)
+  [[ -n "$summary" ]] || summary=$(printf '%s\n' "$out" | tail -n 20)
+  jq -n --arg r "Build check failed:
+$summary" \
+    '{decision: "block", reason: $r, stopReason: "Build compilation failed"}'
+fi

.claude/settings.json

@@ -11,6 +11,28 @@
           }
         ]
       }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/check-build.sh",
+            "timeout": 120
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/check-build.sh",
+            "timeout": 120
+          }
+        ]
+      }
     ]
   }
 }