mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-06-27 13:01:50 +00:00
e289ce906f
* Add context resilience: file-backed state, incremental writing, auto-recovery Prevents "prompt too long" crashes from killing sessions by persisting work to disk incrementally instead of relying on conversation memory. Changes: - pre-compact.sh: dumps session state before context compression - session-start.sh: detects active.md for crash recovery - session-stop.sh: archives and clears active.md on clean shutdown - context-management.md: file-backed state as primary strategy - 9 agents updated with incremental section writing protocol (game-designer, systems-designer, economy-designer, narrative-director, level-designer, world-builder, writer, art-director, audio-director) - CLAUDE.md: trimmed redundant imports (10 → 5) to reduce token overhead - design-docs.md rule: enforces incremental writing pattern - .gitignore: excludes ephemeral session state files - directory-structure.md: documents session-state/ and session-logs/ - COLLABORATIVE-DESIGN-PRINCIPLE.md: documents incremental writing pattern Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Add AskUserQuestion integration across collaborative protocols Explicitly reference the AskUserQuestion tool in all collaborative agent definitions, protocol templates, team orchestrator skills, and the master principle doc. Introduces the Explain-then-Capture pattern: agents write full expert analysis in conversation, then call AskUserQuestion with concise labels to capture decisions via structured UI. 26 files updated: - 3 protocol templates (design, leadership, implementation) - 14 agent definitions (10 design + 3 leadership + writer) - 8 orchestrator skills (brainstorm + 7 team-*) - 1 master principle doc (COLLABORATIVE-DESIGN-PRINCIPLE.md) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Add /design-systems skill: concept-to-GDD decomposition workflow Bridges the gap between game concept and per-system design documents. Professional studios use systems enumeration + dependency sorting between concept and feature docs — skipping this step is one of the most expensive mistakes (systems discovered during production cost 5-10x more to add). New files: - .claude/skills/design-systems/SKILL.md — 7-phase orchestration skill (enumerate systems, map dependencies, assign priorities, write GDDs) - .claude/docs/templates/systems-index.md — master tracking template Flow integration (7 existing skills updated): - brainstorm, start, setup-engine, design-review, gate-check, project-stage-detect, game-concept template all reference /design-systems at the appropriate workflow touchpoints Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Fix cross-platform bugs, add missing tool permissions, and update docs for v0.2.0 Hooks: fix \s → [[:space:]] in grep -E fallbacks (3 files), fix detect-gaps.sh empty-variable bug, fix log-agent.sh field name (agent_name → agent_type), harden validate-push.sh with explicit $MATCHED_BRANCH, convert for-in loops to while-read for space-safe iteration, add POSIX head -n syntax, increase PreCompact timeout, widen session-stop log window. Skills: add AskUserQuestion to 10 skills and TodoWrite to 8 multi-phase skills. Fix project-stage-detect template/output paths, tech-artist → technical-artist. Docs: add /design-systems to all references (README, quick-start, workflow guide, skills-reference), update skill count 35 → 36, remove stale AI artifacts from COLLABORATIVE-DESIGN-PRINCIPLE.md, add AskUserQuestion note to examples README. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
76 lines
2.2 KiB
Bash
76 lines
2.2 KiB
Bash
#!/bin/bash
|
|
# Claude Code SessionStart hook: Load project context at session start
|
|
# Outputs context information that Claude sees when a session begins
|
|
#
|
|
# Input schema (SessionStart): No stdin input
|
|
|
|
echo "=== Claude Code Game Studios — Session Context ==="
|
|
|
|
# Current branch
|
|
BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
|
|
if [ -n "$BRANCH" ]; then
|
|
echo "Branch: $BRANCH"
|
|
|
|
# Recent commits
|
|
echo ""
|
|
echo "Recent commits:"
|
|
git log --oneline -5 2>/dev/null | while read -r line; do
|
|
echo " $line"
|
|
done
|
|
fi
|
|
|
|
# Current sprint (find most recent sprint file)
|
|
LATEST_SPRINT=$(ls -t production/sprints/sprint-*.md 2>/dev/null | head -1)
|
|
if [ -n "$LATEST_SPRINT" ]; then
|
|
echo ""
|
|
echo "Active sprint: $(basename "$LATEST_SPRINT" .md)"
|
|
fi
|
|
|
|
# Current milestone
|
|
LATEST_MILESTONE=$(ls -t production/milestones/*.md 2>/dev/null | head -1)
|
|
if [ -n "$LATEST_MILESTONE" ]; then
|
|
echo "Active milestone: $(basename "$LATEST_MILESTONE" .md)"
|
|
fi
|
|
|
|
# Open bug count
|
|
BUG_COUNT=0
|
|
for dir in tests/playtest production; do
|
|
if [ -d "$dir" ]; then
|
|
count=$(find "$dir" -name "BUG-*.md" 2>/dev/null | wc -l)
|
|
BUG_COUNT=$((BUG_COUNT + count))
|
|
fi
|
|
done
|
|
if [ "$BUG_COUNT" -gt 0 ]; then
|
|
echo "Open bugs: $BUG_COUNT"
|
|
fi
|
|
|
|
# Code health quick check
|
|
if [ -d "src" ]; then
|
|
TODO_COUNT=$(grep -r "TODO" src/ 2>/dev/null | wc -l)
|
|
FIXME_COUNT=$(grep -r "FIXME" src/ 2>/dev/null | wc -l)
|
|
if [ "$TODO_COUNT" -gt 0 ] || [ "$FIXME_COUNT" -gt 0 ]; then
|
|
echo ""
|
|
echo "Code health: ${TODO_COUNT} TODOs, ${FIXME_COUNT} FIXMEs in src/"
|
|
fi
|
|
fi
|
|
|
|
# --- Active session state recovery ---
|
|
STATE_FILE="production/session-state/active.md"
|
|
if [ -f "$STATE_FILE" ]; then
|
|
echo ""
|
|
echo "=== ACTIVE SESSION STATE DETECTED ==="
|
|
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:"
|
|
head -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)"
|
|
fi
|
|
echo "=== END SESSION STATE PREVIEW ==="
|
|
fi
|
|
|
|
echo "==================================="
|
|
exit 0
|