Claude Codeを使っているのに、なぜか生産性が上がりきらない。そう感じる理由の多くは、使い方ではなく「使い倒し方」を知らないことにあります。

GitHubで50,000スターを超えたリポジトリ「claude-code-best-practice」は、Claude Code作者のBoris Cherny氏やAnthropicエンジニアのThariq氏、そして多くのコミュニティメンバーが実践で得たノウハウを83のtipsにまとめたオープンソースの知識集です。

この記事でわかること:

  • claude-code-best-practiceが何を収録しているか
  • Boris Cherny氏の直伝tipsから特に重要なもの
  • 主要な開発ワークフロー（Superpowers、Everything Claude Code など）の比較
  • スキルコレクションの全体像と使い方

https://github.com/shanraisshan/claude-code-best-practice

このリポジトリとは何か

claude-code-best-practiceは、パキスタンの開発者Shan Raisshan氏が2025年末から管理しているオープンソースのドキュメント集です。「vibe codingからagentic engineeringへ」をサブタイトルに掲げ、Claude Codeを使いこなすための概念説明・tips・ワークフロー・スキル集を一か所にまとめています。

2026年5月時点でGitHubスター数は50,000を超えており、GitHub Trending（当日1位）を記録しています。単なるtips集ではなく、Subagents・Commands・Skills・Hooks・MCP Servers・Settingsといった主要機能ごとにベストプラクティスと実装例を並べた構成が特徴です。

コアコンセプトの整理

リポジトリの冒頭には、Claude Codeの主要機能が一覧で整理されています。機能・配置場所・ドキュメントリンクの3列構成で、初心者が全体像を把握するのに役立ちます。

  • Subagents: .claude/agents/<name>.md に定義し、専門的なタスクを委任する
  • Commands: .claude/commands/<name>.md に定義し、毎日繰り返す作業をスラッシュコマンド化する
  • Skills: .claude/skills/<name>/SKILL.md でオンデマンドに専門知識を注入する
  • Hooks: PreToolUse・PostToolUse で自動フォーマットや権限制御を行う
  • MCP Servers: .claude/settings.json または .mcp.json で外部ツールと接続する

2026年春以降に追加されたUltrareview・Ultraplan・Auto Mode・Voice Dictationといったベータ機能も一覧に収録されており、新機能の把握にも使えます。

Boris Cherny氏の直伝tips

リポジトリで最も引用が多いのが、Claude Code作者のBoris Cherny氏（@bcherny）のtipsです。83のtipsのうち、多くがCherny氏のXポストや動画インタビューを一次ソースとしています。

プロンプティングと修正

平凡な修正結果が返ってきたとき、「knowing everything you know now, scrap this and implement the elegant solution」と伝えると、Claude Codeが一から正しいアプローチで実装し直します。同様に「grill me on these changes and don’t make a PR until I pass your test」と指示して変更内容を批判的に評価させる手法も紹介されています。バグ修正については「fix」の一言だけ渡し、修正方法を細かく指定しないことを勧めています。

プランニング

すべてのタスクをPlanモードで始めることが最優先として挙げられています。もう一つ注目度が高いのが、PRDを水平分割（DBフェーズ→APIフェーズ→フロントエンドフェーズ）ではなく垂直スライス（1機能がDB+API+UIを貫通する単位）で切る方法です。「水平分割はAIのデフォルト動作であり、フィードバックループが遅くなる」と説明されています。

スペックを書くより先にプロトタイプを20〜30本作ることも推奨されています。「コストが安いから試行回数を増やせばいい」という考え方で、仕様書の精度より実験の数を優先しています。

コンテキスト管理

Thariq氏（Anthropic）のtipsと合わせて、コンテキスト管理が集中的に扱われています。1Mコンテキストのモデルでも300〜400kトークン付近で「context rot」が始まり、精度が落ちることが経験則として示されています。初心者は40%以下、熟練者は30%以下を目安に/compactまたは/clearでリセットするよう勧めています。

