ポートフォリオ戦略
基本原則
あなたの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つのプロジェクトを選び、毎日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 | キャリアライフサイクル全体(就職活動、面接、オンボーディング、業績評価)をカバーするとき |