상담 신청
홈 › 작업 노트 › 개발 › 게임 프로그래머 포트폴리오에 넣을 기술 문서 구성

개발 · 점검 노트

게임 프로그래머 포트폴리오에 넣을 기술 문서 구성

게임 빌드와 저장소 주소를 보냈는데 반응이 없습니다. 바쁜 검토자는 빌드를 실행할 시간도, 수천 줄의 코드를 열어 볼 시간도 넉넉하지 않습니다. 그 사이를 이어 주는 것이 기술 문서입니다. 몇 쪽 안 되는 문서로 무엇을 만들었고 어떻게 풀었는지를 먼저 보여 주어야 빌드와 코드까지 손이 갑니다.

작업 노트 413 · 읽는 시간 약 5분 · 2026.11.17 정리

첫 장: 한눈에 보는 프로젝트 요약

첫 장에는 게임 이름, 장르, 개발 기간, 개발 인원과 내 역할, 사용한 엔진과 언어, 대표 화면 한두 장, 플레이 영상 링크를 넣습니다. 검토자는 이 한 장으로 계속 볼지 결정합니다. 점검할 때는 이 페이지만 보고 무슨 게임인지, 내가 무엇을 했는지 30초 안에 설명할 수 있는지 스스로 확인합니다. 설명이 길어진다면 정보가 너무 많거나 핵심이 빠진 것입니다.

팀 프로젝트라면 내 역할을 특히 분명히 적습니다. 클라이언트 프로그래밍 담당이라는 말보다 플레이어 조작, 적 AI, 세이브 기능 구현처럼 기능 단위로 적는 편이 정확합니다. 팀 전체가 만든 결과물을 내 것처럼 보이게 하면 면접에서 깊이 물었을 때 곧바로 드러납니다. 맡은 부분이 작더라도 정확하게 적는 쪽이 신뢰를 줍니다.

플레이 영상은 1~2분 안에 핵심 기능이 다 보이도록 편집합니다. 빌드를 실행하지 않아도 영상만으로 무엇이 구현되었는지 알 수 있어야 합니다. 영상이 길고 메뉴 화면부터 천천히 시작한다면, 가장 자신 있는 장면을 앞쪽으로 옮기는 것만으로도 인상이 달라집니다. 영상 화면 구석에 기능 이름을 짧은 자막으로 띄워 두면 무엇을 보고 있는지 더 분명해집니다.

구조 설명: 코드를 열기 전에 보여 줄 지도

다음 장에는 프로젝트의 전체 구조를 그림으로 보여 줍니다. 주요 클래스나 모듈을 상자로, 그 사이의 관계를 화살표로 그린 간단한 도식이면 충분합니다. 플레이어, 적, 전투 판정, UI, 데이터 관리처럼 큰 덩어리가 어떻게 나뉘고 서로 무엇을 주고받는지 보여 줍니다. 검토자는 이 지도를 보고 코드를 열었을 때 어디부터 봐야 할지 압니다.

점검할 때는 도식의 상자 이름과 실제 코드의 클래스 이름이 같은지 확인합니다. 문서에는 전투 관리자라고 적혀 있는데 코드에는 다른 이름으로 되어 있으면 검토자가 헤맵니다. 또 화살표가 사방으로 얽혀 있다면 구조 자체를 다시 볼 신호일 수 있습니다. 도식을 그리다가 구조의 문제를 발견하는 경우가 생각보다 많습니다.

구조 설명에는 왜 이렇게 나눴는지 한두 문장을 붙입니다. 적 종류가 늘어날 것을 대비해 공통 동작을 부모 클래스로 묶었다거나, UI가 게임 로직을 직접 건드리지 않도록 중간에 이벤트를 두었다는 식입니다. 선택의 이유가 있는 구조는 그 자체로 설계 능력을 보여 줍니다.

게임프로그래밍 수업에서 다루는 작업 예시
게임프로그래밍 수업에서 다루는 작업 예시

핵심 기능 설명: 문제, 해결, 결과의 순서

가장 공들일 부분은 핵심 기능 서너 개를 골라 깊게 설명하는 것입니다. 기능마다 어떤 문제가 있었는지, 어떻게 해결했는지, 결과가 어떻게 달라졌는지를 순서대로 적습니다. 예를 들어 적이 많아지면 프레임이 떨어지는 문제가 있었고, 매번 새로 만들던 총알을 미리 만들어 두고 재사용하는 방식으로 바꾸었고, 그 결과 같은 장면에서 멈칫거림이 사라졌다는 식입니다.

