프로젝트 파일명
팀 간 명확성과 버전 관리를 위해 프로젝트 파일은 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버전이 포함된 프로젝트 파일
검토를 거치며 발전하는 디자인이나 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과 디자인에 사용하세요.
파일명에 상태를 넣지 마세요
spec_DRAFT_PENDING_REVIEW.pdf는 워크플로가 좋지 않다는 신호입니다. 상태 추적에는 프로젝트 관리 도구를 사용하세요.
개인 대명사는 절대 사용하지 마세요
My_Proposal.pdf나 Team_Document.pdf는 소유권 혼란을 만듭니다. 대신 프로젝트 코드와 작성자 이름을 사용하세요.
일반적인 실수
프로젝트 코드를 생략함
파일이 폴더 곳곳에 흩어집니다. 수동 검색 없이는 한 프로젝트의 모든 문서를 찾기 어렵습니다.
수정: 항상 프로젝트 코드로 시작하세요: 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 또는 메인 문서 이름으로 하위 폴더를 사용하세요.
코드 문서화에도 사용할 수 있나요?
예. 기술 spec, 아키텍처 문서, API 문서화에 적용됩니다. 문서 유형은 TechSpec, Architecture, API처럼 조정하세요.
기존 프로젝트 파일 이름도 바꿔야 하나요?
새 파일부터 시작하세요. 맥락을 알 수 있을 때 프로젝트 회고나 아카이브 이전 중에 기존 파일을 일괄 이름 변경하세요.