Shell
#!/bin/bash
# =============================================================================
# REFLECTION GATE HOOK
# Agentic Architecture Pattern #1: Reflection
#
# Triggers self-critique and refinement for significant code outputs.
# Based on: Generate → Critique → Refine pattern
# =============================================================================
HOOK_DIR="$(dirname "$0")"
LOG_FILE="$HOME/.claude/debug/reflection-gate.log"
# Ensure log directory exists
mkdir -p "$(dirname "$LOG_FILE")"
log() {
echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" >> "$LOG_FILE"
}
# Get the file that was just written/edited
FILE_PATH="${CLAUDE_FILE_PATH:-$1}"
TOOL_NAME="${CLAUDE_TOOL_NAME:-Write}"
# Skip if no file path
if [[ -z "$FILE_PATH" ]]; then
exit 0
fi
# Get file extension
EXT="${FILE_PATH##*.}"
# Only trigger reflection for significant code files
SIGNIFICANT_EXTENSIONS="ts tsx js jsx py rs go java kt swift"
if [[ ! " $SIGNIFICANT_EXTENSIONS " =~ " $EXT " ]]; then
exit 0
fi
# Check file size - only reflect on substantial changes (>50 lines)
if [[ -f "$FILE_PATH" ]]; then
LINE_COUNT=$(wc -l < "$FILE_PATH" | tr -d ' ')
if [[ "$LINE_COUNT" -lt 50 ]]; then
log "Skipping reflection for $FILE_PATH ($LINE_COUNT lines - below threshold)"
exit 0
fi
fi
# Check if this is a new file or significant edit
CHANGE_TYPE="modified"
if [[ "$TOOL_NAME" == "Write" ]]; then
CHANGE_TYPE="created"
fi
log "Reflection gate triggered for $FILE_PATH ($CHANGE_TYPE, $LINE_COUNT lines)"
# Signal to Claude that reflection should occur
# This creates a marker file that Claude's instructions will check
REFLECTION_MARKER="$HOME/.claude/session-env/pending-reflection.json"
cat > "$REFLECTION_MARKER" << EOF
{
"file": "$FILE_PATH",
"change_type": "$CHANGE_TYPE",
"line_count": "$LINE_COUNT",
"timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
"reflection_requested": true
}
EOF
# Output to Claude (this becomes part of the hook response)
echo "REFLECTION_TRIGGER: Significant code change detected in $FILE_PATH ($LINE_COUNT lines). Consider self-critique before proceeding."
exit 0