/level-up

description: See your feature roadmap and get a personalized hint on what to try next.
disable-model-invocation: true
allowed-tools: Read, Write, Bash

Level Up

You are the level-up advisor for the guide plugin.

Step 1 — Check prerequisites and game mode status

First, check if jq is available by running: `command -v jq >/dev/null 2>&1 && echo "ok" || echo "missing"`

If jq is missing, tell the user:

> Level-up requires **jq** for game mode tracking to work. Install it first: > > | 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 until jq is available.

Read `${CLAUDE_PLUGIN_ROOT}/.local/game-data.json`.

If the file does not exist or `enabled` is false, skip to the **Game Mode Pitch** section below.

Step 2 — Build the roadmap

Using the data from `game-data.json`, determine the belt level for each feature using the threshold table below.

Belt thresholds (powers of 2, same scale for all features)

| Count | Belt | Emoji | Display | |---|---|---|---| | 0–15 | White | `⚪` | White Belt | | 16–31 | Yellow | `🟡` | Yellow Belt | | 32–63 | Orange | `🟠` | Orange Belt | | 64–127 | Green | `🟢` | Green Belt | | 128–255 | Blue | `🔵` | Blue Belt | | 256–511 | Brown | `🟤` | Brown Belt | | 512+ | Black | `⚫` | Black Belt (see dans below) |

Black belt dans

For features with 512+ uses, compute dan rank from the count:

| Count | Dan | Display suffix | |---|---|---| | 512–1023 | — | (none) | | 1024–2047 | 1st Dan | ◻ | | 2048–4095 | 2nd Dan | ◻◻ | | 4096–8191 | 3rd Dan | ◻◻◻ | | 8192–16383 | 4th Dan | ◻◻◻◻ | | 16384+ | 5th Dan | ◻◻◻◻◻ |

`◻` (U+25FB) represents a white stripe on the black belt. Maximum 5 dans.

Feature categorization

For each feature, determine its state:

• **Belt level** — look up belt from count using the threshold table above
• **Locked** — at least one dependency has count = 0 (show `🔒`)

Dependency graph

| Feature | Tier | Requires | |---|---|---| | shell | Beginner | — | | editing | Beginner | — | | reading | Beginner | — | | search | Beginner | — | | btw | Beginner | — | | skills | Intermediate | — | | web | Intermediate | — | | planning | Intermediate | — | | notebooks | Intermediate | — | | mcp | Intermediate | — | | plugins | Intermediate | — | | loop | Intermediate | — | | tasks | Intermediate | — | | agents | Expert | skills + planning | | worktrees | Expert | agents | | introspection | Expert | — |

Show ALL features in the roadmap, including beginner features. Beginner features are foundational — showing them helps users see their full progression.

Roadmap format

Present features grouped by tier with belt emoji, use count, and belt label. Example:

🥋  FEATURE ROADMAP
═══════════════════════════════════════════════

  Beginner
  ────────────────────────────────────────────
  ⚪ Shell Commands  (0 uses)     White Belt
  ⚪ Code Editing    (0 uses)     White Belt
  ⚪ File Reading    (0 uses)     White Belt
  ⚪ Code Search     (0 uses)     White Belt
  ⚪ Quick Aside     (0 uses)     White Belt
                    ⬇️
  Intermediate
  ────────────────────────────────────────────
  ⚪ Skills         (12 uses)    White Belt
  🟡 Web Research   (22 uses)    Yellow Belt
  ⚪ MCP Tools      (4 uses)     White Belt
  ⚪ Plugins        (2 uses)     White Belt
  ⚪ Loop           (5 uses)     White Belt
  ⚪ Planning       (0 uses)     White Belt
  ⚪ Notebooks      (0 uses)     White Belt
  ⚪ Task Mgmt      (0 uses)     White Belt
                    ⬇️
  Expert
  ────────────────────────────────────────────
  🔒 Sub Agents     (needs: planning)
  🔒 Worktrees      (needs: agents)
  ⚪ Introspection  (0 uses)     White Belt

═══════════════════════════════════════════════
  ⚪ White  🟡 Yellow  🟠 Orange  🟢 Green
  🔵 Blue   🟤 Brown   ⚫ Black   🔒 Locked
  ◻ = Dan (black belt stripe)
═══════════════════════════════════════════════
````

Advanced user example with dans:

````text
🥋  FEATURE ROADMAP
═══════════════════════════════════════════════

  Beginner
  ────────────────────────────────────────────
  ⚫ Shell Commands  (2400 uses)  Black Belt ◻◻
  ⚫ Code Editing    (1800 uses)  Black Belt ◻
  ⚫ File Reading    (3200 uses)  Black Belt ◻◻
  🟤 Code Search     (320 uses)   Brown Belt
  🟡 Quick Aside     (18 uses)    Yellow Belt
                    ⬇️
  Intermediate
  ────────────────────────────────────────────
  ⚫ Skills         (1200 uses)  Black Belt ◻
  🟤 Web Research   (310 uses)   Brown Belt
  🟢 MCP Tools      (85 uses)    Green Belt
  🔵 Plugins        (152 uses)   Blue Belt
  🟤 Loop           (480 uses)   Brown Belt
  🟠 Planning       (45 uses)    Orange Belt
  🟡 Notebooks      (16 uses)    Yellow Belt
  🟠 Task Mgmt      (38 uses)    Orange Belt
                    ⬇️
  Expert
  ────────────────────────────────────────────
  🟢 Sub Agents     (72 uses)    Green Belt
  🟡 Worktrees      (20 uses)    Yellow Belt
  🟠 Introspection  (38 uses)    Orange Belt

═══════════════════════════════════════════════
  ⚪ White  🟡 Yellow  🟠 Orange  🟢 Green
  🔵 Blue   🟤 Brown   ⚫ Black   🔒 Locked
  ◻ = Dan (black belt stripe)
═══════════════════════════════════════════════
````

Adapt the layout to the user's actual data. Keep features in dependency-table order (not sorted by belt rank) so positions are stable across sessions. Locked features show `🔒` and mention what they need.

## Step 3 — Give a hint

From all **unlocked** features (not `🔒`), pick the single best one to recommend using this priority:

1. **Sort by belt rank ascending** — White < Yellow < Orange < Green < Blue < Brown < Black. Lower belt = higher priority.
2. **Break ties by tier descending** — Expert