개발 과정의 판단이 드러나는 플레이 가능한 포트폴리오 프로젝트 완성하기

AI의 도움을 받아 계획을 세우고, 명확한 README와 접근성을 고려한 조작 방식을 갖춘 포트폴리오 프로젝트를 만들어 보세요. 한 가지 목표에 집중하고, 실제 빌드를 테스트한 기록도 남기세요.

Seele Editorial Team수정일 2026년 11월 16일

포트폴리오 프로젝트는 검토자가 목표를 이해하고, 결과물을 직접 써 보고, 어떤 부분에 기여했는지 확인할 수 있을 때 가장 유용합니다. 학생 개발자를 위한 플레이 가능한 포트폴리오 프로젝트 템플릿을 활용하면 작은 상호작용의 범위를 정하고, 핵심 루프를 완성하고, 그 과정에서 내린 결정을 문서화할 수 있습니다. 직접 플레이할 수 있는 데모는 여러 형식 중 하나이며, 작업을 더 쉽게 평가할 수 있도록 돕는 것이 목적입니다.

이 가이드에서는 가상의 소규모 항구 항로 탐색 게임인 Harbor Signal을 예로 들어 계획을 세우는 방법을 설명합니다. 프로젝트, 학생 개발자, 코드, 인터페이스, 테스트, 결과는 모두 가상입니다. 실제 빌드나 수업 평가는 진행하지 않았습니다. 계획을 세울 때 참고하고, 모든 예시는 본인의 실제 작업과 근거 자료로 바꾸세요.

가상의 학생 개발자가 직접 플레이할 수 있는 소규모 항구 항로 탐색 프로젝트를 코드와 설계 노트와 함께 소개합니다.
작은 프로젝트에서도 플레이 가능한 결과물과 그 결과를 만들어 낸 의사결정의 근거를 함께 보여줄 수 있습니다.

한 가지 역량과 하나의 완결된 결과물 정하기

먼저 포트폴리오를 보는 사람이 내 작업에서 무엇을 알아주길 원하는지 생각해 보세요. 입력을 안정적으로 처리하는 능력, 게임 상태를 관리하는 능력, 행동에 따른 결과를 명확히 전달하는 능력, 작은 웹 콘텐츠가 화면 크기에 맞춰 동작하게 만드는 능력 등이 있을 수 있습니다. 핵심 역량 하나와 그 역량을 눈으로 확인할 수 있는 결과물 하나를 정하세요. 짧은 프로젝트 하나로 여러 전문 분야의 역량을 보여주겠다고 약속하는 것은 피하세요.

플레이어나 사용자가 반복할 짧은 루프를 정하세요. 가상의 Harbor Signal에서는 항구 지도를 살펴보고, 안전한 항로를 선택하고, 결과를 확인한 뒤 다시 시도하는 흐름을 생각해 볼 수 있습니다. 개발자는 이 루프로 입력 처리, 상태 전환, 이해하기 쉬운 피드백을 보여줄 수 있습니다. 이 예시는 해당 시스템이 실제로 구현됐다는 뜻이 아닙니다. 포트폴리오의 목표에 맞춰 작업 범위를 좁히는 방법을 보여주는 예시입니다.

본인 프로젝트의 성공 조건을 한 문장으로 적으세요. “방문자가 짧은 항로 하나를 끝까지 주행하고 결과가 달라진 이유를 이해할 수 있다”처럼 관찰할 수 있는 조건으로 정하세요. 그런 다음 필요한 애셋, 상태, 조작 요소의 최소 목록을 작성하세요. 추가 모드는 뒤로 미뤄두면 빌드를 완성할 수 있는 현실적인 계획을 세울 수 있습니다.

수정 가능한 프로젝트 카드로 작업 계획 세우기

항목정할 내용제작 후 남길 근거
목표한 가지 역량과 사용자가 확인할 수 있는 결과물해당 역량을 보여주는 짧은 데모
범위루프 하나, 제한된 콘텐츠, 대상 하나완성된 빌드와 알려진 제약 사항
기여본인의 역할과 협업 참여자정확한 크레딧과 기여 내역
도구언어, 라이브러리, 애셋, AI 지원README와 프로젝트 파일
검증대상 브라우저, 입력 방식, 예외 상황빌드, 날짜, 기기를 포함한 테스트 기록
공유호스팅, 라이선스, 개인정보 보호, 대체 자료정상 작동하는 링크와 재사용 조건

작업하는 동안 계획을 수정할 수 있도록 유지하세요. 기술적 선택이 바뀌면 문서가 실제 작업과 어긋나지 않도록 프로젝트 카드와 README를 함께 업데이트하세요. 변경 사항을 짧게 기록하면 포트폴리오가 작업 일지처럼 길어지지 않으면서도 무엇을 고려해 결정했는지 보여줄 수 있습니다.

