プロジェクトファイルの命名
部門横断の明確さとバージョン管理のために、プロジェクトファイルは ProjectCode_DocType_YYYY-MM-DD_v#.pdf 形式で命名します。
- 先頭にプロジェクトコードまたは識別子を置くことで、すべてのプロジェクトファイルがアルファベット順でまとまります。
- 文書タイプ(spec、design、proposal、review)を含めると、フォルダをたどらなくても目視で検索できます。
- 末尾に日付とバージョンを付けると、チームメンバー間で時系列順の並び替えと変更追跡ができます。
先月、このパターンを使って 89 のプロダクトチームとエンジニアリングチームで 12.4k 件のプロジェクト文書が整理されました。
推奨パターン
標準的なプロジェクトファイルのパターン
グループ化しやすいように先頭にプロジェクトコードを置きます。目視で識別しやすいように文書タイプと日付を含めます。
ProjectCode_DocType_YYYY-MM-DD.pdfPROJ-42_Spec_2025-10-15.pdfバージョン付きプロジェクトファイル
レビューを通じて更新される design や spec のような反復的な文書には、バージョン番号を追加します。
ProjectCode_DocType_YYYY-MM-DD_v#.pdfPROJ-42_Design_2025-10-15_v2.pdf作成者付きプロジェクトファイル
複数の関係者が関わる文書では、所有者や責任範囲を追跡できるように作成者を含めます。
ProjectCode_DocType_Author_YYYY-MM-DD.pdfPROJ-42_Proposal_JSmith_2025-10-15.pdf基本原則
先頭にプロジェクトコードを置く
プロジェクト識別子によって、関連するすべてのファイルがアルファベット順でまとまります。フォルダの散在を防ぎ、プロジェクト横断の検索をしやすくします。
一貫した文書タイプの略称を使う
Spec、Design、Proposal、Review、Meeting、Roadmap などに標準化すると、チームが一貫して検索・保存できます。
時間的な文脈のために日付を含める
YYYY-MM-DD 形式により、文書の古さと更新頻度が分かります。ロードマップや四半期レビューでは重要です。
反復の追跡にはバージョン番号を使う
バージョン番号により、レビューサイクルを通じた変化を追跡できます。spec や design には使い、meeting notes には使いません。
ファイル名にステータスを埋め込まない
spec_DRAFT_PENDING_REVIEW.pdf は、ワークフローが適切でないことを示します。ステータス管理にはプロジェクト管理ツールを使います。
個人を示す代名詞は使わない
My_Proposal.pdf や Team_Document.pdf は、所有権の混乱を生みます。代わりにプロジェクトコードと作成者名を使います。
よくあるミス
プロジェクトコードを省略する
ファイルがフォルダ間に散らばります。手動で検索しない限り、1 つのプロジェクトの全文書を見つけることはできません。
修正: 必ず先頭にプロジェクトコードを置きます: PROJ-42_Spec_2025-10-15.pdf
ファイル名に「Final」や「Latest」を使う
Design_Final_v3_REALLY_FINAL.pdf は、バージョン管理が適切でないことを示します。どのバージョンも自分が最終版だと思っています。
修正: 日付とバージョンを使います: PROJ-42_Design_2025-10-15_v3.pdf
「Document.pdf」や「Notes.pdf」のような汎用名を使う
文脈がまったくありません。共有フォルダやダウンロード内でファイルが上書きされます。
修正: プロジェクト、タイプ、日付を含めます: PROJ-42_MeetingNotes_2025-10-15.pdf
プロジェクトコードの形式が一貫していない
PROJ-42、P42、Project-42 は検索とグループ化を妨げます。チームは関連ファイルを見つけられません。
修正: 会社全体で単一形式を採用します: PROJ-NNNN
ファイル名にスペースを残す
スペースはコマンドラインツールや一部のコラボレーションプラットフォームで問題になります。URL では %20 が作られます。
修正: アンダースコアまたはハイフンを使います: PROJ-42_Spec_2025-10-15.pdf
よくある質問
ファイル名にステークホルダー名を含めるべきですか?
任意です。文書が特定のステークホルダー向けであれば、プロジェクトコードの後にステークホルダー名または部門名を追加します: PROJ-42_Eng_Spec_2025-10-15.pdf.
会議メモやアジェンダはどう扱えばよいですか?
MeetingNotes または Agenda を文書タイプとして使い、日付を付けます: PROJ-42_MeetingNotes_2025-10-15.pdf. 会議資料にはバージョン番号は付けません。
添付資料や付録はどうすればよいですか?
添付資料の識別子を末尾に追加します: PROJ-42_Spec_2025-10-15_AppendixA.pdf または、メイン文書名を使ったサブフォルダを使用します。
コード文書にも使えますか?
はい。技術仕様書、アーキテクチャ文書、API 文書にも使えます。文書タイプは調整してください: TechSpec、Architecture、API。
過去のプロジェクトファイルも名前を変更すべきですか?
新しいファイルから始めます。文脈が分かる場合に、プロジェクトの振り返りやアーカイブ移行の際に過去のファイルを一括リネームします。