yitzwillroth · March 12, 2026 13:47
diff --git a/README.md b/README.md
diff --git a/approve-SKILL.md b/approve-SKILL.md
diff --git a/complete-SKILL.md b/complete-SKILL.md
diff --git a/handoff-SKILL.md b/handoff-SKILL.md
diff --git a/implement-SKILL.md b/implement-SKILL.md
diff --git a/plan-SKILL.md b/plan-SKILL.md
diff --git a/planning-mode-gate.sh b/planning-mode-gate.sh
 #!/bin/bash
 # Planning Mode Gate — PreToolUse hook (tested and working)
 # Blocks Edit, Write, and NotebookEdit when the current session is in planning mode.
 # Planning sessions are tracked in ~/.claude/planning-sessions.json
 # Format: ["session-id-1", "session-id-2"]

 PLANNING_FILE="$HOME/.claude/planning-sessions.json"

 # Read hook input from stdin
 input=$(cat)
 session_id=$(echo "$input" | jq -r '.session_id')
 tool_name=$(echo "$input" | jq -r '.tool_name')

 # If no planning file exists, allow everything
 if [[ ! -f "$PLANNING_FILE" ]]; then
  exit 0
 fi

 # Check if this session is in planning mode
 in_planning=$(jq -r --arg sid "$session_id" 'if type == "array" then map(select(. == $sid)) | length else 0 end' "$PLANNING_FILE" 2>/dev/null)

 if [[ "$in_planning" -gt 0 ]]; then
  # Session is in planning mode — block editing tools
  case "$tool_name" in
    Edit|Write|NotebookEdit)
      # Output JSON to block the tool with a reason
      cat <<'BLOCK'
 {"decision":"block","reason":"Planning mode is active. Finish your plan and get approval before editing code. Use /approve to exit planning mode."}
 BLOCK
      exit 0
      ;;
  esac
 fi

 # Allow everything else
 exit 0
