Gamification Guide ja

Gamification-Guide · [日本語]

ゲーミフィケーションガイド

cc-proficiencyはClaude Codeの使用状況を追跡するプログレッションシステムです。

新規インストールからバッジを最大化するまでの具体的なステップを説明します。

プログレッションシステムの仕組み
初日
1週目：モメンタムの構築
パワーユーザー：中級レベル
エキスパート：上級テクニック
ドメインウォークスルー
アチーブメントアンロックガイド
機能ミニバー：0から100へ
ストリークシステム
リーダーボード
深度スコアリング：数学
バッジの埋め込み
アンチゲーミングの透明性

プログレッションシステムの仕組み

3つのフェーズ

バッジはセッションを蓄積するにつれて進化します：

フェーズ	セッション数	発生すること
キャリブレーション	0--2	設定シグナルが2倍にブースト。セットアップの努力が倍に。バッジはセットアップチェックリストを表示。
初期	3--9	設定ブーストが1.5倍に低下。行動シグナルがフルウェイトでカウント開始。ドメインバーと機能ミニバーが表示。
完全	10+	行動が1.15倍にブースト、設定は1倍。定常状態 -- 実際の使用パターンがスコアを決定。

実際には： CLAUDE.md、hooks、pluginsを早めにセットアップしましょう。キャリブレーション中は設定だけでドメインを約50まで押し上げられます。10セッション後は、実際の行動（調査チェーン、プロンプト構造、エージェント使用）がスコアを決定します。

2種類の証拠

エンジンの各ルールは2つのうちの1つをチェックします：

タイプ	ソース	ドメインあたりのキャップ
設定	ディスク上のファイル：`CLAUDE.md`、hooks、plugins、`.claude/rules/`等	最大25ポイント
行動	トランスクリプトの証拠：ツールシーケンス、プロンプトパターン、エージェント使用	最大75ポイント

設定で開始し、行動で100に到達します。

5ドメイン、均等ウェイト

ドメイン	報酬対象
CC Mastery	ツールの理解：CLAUDE.md、hooks、plugins、skills、planモード、rules
Tool & MCP	スマートなツール使用：調査チェーン、Read-before-Edit、MCPサーバー
Agentic	オーケストレーション：サブエージェント、パラレルディスパッチ、worktree、バックグラウンドタスク
Prompt Craft	コミュニケーション：構造化リクエスト、コードブロック、エラートレース、ファイル参照
Context Mgmt	メモリ：CLAUDE.md更新、メモリファイル、持続的マルチセッションプロジェクト

各ドメインは総合スコアの20%です。弱いドメインを別のドメインへの過剰投資で補うことはできません。

初日

目標：インストール、設定、キャリブレーションフェーズに入る。

ステップ1：インストールと初期化

npm install -g cc-proficiency
cc-proficiency init

Stop hookをインストールし、初期分析を実行し、Gistバッジを作成します（ghが認証済みの場合）。

initだけのポイント： 0。設定またはセッションが最初に必要です。

ステップ2：CLAUDE.mdを作成する

まだグローバルCLAUDE.mdがない場合：

mkdir -p ~/.claude
cat > ~/.claude/CLAUDE.md << 'EOF'
# My Preferences

## Code Style
- Use TypeScript strict mode
- Prefer functional patterns
- Always add error handling

## Project Conventions
- Tests go in `tests/` mirroring `src/`
- Use vitest for testing
EOF

トリガーされるルール：

ルール	ポイント	ドメイン
`ccm-claudemd-exists`	+5	CC Mastery

ステップ3：CLAUDE.mdに構造を追加

CLAUDE.mdで@importディレクティブまたは## Section Headersを使用：

@import .claude/rules/code-style.md
@import .claude/rules/architecture.md

# My Preferences
## Code Style
...
## Architecture
...

ボーナスルールがトリガー：

ルール	ポイント	ドメイン
`ccm-claudemd-structured`	+10	CC Mastery

ステップ4：プラグインをインストール

# Claude Codeの設定でプラグインを追加：
claude plugins add @anthropic/github

ルール	ポイント	ドメイン
`ccm-plugins-installed`	+5	CC Mastery

ステップ5：最初の実際のセッションを実行

普通にClaude Codeを使用してください。実際のタスクに取り組みます。セッションが終了すると、hookが自動的に発火します。

cc-proficiency analyze

最初のセッションでアンロック：