학생 프로젝트가 작고 직접 플레이할 수 있는 목표에서 출발해 구현과 테스트를 거쳐 문서화된 포트폴리오 페이지로 완성되는 과정입니다.
명확한 목표 하나를 정해 완결된 루프를 만들고, 공개한 결과물을 검증하고 설명하세요.

기능을 추가하기 전에 버티컬 슬라이스 만들기

콘텐츠를 추가하기 전에 하나의 상호작용이 처음부터 끝까지 작동하게 만드세요. 버티컬 슬라이스에는 행동을 안내하는 메시지나 시작 상태, 사용자의 행동, 눈에 보이는 반응, 완료 또는 실패 상태, 다시 시작할 방법이 포함됩니다. 먼저 임시 그래픽으로 루프를 테스트한 다음, 포트폴리오에서 보여주려는 역량이 잘 드러나는 부분을 다듬으세요.

이슈 목록을 ‘반드시 작동해야 할 항목’, ‘개선할 항목’, ‘범위 밖 항목’이라는 세 열로 간단히 정리하세요. ‘반드시 작동해야 할 항목’에는 프로젝트 로딩, 입력 수신, 결과 표시, 오류 복구 등이 들어갈 수 있습니다. ‘개선할 항목’에는 애니메이션, 사운드, 추가 마무리 작업을 넣을 수 있습니다. ‘범위 밖 항목’을 정해 두면 마감일을 지키는 데 도움이 됩니다. 이 목록은 계획을 세우는 방법이므로 채점표처럼 쓰기보다 프로젝트에 맞게 조정하세요.

의미 있는 변경 사항은 커밋이나 다른 버전 이력으로 기록하세요. 위험 부담이 있는 리팩터링을 하기 전에는 정상 작동이 확인된 빌드를 저장하세요. 같은 수업을 듣는 학생들과 협업한다면 담당 범위, 리뷰 기준, 기여자 표기 방식을 초기에 합의하세요. 코드나 애셋을 공유하는 프로젝트에서도 본인이 맡은 작업을 분명히 알 수 있게 하세요.

스스로 설명할 수 있는 방식으로 AI 활용하기

AI는 기능 범위를 비교하거나, 작업을 단계별로 나누거나, 낯선 오류를 설명하거나, 테스트 케이스 초안을 작성하거나, README가 이해하기 쉬운지 검토하는 데 도움을 줄 수 있습니다. 학습과 초안 작성에 활용한 뒤, 프로젝트에서 코드가 어떻게 동작하는지 검증하고 최종 구현을 스스로 설명할 수 있도록 하세요. 수업 정책, 팀 내 합의, 대회 규정, 라이선스 조건을 준수하세요. 상당한 도움을 받았다면 공개가 요구되거나 검토자가 작업을 해석하는 데 영향을 주는 경우 그 내용을 밝히세요.

프로젝트 목표: [포트폴리오에서 보여줄 역량 하나]
사용자 루프: [시작, 행동, 피드백, 완료/초기화]
현재 빌드: [언어, 프레임워크, 대상 환경]
내 기여: [내가 완료한 구체적인 작업]
요청: 짧은 작업 목록과 예외 상황을 확인할 테스트를 제안해 줘.
제약 사항: [수업/팀 규칙, 라이선스, 기기]
실제로 작동하는 기능, 테스트, 성능 데이터, 사용자 피드백을 지어내지 마.

비밀 정보, 비공개 데이터, 공유 권한이 없는 코드를 외부 도구에 붙여 넣지 마세요. 제안은 테스트로 확인하기 전까지 신뢰하지 마세요. 생성된 코드를 프로젝트에 포함한다면 코드가 어떻게 작동하는지, 무엇을 변경했는지, 어느 부분을 직접 작성하거나 검토했는지 설명할 수 있도록 관련 맥락을 충분히 남기세요.

누구나 결과물을 써 볼 수 있도록 README 작성하기

GitHub 문서에서는 README를 저장소 방문자에게 프로젝트를 소개하는 파일이라고 설명합니다. 포트폴리오의 README는 코드를 살펴보는 사람과 결과만 확인하려는 사람 모두에게 도움이 되어야 합니다. 데모 링크와 짧은 설명은 상단에 배치하고, 설정 방법이나 플레이 방법을 정확하게 안내하세요.

  • 프로젝트 이름과 한 문장으로 정리한 목표
  • 데모 링크, 조작 방법, 정지 이미지 또는 짧은 녹화 영상
  • 저장소를 새로 체크아웃한 상태에서 그대로 따라 할 수 있는 요구 사항과 설정 절차
  • 본인의 역할, 협업 참여자, 사용한 도구, 주요 AI 지원 내역
  • 알려진 제약 사항, 지원하는 입력 방식, 미완성 기능
  • 애셋 출처 및 제작자 표기, 라이선스, 공개할 연락처 정보

