Fix: session-start preview shows most recent state instead of oldest (#43)

Replace head with tail so the quick summary surfaces the last 20 lines
of active.md — where all skills append their session extracts — rather
than the first 20 lines which grow stale as the file accumulates history.

Fixes #39

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

.claude/agents/godot-csharp-specialist.md

@@ -388,6 +388,16 @@ Do NOT rely on inline version claims in this file — they may be wrong. Always
 
 When in doubt, prefer the API documented in the reference files over your training data.
 
+## Tooling — ripgrep File Filtering
+
+**CRITICAL**: There is no `gdscript` type in ripgrep. `*.gd` files are registered
+under the `gap` type (GAP programming language). Using `--type gdscript` or passing
+`type: "gdscript"` to the Grep tool produces a hard error — the search never executes.
+
+**Always use `glob: "*.gd"`** when filtering GDScript files:
+- Grep tool: `glob: "*.gd"` ✓  |  `type: "gdscript"` ✗
+- Shell/CI: `rg --glob "*.gd"` ✓  |  `rg --type gdscript` ✗
+
 ## Coordination
 - Work with **godot-specialist** for overall Godot architecture and scene design
 - Work with **gameplay-programmer** for gameplay system implementation

.claude/agents/godot-gdextension-specialist.md

@@ -298,6 +298,16 @@ that may affect native bindings.
 
 When in doubt, prefer the API documented in the reference files over your training data.
 
+## Tooling — ripgrep File Filtering
+
+**CRITICAL**: There is no `gdscript` type in ripgrep. `*.gd` files are registered
+under the `gap` type (GAP programming language). Using `--type gdscript` or passing
+`type: "gdscript"` to the Grep tool produces a hard error — the search never executes.
+
+**Always use `glob: "*.gd"`** when filtering GDScript files:
+- Grep tool: `glob: "*.gd"` ✓  |  `type: "gdscript"` ✗
+- Shell/CI: `rg --glob "*.gd"` ✓  |  `rg --type gdscript` ✗
+
 ## Coordination
 - Work with **godot-specialist** for overall Godot architecture
 - Work with **godot-gdscript-specialist** for GDScript/native boundary decisions

.claude/agents/godot-gdscript-specialist.md

@@ -254,6 +254,16 @@ for the full list.
 
 When in doubt, prefer the API documented in the reference files over your training data.
 
+## Tooling — ripgrep File Filtering
+
+**CRITICAL**: There is no `gdscript` type in ripgrep. `*.gd` files are registered
+under the `gap` type (GAP programming language). Using `--type gdscript` or passing
+`type: "gdscript"` to the Grep tool produces a hard error — the search never executes.
+
+**Always use `glob: "*.gd"`** when filtering GDScript files:
+- Grep tool: `glob: "*.gd"` ✓  |  `type: "gdscript"` ✗
+- Shell/CI: `rg --glob "*.gd"` ✓  |  `rg --type gdscript` ✗
+
 ## Coordination
 - Work with **godot-specialist** for overall Godot architecture
 - Work with **gameplay-programmer** for gameplay system implementation

.claude/agents/godot-shader-specialist.md

@@ -246,6 +246,16 @@ stencil buffer (4.5), shader texture types changed from `Texture2D` to
 
 When in doubt, prefer the API documented in the reference files over your training data.
 
+## Tooling — ripgrep File Filtering
+
+**CRITICAL**: There is no `gdscript` type in ripgrep. `*.gd` files are registered
+under the `gap` type (GAP programming language). Using `--type gdscript` or passing
+`type: "gdscript"` to the Grep tool produces a hard error — the search never executes.
+
+**Always use `glob: "*.gd"`** when filtering GDScript files:
+- Grep tool: `glob: "*.gd"` ✓  |  `type: "gdscript"` ✗
+- Shell/CI: `rg --glob "*.gd"` ✓  |  `rg --type gdscript` ✗
+
 ## Coordination
 - Work with **godot-specialist** for overall Godot architecture
 - Work with **art-director** for visual direction and material standards

.claude/agents/godot-specialist.md

@@ -173,6 +173,16 @@ introduced after May 2025, use WebSearch to verify it exists in the current vers
 
 When in doubt, prefer the API documented in the reference files over your training data.
 
+## Tooling — ripgrep File Filtering
+
+**CRITICAL**: There is no `gdscript` type in ripgrep. `*.gd` files are registered
+under the `gap` type (GAP programming language). Using `--type gdscript` or passing
+`type: "gdscript"` to the Grep tool produces a hard error — the search never executes.
+
+**Always use `glob: "*.gd"`** when filtering GDScript files:
+- Grep tool: `glob: "*.gd"` ✓  |  `type: "gdscript"` ✗
+- Shell/CI: `rg --glob "*.gd"` ✓  |  `rg --type gdscript` ✗
+
 ## When Consulted
 Always involve this agent when:
 - Adding new autoloads or singletons

.claude/hooks/log-agent-stop.sh

@@ -2,16 +2,21 @@
 # Claude Code SubagentStop hook: Log agent completion for audit trail
 # Tracks when agents finish and their outcome
 #
-# Input schema (SubagentStop):
+# Input schema (SubagentStop) — per Claude Code hooks reference:
-# { "agent_id": "agent-abc123", "agent_name": "game-designer", ... }
+# { "session_id": "...", "agent_id": "agent-abc123", "agent_type": "Explore",
+#   "agent_transcript_path": "...", "last_assistant_message": "...", ... }
+#
+# The agent name is in `agent_type`, NOT `agent_name`. Reading `.agent_name`
+# returns null on every invocation, so the fallback "unknown" is always used
+# and the audit trail captures nothing useful.
 
 INPUT=$(cat)
 
 # Parse agent name -- use jq if available, fall back to grep
 if command -v jq >/dev/null 2>&1; then
-    AGENT_NAME=$(echo "$INPUT" | jq -r '.agent_name // "unknown"' 2>/dev/null)
+    AGENT_NAME=$(echo "$INPUT" | jq -r '.agent_type // "unknown"' 2>/dev/null)
 else
-    AGENT_NAME=$(echo "$INPUT" | grep -oE '"agent_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"agent_name"[[:space:]]*:[[:space:]]*"//;s/"$//')
+    AGENT_NAME=$(echo "$INPUT" | grep -oE '"agent_type"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"agent_type"[[:space:]]*:[[:space:]]*"//;s/"$//')
     [ -z "$AGENT_NAME" ] && AGENT_NAME="unknown"
 fi
 

.claude/hooks/log-agent.sh

@@ -2,16 +2,20 @@
 # Claude Code SubagentStart hook: Log agent invocations for audit trail
 # Tracks which agents are being used and when
 #
-# Input schema (SubagentStart):
+# Input schema (SubagentStart) — per Claude Code hooks reference:
-# { "agent_id": "agent-abc123", "agent_name": "game-designer", ... }
+# { "session_id": "...", "agent_id": "agent-abc123", "agent_type": "Explore", ... }
+#
+# The agent name is in `agent_type`, NOT `agent_name`. Reading `.agent_name`
+# returns null on every invocation, so the fallback "unknown" is always used
+# and the audit trail captures nothing useful.
 
 INPUT=$(cat)
 
 # Parse agent name -- use jq if available, fall back to grep
 if command -v jq >/dev/null 2>&1; then
-    AGENT_NAME=$(echo "$INPUT" | jq -r '.agent_name // "unknown"' 2>/dev/null)
+    AGENT_NAME=$(echo "$INPUT" | jq -r '.agent_type // "unknown"' 2>/dev/null)
 else
-    AGENT_NAME=$(echo "$INPUT" | grep -oE '"agent_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"agent_name"[[:space:]]*:[[:space:]]*"//;s/"$//')
+    AGENT_NAME=$(echo "$INPUT" | grep -oE '"agent_type"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"agent_type"[[:space:]]*:[[:space:]]*"//;s/"$//')
     [ -z "$AGENT_NAME" ] && AGENT_NAME="unknown"
 fi
 

.claude/hooks/session-start.sh

@@ -62,8 +62,8 @@ if [ -f "$STATE_FILE" ]; then
     echo "A previous session left state at: $STATE_FILE"
     echo "Read this file to recover context and continue where you left off."
     echo ""
-    echo "Quick summary:"
+    echo "Quick summary (last 20 lines):"
-    head -20 "$STATE_FILE" 2>/dev/null
+    tail -20 "$STATE_FILE" 2>/dev/null
     TOTAL_LINES=$(wc -l < "$STATE_FILE" 2>/dev/null)
     if [ "$TOTAL_LINES" -gt 20 ]; then
         echo "  ... ($TOTAL_LINES total lines — read the full file to continue)"

.claude/skills/architecture-decision/SKILL.md

@@ -3,7 +3,7 @@ name: architecture-decision
 description: "Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives considered, and consequences. Every major technical choice should have an ADR."
 argument-hint: "[title] [--review full|lean|solo]"
 user-invocable: true
-allowed-tools: Read, Glob, Grep, Write, Task, AskUserQuestion
+allowed-tools: Read, Glob, Grep, Write, Edit, Task, AskUserQuestion
 ---
 
 When this skill is invoked:

.claude/skills/story-done/SKILL.md

@@ -3,7 +3,7 @@ name: story-done
 description: "End-of-story completion review. Reads the story file, verifies each acceptance criterion against the implementation, checks for GDD/ADR deviations, prompts code review, updates story status to Complete, and surfaces the next ready story from the sprint."
 argument-hint: "[story-file-path] [--review full|lean|solo]"
 user-invocable: true
-allowed-tools: Read, Glob, Grep, Bash, Edit, AskUserQuestion, Task
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit, AskUserQuestion, Task
 ---
 
 # Story Done

.github/FUNDING.yml

@@ -1,2 +1,2 @@
-ko_fi: donchitos
+github: Donchitos
-# github: Donchitos  # Uncomment once GitHub Sponsors is approved
+buy_me_a_coffee: donchitos3

docs/engine-reference/godot/current-best-practices.md

@@ -93,6 +93,12 @@ This supplements (not replaces) the agent's built-in knowledge.
 - Live preview in Quick Open dialog when "Live Preview" enabled
 - New "Select Mode" (v key) prevents accidental transforms; old mode renamed "Transform Mode" (q key)
 
+## Tooling
+
+- **ripgrep has no `gdscript` type**: `*.gd` is registered under `gap` (GAP programming language).
+  `rg --type gdscript` is a hard error — the search never executes.
+  Always use `rg --glob "*.gd"` (shell) or `glob: "*.gd"` (Grep tool) to filter GDScript files.
+
 ## Platform (4.5+)
 
 - **visionOS export**: First new platform since open-sourcing (windowed app mode)