失敗した修正を残したまま「これで直してください」と次の指示を出すのではなく、double-Escまたは/rewindで失敗前に巻き戻して再プロンプトする手法（「rewind > correct」）も重要なtipsとして収録されています。

サブエージェントの活用

コンテキストを汚さずに問題に多くの計算を投入したいとき、「use subagents」と一言入力するだけでサブエージェントに処理を委任できます。1つのエージェントがバグを埋め込み、別の同じモデルのエージェントがそれを見つける「test time compute」のパターンも紹介されています。

コマンドとスキル

1日に複数回繰り返す作業はすべてスラッシュコマンドにする、が基本方針です。/techdebt・/context-dump・/analyticsなど、プロジェクト固有のコマンドを.claude/commands/に置いてgit管理します。スキルのdescriptionフィールドは「いつ発火するか」をモデルに伝えるトリガーとして書き、不要な説明を省くことが推奨されています。

Git / PRの扱い方

PRは小さく保つことが強調されています。Cherny氏の事例では141PRで45,000行を1日で変更しており、中央値は118行程度です。スクワッシュマージで履歴を線形に保ち、1機能＝1コミットにすることでgit revertとgit bisectを使いやすくしています。

開発ワークフロー比較

リポジトリの中で特に参照価値が高いのが、コミュニティが公開している開発ワークフロー集です。「Research → Plan → Execute → Review → Ship」の流れに収束する複数のアプローチが比較されています。

ワークフロー スター数 特徴
Superpowers 175k git worktrees + subagent駆動のTDDを軸にした多段階フロー
Everything Claude Code 171k 48エージェント・143コマンド・230スキルを持つ大規模構成
Spec Kit 92k GitHub公式。仕様→明確化→実装を9コマンドで構造化
gstack 88k CEO/Eng/Designレビューを段階的に組み込んだチーム向けフロー
Get Shit Done 59k フェーズ分割で進捗を可視化するシンプルな実装フロー

どのワークフローも「計画 → 実行 → 検証」の構造は共通しており、チームの規模やプロジェクトの複雑さに応じて選べるよう整理されています。

スキルコレクションの全体像

83のtipsとは別に、コミュニティのスキルコレクションも一覧化されています。

  • anthropics/skills: 公式。127,000スター・17スキル
  • mattpocock/skills: 51,000スター・18スキル（TypeScript特化）
  • wshobson/agents: 35,000スター・152スキル
  • agent-skills（Addy Osmani）: 27,000スター・21スキル
  • awesome-agent-skills: 20,000スター・930種以上のキュレーション集

公式の17スキルから始めて、用途に合わせてコミュニティのコレクションを追加する使い方が現実的です。

使い方

リポジトリはドキュメント集なので、インストールの手順は特にありません。GitHubでスターをつけてブラウザブックマークに加えておき、困ったタイミングで参照する使い方が基本です。

ただし、リポジトリには実際のCLAUDE.mdや.claude/settings.jsonの実装例も含まれており、そのままコピーして使えるファイルが多数あります。特にボイラープレートとして活用しやすいのは、CLAUDE.mdのテンプレートと、オーケストレーションワークフローのコマンド例です。

git clone https://github.com/shanraisshan/claude-code-best-practice

クローンして手元に置き、.claude/以下のファイルを自分のプロジェクトに合わせて改変するのが実践的な活用方法です。

類似リソースとの違い

Anthropicが公式に公開している「Claude Code Best Practices」ドキュメント（anthropic.com/engineering/claude-code-best-practices）は、Anthropic視点での設計思想と推奨パターンをまとめたものです。一方、claude-code-best-practiceはBoris Cherny氏の実際の使用スタイル・コミュニティの実験結果・複数ワークフローの比較という「現場の知見」に重きを置いています。

公式ドキュメントが「何ができるか」を説明するなら、このリポジトリは「どうすれば実際にうまく動くか」を教えてくれます。両方を参照することで、Claude Codeの理解が大きく深まります。