가능하면 프로젝트를 새로 받아 설정 안내를 그대로 따라 해 보세요. 커밋, 스크린샷, 로그에서 개인정보와 인증 정보를 제거하세요. 프로젝트 라이선스와 함께 배포하는 애셋의 라이선스가 허용하는 경우에만 프로젝트를 오픈 소스라고 소개하세요.

접근성이 높고 동작을 예측할 수 있는 플레이 환경 만들기

조작 요소에 명확한 이름을 붙이고 안내를 눈에 잘 띄게 배치하세요. 상호작용 방식상 가능한 기능은 키보드로도 사용할 수 있게 하고, 사용자가 인터페이스를 이동할 때 현재 포커스가 어디에 있는지 표시하세요. 의미 있는 이미지나 시각적으로 표시되는 결과에는 대체 텍스트를 제공하고, 성공과 실패를 색상만으로 구분하지 마세요. 움직임이 필수적이지 않다면 일시정지나 모션 줄이기 옵션을 제공하세요.

W3C의 WCAG 2.2에는 키보드 조작과 비텍스트 콘텐츠의 대체 텍스트에 관한 기준이 포함되어 있습니다. 표준의 규범적 요구 사항을 평가에 활용하되, 이 비공식 체크리스트를 통과했다는 이유만으로 프로젝트가 표준을 준수한다고 주장하지 마세요. 실제 페이지를 키보드만으로 탐색해 보고, 적절한 경우 보조 기술로도 테스트한 뒤 발견한 문제를 기록하세요.

플레이 가능한 빌드를 불러올 수 없거나 불러오고 싶지 않은 사람에게는 스크린샷, 자막이 있는 짧은 녹화 영상, 텍스트로 된 단계별 안내 같은 대체 자료를 제공하세요. 화면 폭이 좁아도 페이지를 사용할 수 있게 하고, 필요한 입력 방식을 설명하고, 다시 시작하는 방법을 분명히 알려 주세요. 게임 자체를 이용할 수 없을 때도 포트폴리오의 내용을 이해할 수 있어야 합니다.

학생 개발자가 노트북과 휴대전화에서 플레이 가능한 프로젝트를 점검하고 있으며, 키보드와 텍스트, 대체 자료도 함께 보입니다.
공유하기 전에 입력, 접근성, 기기별 동작, 설정 방법, 근거 자료를 점검하세요.

공개한 빌드를 테스트하고 기록 남기기

개발 중에 사용하는 창에만 의존하지 말고 호스팅된 버전을 테스트하세요. 지원하려는 브라우저와 기기에서 직접 열어 보세요. 최초 로딩, 안내, 입력, 재시작, 완료 상태, 오류, 대체 자료를 확인하세요. 가능하다면 프로젝트를 처음 접하는 사람에게 써 보도록 하고, 누가 무엇을 테스트했는지 정확히 기록하세요. 한 사람의 사용 경험만으로 모든 사용자가 프로젝트를 이해할 것이라고 결론 내릴 수는 없습니다.

  • 처음 방문한 사람이 데모를 찾아 시작할 수 있나요?
  • 핵심 루프를 끝까지 진행하고 다시 시작할 수 있나요?
  • 지원하는 입력 방식으로 조작할 수 있나요?
  • 오류, 로딩, 이용 불가 상태가 각각 안내되나요?
  • 색상, 소리, 빠른 움직임 없이도 프로젝트를 이해할 수 있나요?
  • README 내용이 현재 호스팅된 빌드와 일치하나요?
  • 스크린샷과 설명에 담긴 주장이 같은 버전을 기준으로 하나요?

빌드 식별자, 날짜, 기기, 브라우저, 실제 관찰 내용을 기록하세요. 테스트하지 않은 부분도 분명히 밝히세요. 성능 수치를 지어내거나 수업, 고용주, 사용자 집단이 프로젝트를 검증한 것처럼 표현하지 마세요. Harbor Signal은 가상의 프로젝트이며 테스트 기록이 없습니다.

프로젝트의 개발 과정을 포트폴리오에 담기

