처음에는 제가 어떤 일을 해왔고 지금은 무엇을 배우고 있는지 한곳에 정리한 소개 사이트를 만들고 싶었습니다. 개발은 전혀 할 줄 몰랐지만 담고 싶은 내용은 분명해서, AI에게 부탁하며 만들기 시작했습니다.
그렇게 만든 사이트가 지금은 포트폴리오와 기술 블로그인 Systems Notebook으로 이어졌습니다. 처음부터 지금의 모습을 계획한 것은 아니지만, 소개 페이지가 생기니 배운 내용을 담고 싶었고 글을 쓰니 움직이는 그림으로 설명하고 싶어졌습니다. 그런데 만들고 싶은 것이 늘어날수록, AI에게 ‘만들어 달라’는 말만으로는 부족해졌습니다.
글을 쓰자, 움직이는 그림이 필요해졌습니다
기술전략센터로 팀을 옮기고 세미나에 주로 참석하게 되면서, 새로 배우는 내용과 직접 경험한 기술을 사이트에 글로 남기고 싶어졌습니다. 제 소개를 적던 페이지가 기술을 설명하는 공간으로 넓어진 계기였습니다.
기술을 설명하다 보니 글만으로는 아쉬운 장면이 있었습니다. 데이터가 어디에서 출발해 어느 지점을 거치는지, 그 사이에 어떤 처리가 일어나는지 보여주고 싶었습니다. 애니메이션을 넣고 싶어진 이유도 단순히 화면에 움직임을 더하기 위해서가 아니라, 그 움직임으로 기술의 흐름을 설명하고 싶었기 때문입니다.
그 생각을 실제 화면으로 옮기는 방법은 몰랐지만, 이미 AI와 사이트를 만들어 본 경험은 있었습니다. 우선 필요한 기능부터 요청하고, 화면이 나오면 직접 써보면서 조금씩 고쳐 나갔습니다.
‘직관적으로 만들어 달라’는 말로는 부족했습니다
가장 답답했던 것은 제가 원하는 모습을 AI가 이해하도록 설명하는 일이었습니다. 화면은 나왔고 애니메이션도 움직였지만, 정작 제가 설명하고 싶었던 내용은 잘 드러나지 않았습니다.
처음에는 직관적인 그림과 애니메이션을 만들어 달라고 했는데, 결과를 보니 설명 상자만 움직이고 있었습니다. 글을 상자에 넣고 움직이게 했다고 해서 데이터의 흐름까지 읽히는 것은 아니었습니다. 움직임이 있다는 것과, 그 움직임을 보고 내용을 이해할 수 있다는 것은 달랐습니다.
그래서 참고할 만한 화면을 찾고, 요청도 장면 단위로 바꿨습니다. 데이터가 어디에서 출발해 어디로 가야 하는지, 무엇이 먼저 움직이고 그다음에는 어떤 일이 일어나야 하는지를 하나씩 풀어서 적었습니다. ‘직관적으로’라는 말에 맡겼던 부분을 구체적인 장면으로 바꾼 것입니다.
VPN 설명 그림을 고친 과정이 한 예입니다. 처음에는 작은 위치 표식이 움직이고 큰 설명 상자는 따로 남아 있었는데, 이를 보호층을 가진 패킷 전체가 노트북에서 사이트까지 이동하는 장면으로 바꿨습니다.
VPN 서버에서는 바깥 보호층이 열리고, 안쪽 HTTPS 보호층은 사이트에 도착할 때까지 남아 있도록 표현했습니다. 어디에서 무엇이 벗겨지고 무엇은 계속 보호되는지를 패킷의 움직임으로 보여주려 한 것입니다. 단순히 무언가가 이동하는 그림이 아니라, 이동 중에 달라지는 보호 상태를 설명하는 그림이 필요했습니다.
이렇게 요청하자 결과가 원하는 모습에 가까워졌습니다. 물론 한 번에 끝나지는 않아서, 어긋난 장면을 짚어 다시 요청하고 바뀐 화면을 열어 보는 과정을 반복했습니다. 그림을 고치는 동안 제가 무엇을 설명하려는지도 더 분명해졌습니다.
기능이 생긴 뒤에도 고칠 일은 남았습니다
작업 기록에는 새 기능을 추가한 일뿐 아니라, 이미 만든 부분을 다시 손본 일도 자주 등장합니다. 첫날부터 배포 방식을 바꾸고 접속 경로 설정을 고친 커밋이 세 개 연이어 남아 있습니다. 홈페이지 내용을 만드는 것과, 주소를 열었을 때 그 홈페이지가 제대로 나오게 하는 것은 각각 따로 챙겨야 했습니다.
9월 10일에는 AI 글을 추가한 뒤 같은 날, 화면 구성과 글꼴 로딩 때문에 글의 특정 위치로 들어가는 링크가 어긋나는 문제를 고쳤습니다. 그림이 나타난 뒤에도 독자가 읽으려던 위치가 유지되도록 하는 수정이었습니다.
스크롤할 때 화면이 흔들리는 문제, 설명 그림의 크기와 간격, 마우스 움직임을 따라오는 커서의 반응도 손봤습니다. 그림 검수 기록에는 모바일에서 주소 라벨이 잘리거나, 선택한 조건과 맞지 않는 범례가 남아 있어 고친 내용도 있습니다. 기능을 넣을 때와, 그 기능이 들어간 화면을 실제로 읽고 조작할 때는 살펴볼 부분이 달랐습니다.
2026년 6월 30일부터 10월 16일까지 GitHub에는 이런 작업을 담은 50개의 커밋이 남아 있습니다. 한 커밋에 여러 수정이 들어가기도 하고 모든 시도가 기록되는 것도 아니어서, 이 숫자가 시행착오의 횟수를 뜻하지는 않습니다.
핵심 기능이 나오면 먼저 써보고, 글과 그림이 들어간 뒤에는 읽는 흐름과 움직임을 살폈으며, 작은 화면에서의 모습과 조작도 확인했습니다. 새 기능을 더하는 사이사이에 이미 만든 것을 다시 보고 고치는 일이 계속 이어졌습니다.
하나를 만들어 보니, 다음에 만들고 싶은 것도 생겼습니다
이렇게 사이트 하나를 실제로 만들어 다듬어 본 경험은 평소 필요했던 다른 도구들을 직접 만들어 보는 계기가 되었습니다. 요즘은 여자친구와 소통하기 위한 Soram을 만들고 있고, 주식과 코인 거래소 등을 한 화면에서 보고 싶어 시작한 Finix도 있습니다. Finix는 아직 개발을 시작한 단계이지만, 두 프로젝트 모두 제가 필요하거나 쓰고 싶은 것에서 출발했습니다.
이 경험을 정리하면서 Felix Rieseberg의 글 두 편을 함께 읽었습니다. 「Made by mechanical means」에는 AI와 홈페이지를 만들며 시안을 보고, 피드백하고, 반복해서 고친 과정이 담겨 있습니다. 「How to be more ambitious」는 AI와 할 수 있는 일의 목표와 접근 범위를 넓혀 보자고 제안합니다. 반복해서 고치는 일과, 하나를 만든 뒤 다음 작업의 범위를 넓혀 가는 일 모두 제가 이 사이트를 만들며 겪은 과정이기도 했습니다.
이 과정에서 제가 계속 맡아야 했던 일은 무엇을 담을지 정하고, 어떻게 보여야 하는지 설명하며, 나온 결과가 그 의도에 맞는지 확인하는 것이었습니다. 코드가 만들어진 뒤에도 이 판단은 남았습니다.
처음에는 ‘직관적인 애니메이션’을 요청했습니다. 이제는 패킷이 어디로 움직여야 하고, 어느 지점에서 어떤 보호층이 열려야 하는지를 설명합니다. 제가 원하는 사이트에 가까워진 것은 이런 차이를 하나씩 짚고 고쳐 온 덕분입니다. 지금도 글을 다듬고 그림을 고치며 사이트를 만들어 가고 있습니다.