アチーブメント	説明
First Steps	最初のセッションを完了

初日後の予想：

CC Mastery：15--25（キャリブレーション中は設定シグナルがブースト）
他のドメイン：セッションの行動に応じて0--15
1つのアチーブメントをアンロック

1週目：モメンタムの構築

目標：3セッションに到達（初期フェーズ）、設定シグナルを完成、行動の証拠を蓄積開始。

2-3日目：3セッションを完了

普通に作業してください。3セッションでフェーズがキャリブレーションから初期に移行します。設定ブーストが2倍から1.5倍に下がりますが、行動シグナルはフルウェイトでカウントされるようになります。

Hooksを設定する

Claude Codeの設定にカスタムhookを追加します：

{
  "hooks": {
    "PreToolUse:Edit": [
      { "command": "echo 'Editing file: $CC_FILE_PATH'" }
    ],
    "PostToolUse:Bash": [
      { "command": "echo 'Bash command completed'" }
    ]
  }
}

ルール	ポイント	ドメイン
`ccm-hooks-exist`	+10	CC Mastery
`ccm-hooks-with-matchers`	+15	CC Mastery（ツールマッチャーを持つ2+のhooks）

プロジェクトCLAUDE.mdを作成

プロジェクトルートで：

cat > CLAUDE.md << 'EOF'
# Project: my-app

## Architecture
- src/ -- source code
- tests/ -- vitest tests

## Conventions
- Use kebab-case for filenames
- All exports must have JSDoc
EOF

ルール	ポイント	ドメイン
`ccm-project-claudemd`	+10	CC Mastery

良いツール習慣を実践

セッション中、Claudeに以下のパターンを実行させます：

まず検索（GrepまたはGlob）で関連コードを見つける
ファイルを読む変更する前に理解する
精密に編集、リライトではなくターゲットを絞った編集

これによりtool-investigation-chain（+15/回、セッションあたり最大3回 = +45最大）がトリガーされます。

1週目チェックリスト

タスク	ポイントへの影響	アチーブメントの進捗
3セッション完了	フェーズ -> 初期	Getting Started：3/10
構造化されたグローバルCLAUDE.md	+15 CC Mastery	--
プロジェクトCLAUDE.md	+10 CC Mastery	--
マッチャー付きのhooksを設定	+25 CC Mastery	--
1つのプラグインをインストール	+5 CC Mastery	--
セッションでの調査チェーン	+15--45 Tool & MCP	--

1週目後の予想スコア：

CC Mastery：40--65
Tool & MCP：20--40
他のドメイン：5--20

パワーユーザー：中級レベル

目標：全ドメインを50以上に。Well-Roundedアチーブメントをアンロック。

MCPサーバー

MCPサーバーを設定して使用します。最も価値の高いシグナルの1つです。

{
  "mcpServers": {
    "github": { "command": "mcp-github", "args": [] },
    "linear": { "command": "mcp-linear", "args": [] }
  }
}

セッションでMCPツールを使用：

ルール	ポイント	ドメイン
`tool-mcp-configured`	+10	Tool & MCP
`tool-mcp-used`	+15	Tool & MCP
`tool-mcp-multi-server`	+20	Tool & MCP（2+サーバー使用）

サブエージェントの使用

タスクをサブエージェントに委任し始めます：

Use an agent to refactor the authentication module while I work on the API routes.

ルール	ポイント	ドメイン
`agent-used`	+5	Agentic
`agent-detailed-prompt`	+10	Agentic（プロンプト >100文字）
`agent-multi-types`	+15	Agentic（2+のサブエージェントタイプ）
`agent-background`	+10	Agentic（バックグラウンドエージェント）

構造化されたプロンプト

以下の代わりに：

ログインバグを直して

以下のように書きます：

ログインエンドポイントが有効なトークンに対して403を返します。エラーは以下の通りです：
Error: JWT validation failed at src/auth/validate.ts:42
関連ファイルはsrc/auth/validate.tsです。以下をお願いします：

まずファイルを読む

トークン有効期限ロジックを確認

パブリックAPIを変更せずにバリデーションを修正

この1つのプロンプトで複数のルールをトリガーできます：

ルール	ポイント	ドメイン
`prompt-structured-request`	+15	Prompt Craft
`prompt-code-block`	+15	Prompt Craft
`prompt-error-trace`	+15	Prompt Craft
`prompt-file-reference`	+10	Prompt Craft
`prompt-context-first`	+15	Prompt Craft（コード + ファイル + >100文字）

