プログラマーの履歴書にポートフォリオを載せるときは、応募先が指定する欄に作品紹介ページのURLを記載し、何を作ったかを短く添えると見てほしい内容が伝わります。指定欄がなければURL欄や自己PR欄の末尾など、制作経験の説明と一緒に読める場所を使いましょう。
大切なのは、リンクを開いた後に「どんな作品か」「自分が何を担当したか」を確認できることです。この記事では、作品URLの選び方、説明文の記入例、動作デモやPDFで提出する場合の案内方法をまとめます。
履歴書には短い紹介、ポートフォリオには作品の詳細を載せる
履歴書に作品の全機能や画面を詰め込む必要はありません。履歴書には制作経験の要点と案内先を示し、ポートフォリオでは制作目的・画面・使用技術・担当範囲を詳しく説明する、と役割を分けます。

| 載せる場所 | 伝える内容 |
|---|---|
| 履歴書 | 作品名、何をするアプリか、主な使用技術や自分の担当、作品紹介への案内。 |
| 作品紹介ページ・PDF | 制作目的、主な機能、画面、使用技術、制作期間、担当範囲、工夫した点。 |
| 動作デモ・ソースコード | 実際の操作や実装を確認するための資料。必要に応じて作品紹介から案内する。 |
ポートフォリオURLは履歴書のどこに書く?
応募フォームに「ポートフォリオ」「制作実績」の欄があるなら、そこに記載します。履歴書にWebサイト・URL欄がある場合も、その欄を使えます。専用欄がなければ自己PR欄や自由記述欄で制作経験を紹介し、末尾にURLを添える方法があります。
例えば「ポートフォリオ:[自分の作品紹介URL]」とラベルを付ければリンク先の役割が分かります。本人希望記入欄は勤務条件などを伝えるために残し、制作内容とURLを近くに置ける欄から検討すると整理しやすいでしょう。
履歴書の様式が必要な場合はハローワークの応募書類の案内で確認できます。
履歴書に載せるポートフォリオの説明文・記入例
説明文は「何のために、何を作ったか→使用技術・自分の担当→詳しく確認できる場所」の順で整理します。記入欄が狭ければ概要を優先し、詳しい機能や技術構成はリンク先へ移します。以下は架空の例なので、制作内容やURLはご自身の事実に置き換えてください。
個人制作:制作目的と主な機能を短く紹介する
買い物時の買い忘れを減らすため、食材の在庫管理アプリをReact/TypeScriptで個人制作しました。在庫の登録・検索と期限順の並べ替えを実装し、画面と操作例を作品紹介ページにまとめています。
ポートフォリオ:[自分の作品紹介URL]
単に「Reactを使用」と書くより、作ったものと実装した機能が分かる形です。「買い忘れを減らすため」は制作目的の説明であり、効果を測定していないのに「買い忘れを半減した」などの実績を付け足す必要はありません。
作品で使った言語を履歴書のスキル欄にも書く場合は、実務と個人制作の区別、使用期間、できることの伝え方を次の記事で確認してください。

職業訓練などのチーム制作:自分の担当を区別する
職業訓練のチーム課題で、Java/Spring Bootを使った備品予約アプリを制作しました。私は予約一覧画面と、予約期間が重複した場合の入力チェックを担当しました。作品紹介に担当画面と役割分担を掲載しています。
ポートフォリオ:[自分の作品紹介URL]
「チームで完成させた機能」と「自分で担当した部分」を分けます。共通テンプレートや教材を使った場合も、利用した部分と追加・変更した部分を説明しましょう。共同制作者や訓練校の公開ルールも確認してください。
自分の担当が一部分だけの場合や二人で同じ機能を作った場合は、チーム開発の担当範囲を伝える自己PR・制作経験の記入例で、短い紹介文と詳しい説明の書き分けを確認できます。
受講歴も記載する場合は職業訓練の受講中・修了後の記入例を確認してください。
PDFを別添する場合:資料名と掲載内容を示す
個人制作した在庫管理アプリの画面、使用技術、実装した機能を、別添の「ポートフォリオ_氏名.pdf」にまとめています。
参考資料:ポートフォリオ_氏名.pdf
応募先が追加資料を受け付けている場合は、指定の欄・形式・容量に従って提出します。履歴書の資料名と添付ファイル名をそろえ、PDFの先頭には氏名・作品名・制作期間を記載すると、書類を別々に開いたときも誰の作品か分かります。
在庫管理アプリなら、PDFを「制作目的 → 在庫一覧などの画面と操作説明 → 使用技術・担当機能 → 工夫した点と制約」の順にまとめられます。画面ごとに「何を操作するとどう変わるか」を添えると、アプリを起動できない場面でも内容が伝わります。
作品紹介・動作デモ・GitHubのどのURLを載せる?
応募先からリンク先の指定がない場合は、まず作品の概要と自分の担当が分かる紹介ページへ案内すると、いきなりログイン画面やコードだけを見せるより説明を付けやすくなります。紹介ページから、必要なデモやコードに進めるようにしましょう。
| URLの種類 | 役割と案内の例 |
|---|---|
| 作品紹介ページ | 「ポートフォリオ(作品概要・担当範囲)」と明記。複数作品がある場合は、応募職種に関係する作品を見つけやすくする。 |
| 動作するアプリ | 「動作デモ」と明記。必要な操作手順や閲覧方法を作品紹介に記載する。 |
| GitHubのリポジトリ | 「ソースコード」と明記。READMEから機能・実行方法・担当範囲を確認できるようにする。 |
GitHubでも、READMEに作品の説明や画面をまとめれば、作品紹介の役割を持たせられます。ポートフォリオ用の独立したサイトを必ず作る必要はありません。GitHub公式の就職活動向けガイドも、READMEで主な機能・実行方法・デモなどを案内する例を示しています。
GitHubのプロフィールとリポジトリの使い分けや記載欄は次の記事で詳しく説明しています。

