Add ffg-state.sh - Git-as-Truth automation tool

WHAT: Created executable script for instant workspace reality check

WHY: Gemini consultation recommended automating Git-as-Truth discipline
to reduce conversational turns and prevent context drift

Output includes:
- Recent commits (last 5)
- Working tree status
- Next immediate action from handoff
- Timestamp for session tracking

Usage: ./ffg-state.sh (from repo root)

Part of Process Audit improvements:
- Anchor Hook (10-turn context refresh)
- Tactical Handshake (standardized boot acknowledgment)
- Micro-Handoffs (WIP commits for RV resilience)
- ffg-state.sh (this script)

File: ffg-state.sh (26 lines)

Sign-off: Claude (Chronicler #60)
Email: claude@firefrostgaming.com
This commit is contained in:
Claude
2026-04-04 04:45:58 +00:00
parent d04b2bbdd8
commit d858fde858

25
ffg-state.sh Executable file
View File

@@ -0,0 +1,25 @@
#!/bin/bash
# FFG State Check - Quick reality snapshot
# Run: ./ffg-state.sh
echo "═══════════════════════════════════════════════"
echo "FFG STATE CHECK - $(date '+%Y-%m-%d %H:%M:%S %Z')"
echo "═══════════════════════════════════════════════"
echo ""
echo "=== RECENT COMMITS ==="
git log --oneline -n 5
echo ""
echo "=== WORKING TREE ==="
git status -s
if [ -z "$(git status -s)" ]; then
echo "(clean)"
fi
echo ""
echo "=== NEXT IMMEDIATE ACTION ==="
grep -A 2 "Next Immediate Action\|Next Session Priorities\|NEXT SESSION" SESSION-HANDOFF-NEXT.md 2>/dev/null | head -5 || echo "(not found in handoff)"
echo ""
echo "═══════════════════════════════════════════════"