한 페이지의 글에서 플레이 가능한 게임까지
한 캐주얼 게임 스튜디오가 자사 웹사이트에 올릴 작은 3D 게임을 원합니다. 가진 것은 글로 쓴 브리프 하나뿐입니다. 디자인 시안도, 참고 이미지도, 아트도 없습니다. 테이블 위에 젤리 같은 바다가 놓여 있고, 그 한가운데에 사람이 사는 섬이 있으며, 발사대 위에는 로켓이 서 있습니다. 플레이어는 작업선을 몰고 로켓 부품 다섯 개를 가지러 가고, 그사이 날씨는 맑은 아침에서 해 질 녘 폭풍으로 바뀝니다. 마지막 부품이 도착하면 로켓이 발사됩니다.
이것을 손으로 만들면 작은 팀이 몇 주를 들여야 합니다. 누군가는 섬과 마을을 모델링하고, 누군가는 물과 날씨를 작성하고, 누군가는 게임 루프를 만들고, 누군가는 그 모든 것을 테스트해야 합니다. 게다가 스튜디오는 이 게임을 오프라인에서 돌아가고, 엄격한 GPU 예산 안에 들어가며, 스크립트로 조작할 수 있는 인터페이스를 갖춘 HTML 파일 하나로 받기를 원합니다. QA 팀이 게임을 자동으로 플레이할 수 있도록 하기 위해서입니다.
그래서 이 브리프를 Eigent의 Gemini 4 Neon에 맡겼습니다. 43분 뒤 돌아온 것은 2.4 MB 파일 하나였습니다. 마을, 신호등, 페리, 갈매기, 비행기가 있는 살아 있는 섬, 다섯 가지 날씨와 낮과 밤, 그리고 타이틀 화면부터 발사까지 플레이할 수 있는 배달 게임입니다.
워크플로 한눈에 보기
브리프 하나로 빈 폴더에서 완성된 게임까지 이어졌습니다. 단계마다 저희가 확인할 수 있는 결과물이 남았습니다.
| 단계 | 한 일 | 만들어진 결과 |
|---|---|---|
| 읽기 | 브리프 전문, spec.json, 에셋 라이선스 안내를 읽음 | 규칙: 파일 하나, 인터넷 없음, three.js만 사용, 엄격한 수치와 예산 |
| 준비 | 예정된 Python 환경이 없다는 것을 발견하고, 자기 작업을 테스트하려고 Playwright와 헤드리스 Chromium을 설치함 | 직접 조작할 수 있는 브라우저 |
| 구축 | 게임을 모듈 5개(소스 약 204 KB)로 작성하고 three.js와 함께 파일 하나로 번들링함 | 2.27 MB의 첫 빌드 |
| 테스트 | 자체 Playwright QA 스위트를 실행하고 모든 뷰의 스크린숏을 확인함 | 68개 중 66개 통과, 실패 2건 발견 |
| 다듬기 | 발견한 문제를 세 차례에 걸쳐 개선함: 드로 콜, 물의 벽, 밤 조명, 산호초, 로켓의 불꽃과 연기 | 69개 중 69개 통과, 오류 0건 |
| 출시 | 파일의 네트워크 접근과 라이선스를 감사함 | 오프라인에서 돌아가는 scene.html 하나, 2.38 MB |
이제 Gemini 4 Neon이 어떻게 해냈는지 살펴보겠습니다. 부족했던 부분과 그 이유도 함께 다룹니다.
전달한 결과물
- 살아 있는 섬. 해변, 언덕, 바위 해안. 도로, 회전교차로, 실제로 작동하는 신호등 8개를 갖춘 건물 31채의 마을, 자동차 14대, 부두 사이를 오가는 페리, 마을 위를 나는 갈매기 16마리, 비행기 2대. 방파제 위에는 등대가, 전용 부두 옆 발사대에는 로켓이 있습니다.
- 물과 날씨. 깊은 해저, 파도, 항적, 커스틱, 수중 산호초를 갖춘 투명한 젤리 블록. 날씨는 맑음, 흐림, 비, 눈, 폭풍의 다섯 가지이며, 눈은 땅과 지붕에 쌓입니다. 마을 불빛, 달, 별이 있는 낮과 밤의 순환도 있습니다.
- 완전한 게임. 5초 만에 15 m/s에 도달하고 3초 동안 192° 회전하는 작업선(브리프의 요구치는 8 m/s와 45°). 로켓 부품 다섯 개를 하나씩 싣고 배달합니다. 배달할 때마다 보급기가 다음 부품을 공중 투하하고, 9:00에서 18:00으로 가는 동안 날씨는 점점 나빠집니다. 네 번째 부품 뒤에는 젤리 바다가 흔들리고, 다섯 번째 부품 뒤에는 로켓이 496 m를 상승합니다. 엔딩 화면에는 시간, 점수, 별점이 표시됩니다.
- 마케팅 모드. URL에
?explore를 붙이면 자유 카메라, 날씨 버튼, 시간대 슬라이더, 프리셋 뷰 6개를 쓸 수 있습니다. - QA 인터페이스.
window.sceneAPI와window.game을 통해 스크립트가 시뮬레이션을 프레임 단위로 진행하고, 카메라를 움직이고, 배를 순간 이동시키고, 모든 자동차, 배, 비행기의 상태를 읽을 수 있습니다. 채점기는 이것으로 게임 전체를 플레이했고, 저희도 이것으로 영상을 촬영했습니다.
설정
- Eigent 1.0.8의 단일 세션에서 Single Agent 모드로, 모델은 Gemini 4 Neon, 사고 수준(thinking effort)은 Medium을 사용했습니다.
- 로컬 폴더 하나에 작업을 담았습니다.
PROMPT.md(브리프 전문)와 읽기 전용input_files/입니다. 여기에는 three.js 0.186.1,spec.json(좌표, 예산, 엄격한 수치), 에셋 라이선스 안내가 들어 있습니다. - 단독 작업. 아무도 질문에 답하거나 개입하지 않았습니다. 모든 결정은 에이전트 스스로 내렸습니다.
- 오프라인. 완성된 파일은 네트워크 요청을 전혀 해서는 안 됩니다. 텍스처, 사운드, 셰이더는 모두 코드로 생성해야 합니다.
- 엄격한 한도. 전경 프레임 기준으로 드로 콜 최대 450, 삼각형 300만 개, GPU 메모리 400 MB. 브리프는 조작감 수치, 공중 투하 타이밍, 진동의 크기, 발사 높이도 정해 두었습니다.
Gemini 4 Neon의 작업 방식
Gemini 4 Neon은 단일 에이전트로 작업을 진행했습니다. 시간은 실행 시작부터 경과한 분입니다.
- 파악(0:00–1:00).
PROMPT.md,spec.json, 라이선스 안내를 읽은 뒤, 머신에 어떤 도구가 있는지 확인했습니다. Python, Node, 그리고 브라우저입니다. - 에이전트 탓이 아닌 일시 정지(1:00–6:00). 작업 공간에 파일이 513개 있어 Eigent의 체크포인트 한도인 500개를 넘었기 때문에, Eigent가 멈추고 계속할지 사람에게 물었습니다. 실행 시간 중 약 5분이 이 클릭을 기다리는 데 쓰였습니다.
- 테스트 환경 직접 구축(6:00–10:00). 브리프에 적힌 Python 환경이 갖춰져 있지 않았기 때문에, QA 팀과 같은 방식으로 게임을 테스트하려고 Playwright와 Chromium을 직접 설치했습니다. 또 three.js 파일을 살펴보며 파일 하나로 깔끔하게 번들링할 준비를 했습니다.
- 게임 작성(10:00–20:00). 모듈 5개를 작성했습니다. 먼저 지형과 노이즈, 다음으로 물, 하늘, 날씨, 이어서 마을, 식생, 랜드마크, 교통, 마지막으로 게임 루프, QA 인터페이스, UI입니다. 20:06에 모든 것을 2.27 MB 단일 파일로 번들링하고 Node로 구문을 검사했습니다.
- 테스트하고 눈으로 확인하기(21:00–27:00). 자체 Playwright 스위트는 68개 중 66개를 통과했습니다. 잡아낸 실패는 두 가지였습니다. 드로 콜이 예산 450 대비 865였고, 배의 속도가 브리프의 8 m/s 대비 3.79 m/s에 그쳤습니다. 이어서 섬 전경부터 승리 화면까지, 자기 게임의 스크린숏 12장을 열어 검토했습니다.
- 세 차례의 다듬기(27:00–43:00). 드로 콜을 묶고, 물의 벽 정렬 방식을 고치고, 지형 색을 바로잡고, 밤 조명, 수중 산호초, 로켓 발사를 다시 만들었습니다. 재작성 후 드로 콜은 149로 줄었고 모든 점검이 통과했습니다. 이후 두 차례에 걸쳐 언덕을 더 푸르게, 물을 더 밝게 만들고, 산호와 켈프, 로켓 불꽃과 피어오르는 연기를 더했으며, 연기를 가리던 컬링 버그를 고쳤습니다. 매번 눈으로 확인했고, 스크린숏은 모두 27장이었습니다.
- 출시(43:24). 마지막으로 오프라인과 라이선스 감사를 실행하고 결과물을 전달했습니다. 점검 69개 중 69개 통과, 오류 0건입니다.
모두 합쳐 모델 호출 73회, 도구 호출 86회, 43분 36초가 걸렸으며, 체크포인트 클릭 외에 사람의 입력은 없었습니다.
결과
출력 폴더에는 파일 하나가 생겼습니다. output/scene.html, 2.38 MB입니다. three.js r186이 인라인으로 포함되었고 MIT 고지도 그대로 유지되었습니다. 열면 바로 플레이할 수 있습니다. ?explore를 붙이면 쇼룸이 됩니다.
| 전달된 파일에서 측정한 항목 | 결과 | 한도 또는 목표 |
|---|---|---|
| 드로 콜, 전경 프레임 | 145 | ≤ 450 |
| 삼각형 | 355 K | ≤ 3 M |
| GPU 메모리 | 49 MB | ≤ 400 MB |
| 네트워크 또는 로컬 파일 요청 | 0 | 0 |
| 콘솔 오류 | 0 | 0 |
| 5초 후 최고 속도 | 15 m/s | ≥ 8 m/s |
| 3초 동안의 회전 | 192° | ≥ 45° |
| 스크립트로 완료한 배달 | 5 / 5, 이어서 발사와 엔딩 화면 | 5 |
| 로켓 상승 | 496 m | ≥ 50 m |
| 소프트웨어 렌더링 헤드리스 Chromium에서 준비 완료까지 | 17초 | – |
채점 결과
파일은 작업 자체의 증거 수집기로, 작업 전용 Docker 이미지 안에서, CPU 2개와 SwiftShader 렌더링으로 채점했습니다. 스크립트가 페이지를 조작해 모든 것을 측정하고, 그 측정값으로 91개의 이진 기준 각각을 판정합니다. 74개 기준이 352점을 부여하고, 17개의 감점 항목이 최대 99점을 깎을 수 있습니다. 각 기준의 규칙을 측정값에 적용해 평가했을 뿐 LLM 심사는 쓰지 않았으므로, 이것은 프로그램으로 산출한 점수입니다. 같은 평가 방식으로 이 작업의 이전 공식 점수 3건을 모두 정확히 재현할 수 있습니다.
| 그룹 | 점수 |
|---|---|
| 지시 준수 | 21 / 21 |
| 파일 유효성과 에셋 | 3 / 3 |
| 엔지니어링과 구성 | 6 / 6 |
| 구조와 작업 정확성 | 122 / 167 |
| 시각적 품질과 미감 | 91 / 155 |
| 감점 | −31(17개 중 5개 발생) |
| 종합 | 0.602(352점 중 212점, 74개 기준 중 59개) |
다섯 가지 감점이 없었다면 같은 파일의 점수는 0.69입니다.
실행 자체도 에이전트의 도구 호출을 통해 감사했습니다.
| 확인 항목 | 확인 결과 |
|---|---|
| 웹 조사 없음 | 웹 검색, 브라우저, 페이지 가져오기 호출이 없었습니다. |
| 다운로드는 테스트용으로만 | 브리프가 예상한 환경이 갖춰져 있지 않았기 때문에, 자기 게임을 테스트하려고 Playwright를 pip로 설치하고 Chromium을 다운로드했습니다. 게임 파일 자체는 어떤 요청도 하지 않습니다. |
| 자기 작업을 테스트함 | 69개 항목의 QA 스위트를 직접 작성해 실행했고, 스크린숏 27장을 검토했습니다. |
부족했던 부분과 그 이유
Gemini 4 Neon은 브리프가 요구한 모든 것을 만들었고, 게임은 처음부터 끝까지 플레이됩니다. 잃은 점수는 사실감의 가장 어려운 층위와, 교통과 카메라의 몇 가지 세부 사항에 있습니다.
- 실제로 움직이고 빛을 굴절시키는 물. 채점기는 진짜 파도(테스트용 판이 물 레이어 아래에 렌더링됨), 굴절(해저의 블록이 왜곡되어 보이지 않음), 속도에 따라 넓어지는 항적을 확인하지 못했습니다. 커스틱은 있었지만 너무 성겼고, 해안의 파도는 충분히 밝거나 역동적이지 않았습니다.
- 움직여야 할 것들. 나무가 흔들리지 않고, 멈춰 있는 배는 폭풍 속에서 0.18 m만 떠밀렸습니다. 채점기가 원한 것은 0.5 m였습니다.
- 공중 투하와 발사의 세부 사항. 40초 안에 제자리에 놓인 투하는 4회 중 3회였고, 먼바다로의 투하에서는 물결 고리가 나타나지 않았습니다. 이륙 1초 후의 불꽃은 채점기의 프레임에서 너무 작았습니다.
- 눈과 머티리얼. 눈은 땅의 91%, 지붕의 87%를 덮었지만 나무 꼭대기는 19%에 그쳤습니다. 자동차와 로켓에는 주로 반사하지 않는 머티리얼이 쓰였습니다.
- 감점 5건(−31). 자동차 2대가 서로 2 m 이내로 가까워졌고, 반대 방향 차들이 중앙선에 너무 붙어 있었습니다. 주행한 도로 지점의 7%가 잔디 아래에 있었습니다. 카메라의 회전 속도는 8°/s 한도 대비 29°/s로 튀었습니다. 그리고 보급기가 샘플 8개에서 수면 아래로 내려갔습니다.
무거운 감점 항목은 모두 피했습니다. 배는 떨리지 않고, 깜박이는 것도 없으며, 일시 정지해도 안전하고, 부품이 비행기를 뚫고 지나가지 않으며, 갑판에 커스틱이 비치지 않고, 콘솔 오류도 없습니다.
또한 이것은 사고 수준 Medium에서의 단 한 번의 실행이었습니다. 이렇게 긴 작업에서는 점수가 실행마다 달라질 수 있습니다.
배운 점
- 코드 조각이 아니라 제품 전체를 만듭니다. 한 페이지의 글에서 세계, 게임, UI, 마케팅 모드, QA 인터페이스까지 파일 하나에 담았습니다.
- 테스트할 수단을 주면, 테스트합니다. 환경이 빠져 있자 직접 브라우저를 준비하고, QA 스위트를 작성하고, 넘기기 전에 스스로 실패를 잡아냈습니다.
- 자기가 만든 것을 직접 봅니다. 디자이너처럼 스크린숏을 검토하고 눈에 띈 것을 고쳤습니다. 물의 벽, 밤 조명, 산호초, 발사 연기입니다.
- 수치는 적혀 있으면 맞추기 쉽습니다. 브리프에 있던 조작감, 예산, API 수치는 모두 통과했습니다. 남은 것은 어떤 사양 문구로도 못 박을 수 없는 사실감입니다. 빛을 굴절시키는 물, 흔들리는 나무, 절대 부딪히지 않는 교통.
브리프가 팀을 기다릴 필요는 없습니다. Eigent의 Gemini 4 Neon에 맡기고, 결과물을 플레이해 보세요.
직접 실행해 보기
- 작업 패키지를 다운로드(
game-threejs-jelly-sea-express.zip)해 빈 폴더에 압축을 풉니다. 안에는PROMPT.md와, 읽기 전용 입력 파일이 든environment/폴더가 있습니다. - 입력 폴더를 준비합니다.
environment/input_files/를 작업 폴더에input_files/로 복사하고, 그 옆에 빈output/폴더를 만듭니다. - Eigent를 열고 그 작업 폴더에 연결된 Space에서 새 프로젝트를 시작합니다.
- Single Agent 모드를 선택하고 모델로 Gemini 4 Neon을 고른 뒤, 사고 수준을 Medium으로 설정합니다.
- 브리프를 붙여 넣습니다.
PROMPT.md에서 Version B(Eigent), 즉 두---줄 사이의 텍스트를 복사합니다. 폴더 경로를 자신의 경로로 바꾼 뒤 첫 메시지로 보냅니다. 힌트는 덧붙이지 마세요. - 그대로 실행되게 둡니다. 질문에 답하거나 개입하지 마세요. 45분 정도 걸립니다. Eigent가 작업 공간 체크포인트 한도에서 멈추면 클릭해서 계속하세요. 이것은 에이전트가 아니라 Eigent의 동작입니다.
- 결과를 플레이합니다. 브라우저에서
output/scene.html을 엽니다. Start를 누르고 W A S D로 항해합니다(Esc로 일시 정지).scene.html?explore를 열면 자유 카메라, 날씨 버튼, 시간 슬라이더, 프리셋 뷰를 쓸 수 있습니다. - 예산과 API를 확인합니다. 브라우저 콘솔에서
window.sceneAPI와window.game이 모두 존재해야 합니다. 전경에서window.sceneAPI.renderer.info.render.calls는 450 미만이어야 합니다. - 실행을 감사합니다. Dev mode를 켜고 도구 호출을 살펴봅니다. 웹 검색이나 가져오기 호출은 없어야 합니다. 패키지 설치가 있다면 테스트 도구를 위한 것뿐이어야 합니다.
크레딧: Gemini 4 Neon과 Eigent로 제작.








