Game Mode

Game Mode

You are managing the game-mode feature for the guide plugin.

Prerequisite — jq

Before any game-mode operation, run: command -v jq >/dev/null 2>&1 && echo "ok" || echo "missing"

If jq is missing, tell the user:

Game mode tracking requires jq (a JSON processor). Install it, then re-run this command:

Platform	Install command
macOS	brew install jq
Linux (apt)	sudo apt install jq
Linux (yum)	sudo yum install jq
Windows (Git Bash)	mkdir -p ~/bin && curl -sL https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-windows-amd64.exe -o ~/bin/jq.exe && chmod +x ~/bin/jq.exe

Or just ask me: "install jq"

Then stop — do not proceed with game mode until jq is available.

Branch on $ARGUMENTS:

help

Present the available commands:

Command	What it does
/guide:game-mode	Enable game mode and start tracking
/guide:game-mode stats	Show your dashboard with scores and levels
/guide:game-mode help	Show this help
/guide:game-mode off	Pause tracking (data preserved)
/guide:game-mode reset	Delete all game data
/guide:level-up	Show your feature roadmap and next-step hint

on (or empty arguments)

Migration check (runs first if data file already exists)

1. If ${CLAUDE_PLUGIN_ROOT}/.local/game-data.json exists, read it and read the current version from ${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json
2. If pluginVersion is missing or doesn't match the plugin version: a. Snapshot: Copy game-data.json to .local/game-data.pre-<new-version>.json as a backup b. Migrate: Add any missing feature categories with {"count": 0, "lastUsed": null}, add missing top-level fields (pluginVersion, migrations, sessionCount, suggestedFeatures, tokens, skillUsage, mcpUsage, agentUsage) with defaults, set pluginVersion to the current plugin version c. Record: Append {"from": "<old-version-or-unknown>", "to": "<new-version>", "date": "<UTC date YYYY-MM-DD>"} to the migrations array d. Inform: Tell the user their data was migrated and a backup was saved at the snapshot path e. Set enabled to true and proceed (skip creating a fresh file)
3. If versions match: set enabled to true and proceed (skip creating a fresh file)

Fresh install (no existing data file)

1. Create the directory ${CLAUDE_PLUGIN_ROOT}/.local/ if it doesn't exist
2. Read the current version from ${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json
3. Write ${CLAUDE_PLUGIN_ROOT}/.local/game-data.json with this initial content:

{
  "pluginVersion": "<version from plugin.json>",
  "enabled": true,
  "startDate": "<current UTC date in YYYY-MM-DD format>",
  "sessionCount": 0,
  "suggestedFeatures": [],
  "migrations": [],
  "features": {
    "shell":     { "count": 0, "lastUsed": null },
    "editing":   { "count": 0, "lastUsed": null },
    "reading":   { "count": 0, "lastUsed": null },
    "search":    { "count": 0, "lastUsed": null },
    "agents":    { "count": 0, "lastUsed": null },
    "skills":    { "count": 0, "lastUsed": null },
    "plugins":   { "count": 0, "lastUsed": null },
    "web":       { "count": 0, "lastUsed": null },
    "planning":  { "count": 0, "lastUsed": null },
    "mcp":       { "count": 0, "lastUsed": null },
    "notebooks": { "count": 0, "lastUsed": null },
    "loop":      { "count": 0, "lastUsed": null },
    "btw":       { "count": 0, "lastUsed": null },
    "tasks":     { "count": 0, "lastUsed": null },
    "worktrees": { "count": 0, "lastUsed": null },
    "introspection": { "count": 0, "lastUsed": null }
  },
  "tokens": {
    "read": 0,
    "write": 0,
    "total": 0
  },
  "skillUsage": {},
  "mcpUsage": {},
  "agentUsage": {}
}

1. Tell the user game mode is now active. Mention:
   • Tool usage is being tracked across 16 feature categories
   • Use /guide:game-mode stats to see their dashboard
   • Use /guide:game-mode off to pause tracking
   • Data is stored locally and never transmitted

stats or status

Migration check (runs first)

1. Read ${CLAUDE_PLUGIN_ROOT}/.local/game-data.json
2. If the file doesn't exist or enabled is false, tell the user game mode is not active and suggest /guide:game-mode to enable it
3. Read the current version from ${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json
4. If pluginVersion is missing or doesn't match the plugin version: a. Snapshot: Copy game-data.json to .local/game-data.pre-<new-version>.json as a backup b. Migrate: Add any missing feature categories with {"count": 0, "lastUsed": null}, add missing top-level fields (skillUsage, mcpUsage, agentUsage, etc.) with defaults, set pluginVersion to current c. Record: Append {"from": "<old-version-or-unknown>", "to": "<new-version>", "date": "<UTC date YYYY-MM-DD>"} to the migrations array d. Inform: Tell the user their data was migrated and a backup was saved
5. If versions match: proceed normally

Calculate and display

1. Calculate scoring using these tier multipliers:

Tier	Multiplier	Features
Beginner	x1	shell, editing, reading, search, btw
Intermediate	x10	skills, plugins, web, planning, notebooks, mcp, loop, tasks
Expert	x100	agents, worktrees, introspection

1. Compute: raw_points = sum(feature.count * multiplier) and score = sqrt(raw_points) to 2 decimal places
2. Count unique features (count > 0)
3. Determine level (highest where BOTH criteria are met):

Level	Title	Min Score	Min Unique Features
1	Novice	0	0
2	Apprentice	5.00	3
3	Practitioner	15.00	5
4	Expert	30.00	8
5	Master	55.00	10

1. Present a formatted dashboard like this:

+=======================================================+
|  GAME MODE -- Level 4: Expert                         |
|  Score: 32.45  |  Active since: 2026-03-08            |
+=======================================================+
|  Feature         Tier  Count  Points  Last Used       |
|  --------------- ----- ------ ------- ----------      |
|  🟠 Shell Commands   B      45      45   2h ago       |
|  🟠 Code Editing     B      32      32   1h ago       |
|  🟡 File Reading     B      28      28   30m ago      |
|  🟡 Code Search      B      18      18   1h ago       |
|  ⚪ Quick Aside      B       0       0   never        |
|  ⚪ Skills           I       5      50   1d ago       |
|  ⚪ Plugins          I       2      20   3d ago       |
|  ⚪ Web Research     I       3      30   2d ago       |
|  ⚪ Planning         I       2      20   5d ago       |
|  ⚪ Notebooks        I       0       0   never        |
|  ⚪ Sub Agents       E       8     800   3h ago       |
|  ⚪ MCP Tools        I       1      10   7d ago       |
|  ⚪ Loop/Schedule    I       0       0   never        |
|  ⚪ Task Mgmt        I       0       0   never        |
|  ⚪ Worktrees        E       0       0   never        |
|  ⚪ Introspection    E       0       0   never        |
+=======================================================+
|  Raw: 1053 pts | Score: sqrt(1053) = 32.45            |
|  Features: 10/16 unlocked                             |
|  Tokens: ~12.4K read, ~3.1K write                     |
|  Next level: Master (score 55+, 10+ features)         |
|  Migrated: unknown → 2.2.0 (2026-03-09)              |
+=======================================================+

• For "Last Used", show relative time (e.g., "2h ago", "1d ago") or "never"
• For tokens, use human-friendly formatting (e.g., "12.4K")
• Show progress toward the next level, or "MAX LEVEL" if at level 5
• If the migrations array is non-empty, show each migration as Migrated: <from> → <to> (<date>) in the dashboard footer. Omit the line if there are no migrations.

off

1. Read ${CLAUDE_PLUGIN_ROOT}/.local/game-data.json
2. Set enabled to false
3. Write the file back
4. Tell the user tracking is paused. Their data is preserved — they can resume with /guide:game-mode anytime.

reset

1. Ask the user to confirm: "This will delete all your game mode data. Type 'yes' to confirm."
2. If confirmed, delete ${CLAUDE_PLUGIN_ROOT}/.local/game-data.json
3. Confirm the reset is complete