설명에는 짧은 코드 조각과 화면 캡처를 함께 넣습니다. 코드는 핵심이 드러나는 십여 줄 정도로 잘라 붙이고, 전체 파일은 저장소 링크로 연결합니다. 비교할 수 있는 결과가 있다면 고치기 전과 후를 나란히 보여 줍니다. 숫자로 측정할 수 있었다면 측정 방법도 한 줄 적어 두어야 검토자가 믿을 수 있습니다.

기능 목록을 길게 나열하는 것은 피합니다. 이동, 점프, 공격, 인벤토리, 상점, 퀘스트를 한 줄씩 적은 목록은 무엇을 만들었는지는 알려 주지만 어떻게 생각했는지는 보여 주지 못합니다. 열 개를 얕게 적는 것보다 세 개를 깊게 적는 편이 프로그래머의 사고 과정을 훨씬 잘 보여 줍니다.

개발 기록과 남은 과제

개발 과정에서 막혔던 지점과 그때 내린 판단을 짧게 정리한 기록을 붙입니다. 매주 쓴 개발 일지가 있다면 그중 의미 있는 장면 몇 개를 골라 다듬으면 됩니다. 특히 처음 방식이 실패해서 방향을 바꾼 이야기는 좋은 재료입니다. 실패를 숨기기보다 어떻게 알아채고 바꿨는지를 보여 주는 편이 문제 해결 능력을 잘 드러냅니다.

알려진 문제와 개선하고 싶은 점도 솔직하게 적습니다. 특정 상황에서 충돌 판정이 어긋나는 문제가 남아 있고 원인은 이렇게 추정한다, 시간이 있었다면 데이터 구조를 이렇게 바꾸겠다는 식입니다. 완벽하지 않은 부분을 스스로 알고 있다는 것은 감점이 아니라 오히려 객관적으로 자기 코드를 본다는 신호가 됩니다.

마지막에는 실행 방법을 적습니다. 빌드 파일을 어디서 받고, 어떤 조작키를 쓰며, 테스트용 치트 기능이 있다면 어떻게 쓰는지 적어 둡니다. 검토자가 실행에 실패하면 그다음은 없습니다. 다른 컴퓨터에서 처음부터 실행해 보는 점검을 꼭 거칩니다.

게임프로그래밍 수업에서 다루는 작업 예시
게임프로그래밍 수업에서 다루는 작업 예시

제출 전 최종 점검표

  • 첫 장만 보고 게임과 내 역할을 30초 안에 설명할 수 있는가
  • 구조 도식의 이름과 실제 코드 이름이 일치하는가
  • 핵심 기능마다 문제, 해결, 결과가 순서대로 적혀 있는가
  • 코드 조각이 저장소의 실제 위치와 연결되어 있는가
  • 다른 컴퓨터에서 실행 방법대로 따라 했을 때 빌드가 실행되는가
  • 문서 분량이 검토자가 한 번에 읽을 수 있는 수준인가

점검표에서 걸리는 항목이 있다면 그 부분만 고쳐서 다시 확인합니다. 특히 마지막 항목은 욕심이 생기기 쉬운 부분입니다. 핵심 기능 설명이 열 쪽을 넘어간다면 덜 중요한 기능을 저장소 README로 옮기고, 문서에는 가장 자신 있는 기능만 남깁니다. 기술 문서는 모든 것을 담는 곳이 아니라 더 보고 싶게 만드는 곳입니다.

빌드와 소스, 기능 설명과 개발 기록, 발표 자료까지 어떻게 한 묶음으로 엮을지 막막하다면, SBS아카데미게임학원 게임프로그래밍 과정 무료 상담에 지금 가진 프로젝트를 가져와 문서 구성을 함께 점검해 보세요.

자주 묻는 질문

기술 문서는 어떤 형식으로 만드나요?

PDF 문서나 웹 페이지가 흔히 쓰입니다. 어느 형식이든 링크가 제대로 동작하고, 모바일에서 열어도 읽을 수 있는지 확인해 두는 편이 좋습니다.

프로젝트가 하나뿐이어도 문서를 만들어야 하나요?

하나뿐일수록 더 필요합니다. 작은 프로젝트라도 구조와 문제 해결 과정을 잘 정리하면 깊이를 보여 줄 수 있습니다.

게임프로그래밍 수업 예시
이 글과 이어지는 과정게임프로그래밍 과정 안내

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.

과정 보기 →

함께 읽으면 좋은 노트

무료 상담 신청

읽은 글과 관련해 궁금한 점이나 지금 상황을 남기면 담당자가 연락드립니다.

상담·컨설팅 무료 · 전화 상담 010-2135-9730

전화상담 신청