ポートフォリオ戦略
核となる原則
あなたのGitHubは、中途半端なプロジェクトの墓場ではありません。厳選された展示会です。ピン留めされた各リポジトリは、採用担当者があなたについて抱くであろう一つの質問に答え、その答えがすべて面接を予約したいと思わせるものでなければなりません。
印象的なものと平凡なものを分けるもの
平凡なポートフォリオ 印象的なポートフォリオ
───────────────── ────────────────────
30個のリポジトリ、ほとんどがフォーク 5個のリポジトリ、すべてオリジナル作品
READMEなし 各READMEがストーリーを語る
ライブデモなし すべてのプロジェクトがデプロイされている
ランダムなチュートリアルのクローン 明確なテーマと進歩
最終コミット: 8ヶ月前 一貫性のある最近の活動
リポジトリに説明文なし すべてのリポジトリに一言説明あり
「my-first-react-app」 「AI搭載コードレビューツール」
違いは才能ではありません。厳選です。最高のポートフォリオは、計画を持った人のように見えます。触れたものを何でもコミットする人のように見えません。
量より質
3〜5の洗練されたプロジェクトは、30の放棄されたリポジトリに勝ります。毎回。
重要な計算
| リポジトリ数 | README数 | デプロイ数 | 採用担当者の印象 |
|---|---|---|---|
| 30 | 2 | 0 | 「物事を始めるが、完成させない」 |
| 15 | 5 | 1 | 「手を出すが、何が得意か不明」 |
| 5 | 5 | 4 | 「集中している。リリースする。技術を熟知している」 |
| 3 | 3 | 3 | 「触れるものすべてが洗練されている」 |
クリーンアップルール
何か新しいものを追加する前に、すでにあるものを監査します。
1. 未完成で修復不可能なものはアーカイブまたは非公開にする。
2. 変更を加えていないフォークリポジトリは削除する。
3. 公開しておくものすべてにREADMEを追加する。
4. 表示されているすべてのリポジトリに説明文を設定する。
5. 残ったものは公開に値するものでなければならない。
履歴書に載せないのであれば、公開GitHubに載せるべきではありません。
リポジトリ全体でストーリーを語る
ピン留めされたリポジトリは、ランダムなサンプルではありません。それらは章です。訪問者がナラティブを見ることができるように配置します。
効果的なストーリー構造
スペシャリストアーク:
「私はAI/MLを深く掘り下げ、それを証明できます。」
リポジトリ1: 特定ドメインタスク向けにファインチューニングされたLLM
リポジトリ2: 評価フレームワークを備えたRAGパイプライン
リポジトリ3: ツール使用を伴うエージェンティックワークフロー
リポジトリ4: LangChain/LlamaIndexへのオープンソースコントリビューション
フルスタックビルダーアーク:
「データベースからデプロイまで、完全な製品を構築します。」
リポジトリ1: フルスタックSaaSアプリ (Next.js + API + DB + Auth)
リポジトリ2: AI搭載CLIツール (バックエンド/システムの力量を示す)
リポジトリ3: オープンソースライブラリ (API設計の思考を示す)
リポジトリ4: 個人用自動化ツール (自分のために構築していることを示す)
AIネイティブデベロッパーアーク:
「AIを使うだけでなく、AIを使って構築し、AIのために構築します。」
リポジトリ1: エージェンティックワークフロー / マルチエージェントシステム
リポジトリ2: プロダクショングレードアプリへのLLM統合
リポジトリ3: AIを活用した開発者ツール (リンター、レビューア、ジェネレーター)
リポジトリ4: AIフレームワークまたはツールチェーンへのコントリビューション
進歩を示すシグナル
採用担当者は、リポジトリが成長を示していることに気づきます。
| シグナル | 示すもの |
|---|---|
| 初期のリポジトリ: シンプルなCRUDアプリ | どこかから始めた |
| 中盤のリポジトリ: テストとCIを備えたAPI | エンジニアリングプラクティスを学んだ |
| 最近のリポジトリ: 評価を備えたAIエージェント | フロンティアで構築している |
| 主要なOSSプロジェクトへのコントリビューション | 大規模なコードベースで作業できる |
何をピン留めし、なぜか
ピン留めできるリポジトリは6つです。戦略的に使いましょう。
理想的なピン留めレイアウト
| スロット | ピン留めするもの | 理由 |
|---|---|---|
| 1 | フルスタックプロジェクト | 完全な製品を構築できることを証明する |
| 2 | AI/MLプロジェクト | フロンティアで作業していることを示す |
| 3 | オープンソースコントリビューション | 実際のコードベースで協力できることを証明する |
| 4 | 開発者ツールまたはCLI | 自分の問題を解決していることを示す |
| 5 | ドメインプロジェクト (専門分野) | ターゲットの役割に対する深さのシグナル |
| 6 | ワイルドカード — 個人またはクリエイティブなもの | 個性と純粋な好奇心を示す |
ピン留めルール
ピン留めすべきもの:
- ライブデモまたはデプロイリンクがあるプロジェクト
- 徹底したREADMEとスクリーンショットがあるリポジトリ
- 応募している役割に一致する作業
- 最も最近の、最も洗練された作業
ピン留めすべきでないもの:
- 意味のある変更を加えていないフォークリポジトリ
- チュートリアルのフォローアロング (完了しても)
- READMEがないリポジトリ
- 面接で説明できないもの
ポートフォリオのピッチとしてのREADME
ピン留めされた各リポジトリには、30秒でプロジェクトを売り込むREADMEが必要です。採用担当者は、読み続けるかどうかを決める前にそれ以下の時間しか費やしません。
ポートフォリオリポジトリのREADME構造
# プロジェクト名
何をするのか、なぜ重要なのかを一文で説明。
## デモ
[ライブデモへのリンク] | [ビデオウォークスルーへのリンク]
アプリの動作を示すスクリーンショットまたはGIF。
## 問題
これはどのような問題を解決しますか?誰がこの問題を抱えていますか?
## 仕組み
アーキテクチャの概要。主要な技術的決定。
システムに複数のコンポーネントがある場合は図。
## 技術スタック
テクノロジーのリスト — ただし意味のあるものだけ。
HTML/CSSはリストしないでください。AI統合、データベース、デプロイターゲットはリストしてください。
## 主な機能
- 機能1 — 技術的に興味深い理由
- 機能2 — 構築する上で何が難しかったか
- 機能3 — 次に何を改善するか
## はじめに
明確なセットアップ手順。誰かが5分以内にこれを実行できるように。
## 学んだこと
最も困難な技術的課題と、それをどのように解決したかについての簡単な振り返り。
READMEのアンチパターン
| 悪いREADME | より良いREADME |
|---|---|
| 「Reactアプリ」 | 「AIを搭載した会議要約ツール。録音をアクションアイテムに変換します」 |
| スクリーンショットなし | ファーストビューにヒーロースクリーンショットまたはGIF |
| セットアップ: 「clone and run」 | セットアップ: 前提条件を記載したステップバイステップ |
| アーキテクチャの説明なし | コンポーネントの接続方法を示すシステム図 |
| すべてのnpmパッケージをリスト | 重要な3〜4のテクノロジーに焦点を当てる |
ライブデモとデプロイリンク
コードは仮説です。デプロイされたアプリは証拠です。
デプロイが重要な理由
採用担当者がデモのないリポジトリを見る:
「面白いコードだ… 実際に動くのか?」
採用担当者がライブリンクのあるリポジトリを見る:
「試してみよう。」 → 2分後 → 「この人はリリースできる。」
プロジェクトタイプ別のデプロイオプション
| プロジェクトタイプ | 無料デプロイ先 | 適している用途 |
|---|---|---|
| フルスタックWebアプリ | Vercel, Railway, Fly.io | プロダクション感のあるアプリ |
| API / バックエンド | Railway, Render | バックエンドスキルの披露 |
| 静的サイト / ドキュメント | GitHub Pages, Netlify | ドキュメント、ランディングページ |
| AI/MLデモ | Hugging Face Spaces, Streamlit Cloud | モデルデモ、データアプリ |
| CLIツール | npm publish, Homebrew tap | 配布シグナル |
デプロイできない場合は、デモを録画する
すべてをクラウドで実行できるとは限りません。ローカル専用ツール、CLIアプリ、または複雑なシステムの場合:
1. 60〜90秒のビデオウォークスルーを録画する。
2. YouTubeにアップロードする (公開設定は「限定公開」で問題ない)。
3. 主要なインタラクションのGIFを作成する。
4. 両方をREADMEに配置する。
ビデオデモは、デモがないより10倍優れています。
コントリビューショングラフ
一貫性が示すもの
採用担当者はあなたのコントリビューショングラフに目をやります。彼らが実際にそこから読み取るものは次のとおりです。
| パターン | 解釈 |
|---|---|
| ほとんどの日が安定した緑 | 「この人は定期的にコードを書いている。良い習慣だ。」 |
| プロジェクトを中心に集まっている | 「集中したスプリントで作業している。普通だ。」 |
| 平日のみ緑 | 「仕事があり、それでも個人作業をリリースしている。」 |
| 自分のリポジトリとコントリビューションの混合 | 「協力的だ。個人プロジェクトだけではない。」 |
操作の見分け方
経験豊富なレビュー担当者は、これらを即座に見抜くことができます。
危険信号:
- 完全に均一な緑 (毎日、同じ強度)
- READMEの編集や空白の変更のみのコミット
- 空のリポジトリへの1日500コミット
- 1週間で作成された数十のリポジトリ、すべて単一コミット
- 自動生成されたコミットボット
グラフを操作することは、ギャップがあることよりも悪いです。それは必死さと判断力の欠如を示します。本当の一貫性とは、ギャップがあっても、自分が気にかけていることに定期的なリズムで取り組むことです。
本当のグラフを構築する
偽装する代わりに:
1. 1つのプロジェクトを選び、1日30分取り組む。
2. オープンソースにコントリビュートする — ドキュメント、テスト、バグ報告でも構わない。
3. メモや実験をコミットする学習リポジトリを維持する。
4. 実際に使うツールを構築する。自然に改善し続けることになる。
ポートフォリオを希望する役割に合わせる
あなたのポートフォリオは、採用された場合に行う仕事のプレビューのように見えるべきです。ターゲットに合わせて調整します。
AIネイティブ開発の役割
これらの役割は、AIを使って構築し、AIのために構築できることを示すことを求めています。
| シグナル | 例となるリポジトリ |
|---|---|
| ワークフローでのAIツールの使用 | .claude/ 設定、AI支援コミット、Claude Codeスラッシュコマンドを含むプロジェクト |
| エージェンティックワークフロー | 調査、計画、タスク実行を行うマルチステップエージェント |
| LLM統合 | 構造化出力、プロンプトエンジニアリング、モデルルーティングを備えたアプリ |
| RAGと検索 | 埋め込み検索と評価指標を備えた知識ベース |
| 評価とテスト | LLM出力評価フレームワーク、プロンプト回帰テスト |
| AI支援開発 | AIツールがどのように開発を加速したかを文書化したプロジェクトREADME |
役割別ポートフォリオターゲット
| ターゲット役割 | 必須リポジトリ | あると良いもの |
|---|---|---|
| AI/MLエンジニア | ファインチューニングモデル、評価フレームワーク、データパイプライン | 論文実装、モデル比較 |
| フルスタックAI開発者 | LLM統合アプリ、RAGシステム、デプロイされたSaaS | オープンソースコントリビューション、CLIツール |
| プラットフォーム/インフラエンジニア | CI/CDパイプライン、IaCリポジトリ、監視設定 | パフォーマンスベンチマーク、OSSコントリビューション |
| 開発者ツール/DX | CLIツール、SDK/ライブラリ、VS Code拡張機能 | ドキュメントサイト、開発者コミュニティツール |
ポートフォリオレビューチェックリスト
就職活動のたびにこの監査を実行します。正直に。
第一印象 (30秒)
- プロフィール写真はプロフェッショナル (または意図的に特徴的)
- 自己紹介文に自分の活動と探しているものが記載されている
- ピン留めされたリポジトリに、第三者にも意味がわかる説明がある
- 少なくとも3つのピン留めリポジトリのREADMEにスクリーンショットまたはデモリンクがある
- 最初のページに恥ずかしいリポジトリ名が見えない
深さチェック (2分)
- ピン留めされた各リポジトリに、何を、なぜ、どのようにを説明するREADMEがある
- 少なくとも1つのプロジェクトにライブデモまたはデプロイリンクがある
- ピン留めされたリポジトリのコード品質が現在のスキルレベルを反映している
- コミット履歴が実際の開発を示している (単一の「initial commit」ブロブではない)
- 少なくとも1つのリポジトリがテストまたはCI/CDを示している
ストーリーチェック (5分)
- ピン留めされたリポジトリが、あなたのスキルについて一貫したストーリーを語っている
- 古いプロジェクトから新しいプロジェクトへの目に見える進歩がある
- ポートフォリオがターゲットとする役割に合致している
- ピン留めされた各リポジトリを60秒のエレベーターピッチで説明できる
- このGitHubを見て、自分自身を採用したいと思う
究極のテスト
シークレットウィンドウで自分のGitHubを開きます。あなたに会ったことのない採用担当者になったつもりで、60秒間費やします。この候補者を次のラウンドに進めますか?
答えが即座に「はい」でない場合は、繰り返し改善を続けてください。
アンチパターン
| アンチパターン | なぜ有害か | 修正方法 |
|---|---|---|
| 変更のないフォークリポジトリ | 水増しのように見える | 削除するか非公開にする |
| チュートリアルのクローン (「todo-app」、「weather-app」) | 構築できることではなく、指示に従ったことを示す | フォークして、チュートリアルをはるかに超えて拡張する |
| 空のリポジトリまたはREADMEのみのリポジトリ | 放棄されたアイデアを示す | アーカイブまたは削除する |
| 公開リポジトリにREADMEがない | 「自分の仕事についてコミュニケーションしない」 | 公開しておくすべてのものにREADMEを追加する |
| 厳選されていない50以上の表示リポジトリ | 圧倒的なノイズ、シグナルなし | 積極的にアーカイブし、戦略的にピン留めする |
| 古いピン留めリポジトリ (2年以上前) | 「最近何も構築していない」 | 最近の作業を示すためにピンをローテーションする |
| 自動生成された統計情報のみのプロフィールREADME | 非人間的、努力不足 | 焦点と目標を書いた本当の自己紹介文を書く |
| 「test」、「temp」、「asdf」という名前のリポジトリ | 不注意 | 名前を変更するか削除する |
パワームーブ
「[あなたのGitHub URL] で私のGitHubポートフォリオをレビューしてください。AIネイティブ開発の役割の採用担当者として評価してください。ピン留めされた各リポジトリを、READMEの品質、技術的な深さ、デプロイ状況、AI/MLの役割への関連性で採点してください。その後、優先順位付けされたアクションプランを教えてください。何をアーカイブすべきか、何を改善すべきか、何が欠けているか、そして最大の違いを生む新しいプロジェクトはどれか。」
エージェントはあなたのポートフォリオ批評家となり、GitHubをコードの墓場からキャリア資産に変えるために必要な、正直で具体的なフィードバックを提供します。
関連スキル
| スキル | 使用するタイミング |
|---|---|
github-profile | GitHubプラットフォームの仕組みを実装する — プロフィールREADME、リポジトリのピン留め、トピック、アクティビティグラフ |
career-resume | キャリアライフサイクル全体 — 就職活動、面接、オンボーディング、パフォーマンスレビュー |