1つのプロンプトで+70 Prompt Craftポイント。

メモリファイル

セッション間でコンテキストが持続するようにメモリファイルを作成：

mkdir -p ~/.claude/projects/-your-project/memory
cat > ~/.claude/projects/-your-project/memory/MEMORY.md << 'EOF'
# Project Memory

## Key Decisions
- Migrated from Express to Fastify (2026-02)
- Using Drizzle ORM for database layer

## Current Sprint
- Implementing OAuth2 flow
EOF

ルール	ポイント	ドメイン
`ctx-memory-exists`	+10	Context Mgmt
`ctx-memory-active`	+15	Context Mgmt（2+のアクティブファイル）
`ctx-memory-diverse`	+15	Context Mgmt（3+のメモリファイル）

パワーユーザーチェックリスト

マイルストーン	やるべきこと
セッションあたり5+のツールタイプ	自然なワークフローでGrep、Glob、Read、Edit、Bashを使用
Planモード	`claude --plan`でセッションを開始して意図的な設計を
3+のスキルを使用	`/commit`、`/review-pr`、`/explain`などのスラッシュコマンドを使用
深いセッション	10+のやり取り（`ctx-session-depth`をトリガー）
反復的改善	Claudeの出力を修正・改善（「実は、XをYに変えて」）
複数プロジェクト	Explorerアチーブメントのため5+のリポジトリで作業

パワーユーザーレベルの予想スコア：

全ドメイン：50--75
アチーブメント：Well-Roundedアンロック（全5ドメインが50+）

エキスパート：上級テクニック

目標：全ドメインを80以上に。Perfect Score（任意のドメインで100）を獲得。

パラレルエージェントディスパッチ

複数のエージェントを同時に作業させます：

I need three things done in parallel:
1. Agent: Write unit tests for the payment module
2. Agent: Refactor the email templates to use the new design system
3. Agent: Update the API documentation for the v2 endpoints

ルール	ポイント	ドメイン
`agent-parallel`	+20	Agentic

Worktree分離

エージェントが競合なく別のブランチで作業できるようworktreeを使用：

Use a worktree to implement the new caching layer on a separate branch.

ルール	ポイント	ドメイン
`agent-worktree`	+15	Agentic

LSP統合

編集前にLanguage Server Protocolツールを使用：

Use LSP to find all references to the `AuthService` class, then read the main implementation, then update the constructor.

ルール	ポイント	ドメイン
`tool-lsp-before-edit`	+15	Tool & MCP

カスタムスキル、エージェント、ルール

プロジェクトレベルの定義を作成：

.claude/
  skills/
    deploy/SKILL.md        # カスタムデプロイスキル
    review/SKILL.md        # カスタムコードレビュースキル
  agents/
    refactor.md            # リファクタリング専門エージェント
    test-writer.md         # テスト生成エージェント
  rules/
    architecture.md        # アーキテクチャ制約
    code-style.md          # スタイルガイド
    error-handling.md       # エラーハンドリングパターン
    naming.md              # 命名規則
    testing.md             # テスト基準
    security.md            # セキュリティルール

ルール	ポイント	ドメイン
`ccm-custom-skills`	+10	CC Mastery
`ccm-custom-agents`	+10	CC Mastery
`ccm-rules-files`	+10	CC Mastery

Rules機能バーは6つのrulesファイルで飽和するため、上記で100%になります。

CLAUDE.mdを更新する

プロジェクトの進化に合わせてセッション中にCLAUDE.mdを更新：

Update the CLAUDE.md to add our new database migration conventions.

ルール	ポイント	ドメイン
`ctx-claudemd-updated`	+20	Context Mgmt

エキスパートチェックリスト

テクニック	トリガーされるルール	ポイント
パラレルエージェント	`agent-parallel`	+20
Worktree分離	`agent-worktree`	+15
エージェント再開	`agent-resume`	+15
編集前LSP	`tool-lsp-before-edit`	+15
3+スラッシュコマンド	`prompt-slash-commands`	+15
CLAUDE.md更新	`ctx-claudemd-updated`	+20
メモリファイル書き込み	`ctx-memory-write`	+15
5+プラグイン	`ccm-plugins-diverse`	+10

エキスパートレベルの予想スコア：

全ドメイン：80--100
アチーブメント：Master Classアンロック（全5が80+）