목표, 제약 사항, 본인의 역할, 중요했던 결정 하나, 해결한 문제 하나, 배운 점을 짧은 이야기로 정리하세요. 데모와 저장소에 링크를 걸고, 둘 중 하나에 일시적으로 접속할 수 없어도 페이지 내용을 이해할 수 있게 하세요. 실제 빌드의 스크린샷을 보여주고, 프로토타입이나 콘셉트 아트에는 그 사실을 명확히 표시하세요.

제약 사항은 사과할 필요 없이 있는 그대로 설명하세요. 예를 들어 “이 데모는 데스크톱 키보드 조작을 지원합니다. 터치 입력은 구현하지 않았습니다”라고 쓸 수 있습니다. 구체적인 제약 사항은 독자가 작업을 이해하는 데 도움이 되며, 개발자가 결과물을 직접 평가했다는 점도 보여줍니다. 나중에 기능을 추가하면 기존 설명을 조용히 바꿔 두는 데 그치지 말고, 빌드를 뒷받침하는 자료와 테스트 기록도 업데이트하세요.

완성된 포트폴리오 프로젝트가 클 필요는 없습니다. 완결된 상호작용 하나를 만들고, 본인의 기여를 드러내고, 설정 방법과 제약 사항을 문서화하고, 배포된 버전이 실제로 어떻게 동작하는지 검증하세요. 그러면 검토자가 작업을 직접 살펴볼 수 있고, 무엇을 만들었는지 판단할 근거도 갖게 됩니다.

자주 묻는 질문

학생 개발자에게 좋은 포트폴리오 프로젝트란 무엇인가요?

목표가 분명한 프로젝트는 완결되고 이해하기 쉬운 결과물로 하나의 역량을 보여줍니다. 어떤 문제를 다뤘는지, 본인의 역할은 무엇이었는지, 어떤 결정을 내렸는지, 무엇이 실제로 작동하는지 설명하세요. 근거가 분명한 작은 완성작은 미완성 기능을 길게 나열한 프로젝트보다 평가하기 쉬울 수 있습니다.

학생 개발자의 포트폴리오 프로젝트는 직접 플레이할 수 있어야 하나요?

직접 상호작용하는 것이 작업을 이해하는 데 도움이 될 때만 필요합니다. 플레이 가능한 빌드로 조작 방법, 상태, 게임 로직을 보여줄 수 있고, 다른 프로젝트에서는 스크린샷과 짧은 데모만으로도 충분할 수 있습니다. 정지 이미지나 텍스트 설명을 포함하고, 실제로 테스트한 기기와 브라우저를 명시하세요.

AI는 학생 포트폴리오 프로젝트에 어떤 도움을 줄 수 있나요?

AI는 작업 범위를 구상하거나, 작업을 세분화하거나, 테스트 케이스 초안을 작성하거나, 낯선 코드를 설명하거나, 문서를 검토하는 데 도움을 줄 수 있습니다. 제안을 검증하고, 제출하는 코드를 이해하고, 수업과 팀의 규칙을 지키세요. 상당한 도움을 받았다면 공개가 요구되는 경우 그 내용을 밝히세요. AI가 생성한 결과만으로는 누가 작성했는지나 결과가 올바른지 입증할 수 없습니다.

프로젝트 README에는 무엇을 넣어야 하나요?

프로젝트가 하는 일, 결과물을 보거나 실행하는 방법, 조작 방법, 요구 사항, 알려진 제약 사항, 본인의 기여를 설명하세요. GitHub 문서에서는 README를 방문자에게 프로젝트를 설명하는 곳으로 안내합니다. 설정 절차를 정확하게 유지하고, 비공개 키, 개인정보, 공유 권한이 없는 애셋은 공개하지 마세요.

플레이 가능한 포트폴리오 프로젝트의 접근성을 어떻게 높일 수 있나요?

적용할 수 있는 기능은 키보드로도 이용할 수 있게 하고, 포커스를 눈에 띄게 표시하세요. 조작 요소에 이름을 붙이고, 읽기 쉬운 대비를 확보하고, 중요한 비텍스트 콘텐츠에는 대체 텍스트를 제공하세요. W3C의 WCAG 2.2는 키보드 조작과 대체 텍스트에 관한 성공 기준을 제시합니다. 실제 페이지를 테스트하고, 적절한 평가 없이 표준을 준수한다고 주장하지 마세요.

작고 직접 플레이할 수 있는 프로젝트를 체계적으로 시작하고 싶으신가요? AI 게임 제작 과정을 살펴보고 본인의 목표에 맞게 활용해 보세요.

SEELE AI

이 가이드를 플레이할 수 있는 작품으로 만드세요.

구체적인 기획으로 시작해 Seele AI 워크스페이스에서 개선하세요.

만들기 시작