Initial commit

hooks/handlers/subagent_stop_handler.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'claude_hooks'
+
+# SubagentStop Handler
+#
+# PURPOSE: Process and enhance results from completed subagent tasks
+# TRIGGERS: When a subagent (spawned via Task tool) completes execution
+#
+# COMMON USE CASES:
+# - Extract and cache key insights from subagent results
+# - Log subagent performance metrics
+# - Process and transform subagent outputs
+# - Trigger follow-up actions based on subagent results
+# - Aggregate results from multiple subagent executions
+# - Update project state based on subagent findings
+#
+# SETTINGS.JSON CONFIGURATION:
+# {
+#   "hooks": {
+#     "SubagentStop": [{
+#       "matcher": "",
+#       "hooks": [{
+#         "type": "command",
+#         "command": "${CLAUDE_PLUGIN_ROOT}/hooks/entrypoints/subagent_stop.rb"
+#       }]
+#     }]
+#   }
+# }
+
+class SubagentStopHandler < ClaudeHooks::SubagentStop
+  def call
+    log "Processing subagent completion for session: #{session_id}"
+
+    # Example: Extract key insights from subagent result
+    # extract_subagent_insights
+
+    # Example: Cache subagent results for reuse
+    # cache_subagent_results
+
+    # Example: Log subagent performance metrics
+    # log_subagent_metrics
+
+    # Example: Trigger follow-up actions
+    # trigger_follow_up_actions
+
+    # Allow subagent stop to proceed normally
+    allow_continue!
+
+    output_data
+  end
+end
+
+# Testing support - run this file directly to test with sample data
+if __FILE__ == $PROGRAM_NAME
+  ClaudeHooks::CLI.test_runner(SubagentStopHandler) do |input_data|
+    input_data['session_id'] = 'test-subagent-01'
+    input_data['subagent_type'] = 'code-explorer'
+  end
+end