ドメインウォークスルー

各ドメインの詳細なスコアリング方法については、Scoring-jaページの完全なルール表を参照してください。

アチーブメントアンロックガイド

セッションマイルストーン

アチーブメント	アンロック条件	戦略
First Steps	1セッション	Claude Codeを1回使用するだけ
Getting Started	10セッション	2週間毎日Claude Codeを使用
Century Club	100セッション	3--4ヶ月の持続的な毎日の使用

時間マイルストーン

アチーブメント	アンロック条件	戦略
10 Hour Mark	合計10時間	10日間で約1時間/日
Centurion	合計100時間	3ヶ月以上で約1時間/日

スコアマイルストーン

アチーブメント	アンロック条件	戦略
Perfect Score	任意のドメイン = 100	1つのドメインに集中 -- Prompt Craftが最も簡単な場合が多い
Well-Rounded	全5ドメイン >= 50	パワーユーザーチェックリストに従う
Master Class	全5ドメイン >= 80	エキスパートチェックリストに従う；幅広さが必要

Perfect Scoreへの最速パス： Prompt Craft。コードブロック、エラートレース、ファイル参照、反復的改善、スラッシュコマンドを含む1つの良いセッションでこのドメインを最大化できます。

Well-Roundedへの最速パス： 最も弱いドメインを最初に修正。cc-proficiency analyzeを実行してどれに作業が必要か確認。

ストリークマイルストーン

アチーブメント	アンロック条件	戦略
Week Warrior	7日のストリーク	1週間毎日Claude Codeを使用 -- 短いセッションでもカウント
Monthly Grinder	30日のストリーク	毎日の習慣を構築。週末も含む。

機能マイルストーン

アチーブメント	アンロック条件	戦略
Explorer	5+プロジェクト	異なるリポジトリでClaude Codeを使用
Agent Master	Agents機能スコア > 0	委任タスクにサブエージェントを使用
MCP Explorer	2+MCPサーバー使用	複数のMCP統合を設定・使用
Night Owl	少なくとも1つのアクティブセッション日がある	最初のセッション後に自動的にアンロック

コミュニティ

アチーブメント	アンロック条件	戦略
Community	リーダーボードに参加	`cc-proficiency share`を実行

機能ミニバー：0から100へ

ドメインバーの下に、バッジは8つの機能ミニバーを表示します。深度ベースのスコアリングを使用し、単純なon/offチェックではありません。各機能の進め方を説明します。

各機能バーの詳細な数式と進捗表については、英語版のGamification-Guideを参照してください。主なポイントは：

Hooks：設定（最大30）+ 発火回数とユニークhooksの対数曲線
Plugins：インストール数のキャップ付きレシオ（12でキャップ）
Skills：設定 + 呼び出しとユニークスキルの対数曲線
MCP：設定 + MCP呼び出しとユニークサーバーの対数曲線
Agents：設定 + エージェント呼び出しとユニークタイプの対数曲線
Plan：planモードプロンプトの対数曲線（純粋に行動ベース）
Memory：メモリファイルの存在 + ファイル数 + アクティブメンテナンス
Rules：rulesファイル数のキャップ付きレシオ（6でキャップ）

ストリークシステム

ストリークの仕組み

ストリークとは、少なくとも1つのClaude Codeセッションがある連続した日数です。システムは以下を追跡します：

現在のストリーク -- アクティブな連続日数カウント
最長ストリーク -- 過去最高（減少しない）
最終アクティブ日 -- Claude Codeを最後に使用した日

ストリークはセッション履歴（過去90日間）のユニークなUTC日付から計算されます。

ストリークの維持

シナリオ	効果
今日Claude Codeを使用	現在のストリーク += 1（昨日もアクティブだった場合）
1日スキップ	現在のストリークが0にリセット
1日スキップ後に再開	新しいストリークが1から開始。最長ストリークは変更なし

ヒント：

30秒のセッションでもアクティブ日としてカウント
ストリークはUTC日付を使用 -- タイムゾーンオフセットを把握しておく
最長ストリークは減少しないため、途切れたストリークが記録を消すことはない
ストリークデータはGistに同期され、マシン間で永続化

ストリークアチーブメント

ストリーク長	アチーブメント
7日	Week Warrior
30日	Monthly Grinder

リーダーボード

参加方法

cc-proficiency share

このコマンドは：