diff --git a/planning-mode-toggle.sh b/planning-mode-toggle.sh
 #!/bin/bash
 # Planning Mode Toggle — used by /plan and /plan-approve skills
 # Usage: planning-mode-toggle.sh activate
 #        planning-mode-toggle.sh deactivate

 ACTION="$1"
 PLANNING_FILE="$HOME/.claude/planning-sessions.json"
 PROJECT_DIR="$HOME/.claude/projects"

 # Find the most recently modified transcript to get session ID
 TRANSCRIPT=$(ls -t "$PROJECT_DIR"/*/*.jsonl 2>/dev/null | head -1)
 SESSION_ID=$(basename "$TRANSCRIPT" .jsonl)

 if [[ -z "$SESSION_ID" ]]; then
  echo "ERROR: Could not determine session ID"
  exit 1
 fi

 case "$ACTION" in
  activate)
    if [[ -f "$PLANNING_FILE" ]]; then
      jq --arg sid "$SESSION_ID" 'if index($sid) then . else . + [$sid] end' "$PLANNING_FILE" > /tmp/planning-tmp.json
      mv /tmp/planning-tmp.json "$PLANNING_FILE"
    else
      jq -n --arg sid "$SESSION_ID" '[$sid]' > "$PLANNING_FILE"
    fi
    echo "✅ Planning mode activated for session $SESSION_ID"
    echo "Edit/Write/NotebookEdit tools are now blocked."
    ;;
  deactivate)
    if [[ -f "$PLANNING_FILE" ]]; then
      jq --arg sid "$SESSION_ID" 'map(select(. != $sid))' "$PLANNING_FILE" > /tmp/planning-tmp.json
      mv /tmp/planning-tmp.json "$PLANNING_FILE"
      echo "✅ Planning mode deactivated for session $SESSION_ID"
      echo "Edit/Write/NotebookEdit tools are now unlocked."
    else
      echo "⚠️ No planning sessions file found — editing was already unlocked."
    fi
    ;;
  *)
    echo "Usage: planning-mode-toggle.sh [activate|deactivate]"
    exit 1
    ;;
 esac
diff --git a/release-SKILL.md b/release-SKILL.md
diff --git a/remediate-SKILL.md b/remediate-SKILL.md
Skill	Purpose	Status Transition
`/plan`	Explore codebase, write plan document to Linear	— (creates document)
`/approve`	Finalize artifacts, create parent issue, attach plan	→ Scheduling
`/release`	Release planned work for implementation	Scheduling → Queueing
`/implement`	Break down into subtasks/checklists, start coding	Queueing → Working
`/handoff`	End-of-session: enrich artifacts, save progress	— (stays Working)
`/remediate`	Post organized review feedback, route back for fixes	Reviewing → Queueing
`/complete`	Mark as Running after human review	Reviewing → Running
name	approve
description	Approve a plan and finalize Linear artifacts. Unlocks editing tools, creates parent issue if needed, attaches plan document, and moves to Scheduling status. Does NOT start implementation — use /implement for that.
name	complete
description	Mark a Linear issue as Running after user review. Usage: /complete TEC-123. Dispatches via haiku subagent.
name	handoff
description	End-of-session review. Enriches Linear artifacts with insights, updates checklist progress, and saves durable learnings to memory. Use when wrapping up a session before context gets stale.
name	implement
description	Start implementation of a planned issue. Creates subtasks (features) or checklists (tasks), builds a TodoWrite list, and begins coding. Invoke with /implement TEC-123 or just /implement if the target is clear from context.
name	plan
description	Enter custom planning mode. Locks editing tools, guides thorough codebase exploration, and writes the plan to a Linear document. Invoke with /plan TEC-12, /plan hubble, or just /plan. Supports an optional prompt after the target.
Input	Target	Prompt
`/plan TEC-12 refactor the buffer to use Redis`	Issue TEC-12	"refactor the buffer to use Redis"
`/plan hubble add rate limiting`	Project hubble	"add rate limiting"
`/plan hubble`	Project hubble	(none — explore and ask)
`/plan add rate limiting to the buffer`	ask project	"add rate limiting to the buffer"
`/plan`	(none)	(none — ask everything)
	#!/bin/bash
	# Planning Mode Gate — PreToolUse hook (tested and working)
	# Blocks Edit, Write, and NotebookEdit when the current session is in planning mode.
	# Planning sessions are tracked in ~/.claude/planning-sessions.json
	# Format: ["session-id-1", "session-id-2"]

	PLANNING_FILE="$HOME/.claude/planning-sessions.json"

	# Read hook input from stdin
	input=$(cat)
	session_id=$(echo "$input" \| jq -r '.session_id')
	tool_name=$(echo "$input" \| jq -r '.tool_name')

	# If no planning file exists, allow everything
	if [[ ! -f "$PLANNING_FILE" ]]; then
	exit 0
	fi

	# Check if this session is in planning mode
	in_planning=$(jq -r --arg sid "$session_id" 'if type == "array" then map(select(. == $sid)) \| length else 0 end' "$PLANNING_FILE" 2>/dev/null)

	if [[ "$in_planning" -gt 0 ]]; then
	# Session is in planning mode — block editing tools
	case "$tool_name" in
	Edit\|Write\|NotebookEdit)
	# Output JSON to block the tool with a reason
	cat <<'BLOCK'
	{"decision":"block","reason":"Planning mode is active. Finish your plan and get approval before editing code. Use /approve to exit planning mode."}
	BLOCK
	exit 0
	;;
	esac
	fi

	# Allow everything else
	exit 0
	#!/bin/bash
	# Planning Mode Toggle — used by /plan and /plan-approve skills
	# Usage: planning-mode-toggle.sh activate
	# planning-mode-toggle.sh deactivate

	ACTION="$1"
	PLANNING_FILE="$HOME/.claude/planning-sessions.json"
	PROJECT_DIR="$HOME/.claude/projects"

	# Find the most recently modified transcript to get session ID
	TRANSCRIPT=$(ls -t "$PROJECT_DIR"//.jsonl 2>/dev/null \| head -1)
	SESSION_ID=$(basename "$TRANSCRIPT" .jsonl)

	if [[ -z "$SESSION_ID" ]]; then
	echo "ERROR: Could not determine session ID"
	exit 1
	fi

	case "$ACTION" in
	activate)
	if [[ -f "$PLANNING_FILE" ]]; then
	jq --arg sid "$SESSION_ID" 'if index($sid) then . else . + [$sid] end' "$PLANNING_FILE" > /tmp/planning-tmp.json
	mv /tmp/planning-tmp.json "$PLANNING_FILE"
	else
	jq -n --arg sid "$SESSION_ID" '[$sid]' > "$PLANNING_FILE"
	fi
	echo "✅ Planning mode activated for session $SESSION_ID"
	echo "Edit/Write/NotebookEdit tools are now blocked."
	;;
	deactivate)
	if [[ -f "$PLANNING_FILE" ]]; then
	jq --arg sid "$SESSION_ID" 'map(select(. != $sid))' "$PLANNING_FILE" > /tmp/planning-tmp.json
	mv /tmp/planning-tmp.json "$PLANNING_FILE"
	echo "✅ Planning mode deactivated for session $SESSION_ID"
	echo "Edit/Write/NotebookEdit tools are now unlocked."
	else
	echo "⚠️ No planning sessions file found — editing was already unlocked."
	fi
	;;
	*)
	echo "Usage: planning-mode-toggle.sh [activate\|deactivate]"
	exit 1
	;;
	esac
name	release
description	Move a planned issue from Scheduling to Queueing, releasing it for implementation. Usage: /release TEC-123. Dispatches via haiku subagent.