Skip to content
Shell
2.1 KB
Raw Blame
#!/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