共有される内容のプライバシーサマリーを表示
プロフィールの公開Gistを作成（スコア、ストリーク、アチーブメント数）
リーダーボードに登録するためのGitHub Issueを開く
Communityアチーブメントをアンロック

詳細はLeaderboard-jaを参照してください。

深度スコアリング：数学

機能ミニバーは3つの数学曲線を使用します。

対数曲線（logCurve）

score = min(100, k * log(1 + value / scale))

最初の使用が最もポイントを獲得し、その後の使用は少なくなります。ゲーミングの抑止。

キャップ付きレシオ（cappedRatio）

score = min(100, (value / cap) * 100)

キャップまで線形進行、その後フラット。

バイナリ（binary）

score = present ? value : 0

あるかないか。

インストールすることで開始し、実際に使用することでスコアが上がります。

バッジの埋め込み

GitHub READMEに

ghが認証済みの状態でcc-proficiency initを実行後、READMEに追加：

<!-- 静的バッジ -->
![CC Proficiency](https://gist.githubusercontent.com/<username>/<gist-id>/raw/cc-proficiency.svg)

<!-- アニメーションバッジ -->
![CC Proficiency](https://gist.githubusercontent.com/<username>/<gist-id>/raw/cc-proficiency-animated.svg)

ローカルバッジ

Gistを使用しない場合：

cc-proficiency badge --output ./my-badge.svg
cc-proficiency badge --animated --output ./my-badge-animated.svg

アンチゲーミングの透明性

スコアリングエンジンはゲーミングが機能しないように設計されています。セッションあたりのキャップ、バケットキャップ、対数飽和、アンチパターン控除、リーセンシー重み付けにより、スコアを改善する最も効果的な方法は、Claude Codeを上手に使用することです。

クイックリファレンス

フェーズ：       キャリブレーション (0-2) → 初期 (3-9) → 完全 (10+)
ドメイン：       CC Mastery · Tool & MCP · Agentic · Prompt Craft · Context Mgmt
機能：          Hooks · Plugins · Skills · MCP · Agents · Plan · Memory · Rules
アチーブメント：  15個（セッション、時間、スコア、ストリーク、機能、コミュニティ）
キャップ：       設定 25 | 行動 75 | ペナルティ -15（ドメインあたり）

コマンド：
  cc-proficiency init          # hookセットアップ + 初回分析
  cc-proficiency analyze       # インクリメンタル分析
  cc-proficiency analyze --full # フル再分析
  cc-proficiency achievements  # アチーブメント進捗を表示
  cc-proficiency leaderboard   # コミュニティランキングを表示
  cc-proficiency share         # リーダーボードに参加
  cc-proficiency explain       # 現在のスコアを説明
  cc-proficiency push          # バッジをGistに強制プッシュ

cc-proficiency

English

中文

Español

Français

日本語

한국어

Gamification Guide ja

ゲーミフィケーションガイド

目次

プログレッションシステムの仕組み

3つのフェーズ

2種類の証拠

5ドメイン、均等ウェイト

初日

ステップ1：インストールと初期化

ステップ2：CLAUDE.mdを作成する

ステップ3：CLAUDE.mdに構造を追加

ステップ4：プラグインをインストール

ステップ5：最初の実際のセッションを実行

1週目：モメンタムの構築

2-3日目：3セッションを完了

Hooksを設定する

プロジェクトCLAUDE.mdを作成

良いツール習慣を実践

1週目チェックリスト

パワーユーザー：中級レベル

MCPサーバー

サブエージェントの使用

構造化されたプロンプト

メモリファイル

パワーユーザーチェックリスト

エキスパート：上級テクニック

パラレルエージェントディスパッチ

Worktree分離

LSP統合

カスタムスキル、エージェント、ルール

CLAUDE.mdを更新する

エキスパートチェックリスト

ドメインウォークスルー

アチーブメントアンロックガイド

セッションマイルストーン

時間マイルストーン

スコアマイルストーン

ストリークマイルストーン

機能マイルストーン

コミュニティ

機能ミニバー：0から100へ

ストリークシステム

ストリークの仕組み

ストリークの維持

ストリークアチーブメント

リーダーボード

参加方法

深度スコアリング：数学

対数曲線（logCurve）

キャップ付きレシオ（cappedRatio）

バイナリ（binary）

バッジの埋め込み

GitHub READMEに

ローカルバッジ

アンチゲーミングの透明性

クイックリファレンス

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!