リンク先には「自分が説明できる情報」をそろえる
作品紹介ページを開いたときに、次の点を確認できるようにします。作品数を増やすことより、紹介した作品を具体的に説明できることを優先しましょう。
- 制作目的:誰のどんな困り事を想定したか。
- 主な機能:何ができるか。画面や短い操作例で示す。
- 使用技術:言語・フレームワークなど、実際に使ったもの。
- 担当範囲:個人制作かチーム制作か、自分が担当した工程・機能。
- 工夫と制約:なぜその実装を選んだか、未実装の機能や利用上の制約。
「開発しました」だけで終わらず、「予約の重複を防ぐために、登録時に期間を確認する処理を入れた」など、判断と実装を一つ結び付けると説明が具体的になります。学習用の作品は学習用と明記し、実務で納品した成果物のように見せないようにしましょう。
ログインが必要・アプリを公開できない場合の案内方法
ログインが必要な作品は、閲覧手順を案内する
URLを開いてログイン画面だけが出ると、何を試せばよいか分かりません。応募用に用意したデモ環境の使い方や、確認してほしい操作を作品紹介ページに記載します。デモ用アカウントを使うなら、架空のデータだけを扱い、管理者権限を与えないなど、公開範囲に合わせて設計してください。
普段使いのアカウントや業務システムのID・パスワードを履歴書に書いて渡す方法は避けます。閲覧制限を設ける場合は、応募先が利用できる共有方法かを確認してください。
ログイン後の機能を見せたい場合でも、必ずゲストログイン機能を実装する必要はありません。ログイン不要の公開画面、デモ専用のテストアカウント、ゲストログインから作品に合う方法を選びます。テスト用の架空データを用意し、最初に試してほしい操作と制限を一緒に案内すると確認の手間を減らせます。
例えば学習記録アプリなら「サンプルを開く→記録を編集する→一覧で結果を見る」という順番を示します。登録や編集ができるデモでは、他の閲覧者の試用データを消せないか、管理者権限や本番環境につながっていないかも点検してください。

動作デモが出せない場合は、画面・動画・説明資料を検討する
アプリを常時公開できない場合は、画面キャプチャー、操作動画、PDFなどで機能や担当範囲を説明する方法があります。ただし、応募先が動作確認できるアプリを指定している場合に、画像だけで代替できるとは限りません。
業務で作った成果物は、会社や顧客の許可なく掲載しないでください。パスワードを付けたり、社名だけを消したりしても、公開・共有の許可を得たことにはなりません。見せられる実績がない場合は、開示できる範囲の業務説明を職務経歴書にまとめます。
提出用のPDFを書き出したら、ファイルを開き直して文字・画面・リンクを確認します。Webの作品紹介はログインしていない環境からも開き、説明した作品へ到達できるかを確かめましょう。
提出前には、応募フォームの指定形式・容量と添付ファイル名を確認し、紙やPDFにはQRコードだけでなくURLの文字表記も残します。作品紹介からGitHubとデモへ進めるか、サンプルがないため空画面にならないかを確認しましょう。応募後にURLや公開期限を変える予定がある場合は、選考中の閲覧方法と代替資料を応募先へ確認してください。
履歴書には、作品の要点と「どこを見れば確認できるか」を残しましょう。ポートフォリオを用意できない場合は、提出が必須か任意かを応募先の案内で確認し、必要なら代替資料を相談します。
職歴・資格・志望動機など、履歴書全体の書き方は次の記事で確認できます。



