Python 개발자가 opencode 레포를 읽기 위해 한 TypeScript/Bun/Zod 아무 질문들

It’s written by gpt-5.2 pro Python 중심으로 개발해 온 사람이 opencode 레포를 읽기 시작하면, “TypeScript 문법 자체”보다 **이 레포가 코드를 어떻게 나누고(모듈), 타입을 어떻게 다루고(타입/런타임 경계), 서버와 도구를 어떻게 엮는지(Bun/Hono/Zod)**가 먼저 걸립니다. 이 글은 바로 코드로 들어가기 위한 최소 개념 + 실제 파일 위치를 중심으로 정리한 “온보딩 글”입니다. 0) 먼저 잡아야 할 큰 그림: opencode는 무엇을 하는가? opencode를 한 문장으로 요약하면 다음이 가장 읽기 편합니다. CLI가 로컬에서 서버를 띄우고 클라이언트(TUI/웹/SDK)가 HTTP API를 호출하며 이벤트는 SSE(Server‑Sent Events) 처럼 스트리밍으로 흘린다 이 큰 그림을 가장 빠르게 보여주는 문서가 specs/project.md입니다. ...

January 4, 2026 · 5 min

크레프톤 웨이를 읽고

추석연휴에 미국여행을 가게 되면서 비행기에서 뭘할까 생각하다가 책 크레프톤웨이를 읽기로했다. 초기 창업의 과정이 생각보다 자세하게 묘사되어있었고 대표가 작가에게 회사 메일을 줄 정도로 솔직하게 이야기를 담아줄 것을 요구했다고 한다. 그리고 정작 성공과 관련된 베틀그라운드의 이야기는 책의 마지막 10% 정도에만 해당하고 나머지 90%는 베틀그라운드가 나오기 전까지의 실패 스토리로만 이루어져있다. 경영진의 목표에 도달하지 못했음을 실패로 정의한다면 블루홀에서 만들어진 몇개의 모바일 게임을 제외하고는 거의 대부분의 실패한 게임이며 그 내용이 책의 90%에 해당한다. 장병규는 첫눈을 창업하고 엑싯하고 난 뒤 찾아온 무기력함과 글로벌 서비스를 만들고 싶다는 생각에 블루홀 스튜디오를 창업했다고 한다. 게임산업에 대해 몰랐지만 엔씨소프트에 재직 중이던 박용현, 황철웅, 김정한, 박현규의 게임 전문가들과 경영 파트너인 김강석과 함께 창업했다. 이 팀은 MMORPG의 명가라는 비전과 경영과 제작의 분리, 대규모 제작을 정해진 예산과 시간에 완수하는 것을 원칙을 세워 일을 시작했고 3년에 300억을 투자하여 MMORPG 게임을 제작하는 것을 목표로 일을 시작했다. ...

September 24, 2024 · 11 min

취준하면서 배웠던 것들

학사 졸업 논문을 제출한 6월 27일부터, 내가 원했던 회사에 최종 합격한 9월 3일까지, 취업하기까지 약 두 달과 일주일 정도의 시간이 걸렸다. 첫 한 달은 이력서를 작성하고 이력서에 기재한 내용을 다시 복습하며 코딩테스트를 준비하는 기간으로 잡았다. 나머지 한 달은 이력서를 제출하고, 코딩테스트와 면접을 진행하는 시간으로 활용했다. 두 달이 지났는데도 모든 회사에서 불합격한다면, 이력서와 코딩테스트 준비를 다시 하자고 생각했다. 처음하는 취업 준비라 모든 것이 낯설었지만, 그 과정에서 새로운 것들을 많이 배웠고 이 경험을 블로그에 기록하면 좋겠다고 생각했다. ...

September 11, 2024 · 6 min

파이썬 패키지와 모듈 뜯어보기

Module 출처: 파이썬 공식문서 > The Python Tutorial > 6. 모듈 모듈에 대한 깔삼한 설명이 있어 하나 들고와봤다. 파이썬 인터프리터를 종료한 후에 다시 들어가면 이전에 만들어놨던 함수나 변수들이 사라진다. 하지만 여러 프로그램에서 썼던 편리한 함수를 각 프로그램에 정의를 복사하지 않고도 사용하고 싶을 때 파이썬은 정의들을 파일에 넣고 스크립트나 인터프리터의 대화형 모드에서 사용할 수 있는 방법을 제공한다. 그런 파일을 모듈이라고 부른다. 모듈 검색은 다음 경로로 진행된다. 예를들어 spam이란 이름의 모듈이 import 되었다고 했을 때, (1) sys.buildin_module_names를 통해 파이썬 인터프리터에서 컴파일된 모듈들에 있는지 확인하고 (2) 1에서 검색되지 않는다면, sys.path가 지정한 디렉토리 목록에서 실행한 모듈의 파일을 검색한다. sys.path는 파이썬에서 모듈을 찾을 때 참조하는 경로들의 리스트를 저장하는 속성이다. 이를통해 파이썬은 어떤 디렉토리에서 모듈을 찾아야하는지 알 수 있다. sys.path가 초기화될 때 다음 경로들이 모두 포함된다. 파이썬 스크립트를 실행할 때 그 스크립트가 위치한 디렉토리가 sys.path의 첫번째 위치로 추가된다. PYTHONPATH 환경변수에 정의된 디렉토리들도 sys.path에 추가된다. 그리고 site-packeages와 같은 특정 기본 경로들이 sys.path에 추가된다. ...

August 31, 2024 · 8 min

2024 구글 클라우드 제미나이(Gemini) 스터디잼 참가후기

학교를 졸업하는 기념으로 새로운 활동을 한번 해보고 싶어서 2024년 6월 10일부터 8월 6일까지 진행하는 Gemini 스터디잼에 참가했다. Gemini for Google Workspace 와 Intermediate: Gemini for Google Cloud Learning Path 과정의 코스를 모두 완료해야했다. 짧은 시간이었지만 GenAI 사용하여 개발 생산성을 향상 시킬 수 있는 다양한 use case들을 미리 경험해볼 수 있어서 좋았다. 먼저 Google Cloud Skills Boost 회원가입 후 Google Study Jam에서 제공하는 크레딧 쿠폰 링크를 클릭하면 대략 100 크레딧 정도가 적립되는데 나는 108 크레딧 정도가 적립되었던 것 같다. 각 코스를 수행할 때마다 1 크레딧에서 5 크레딧 정도가 차감되는 방식으로 진행되는데 전부 다 수행하고도 52 크레딧 정도가 남았을만큼 넉넉하게 제공되는 편이다. 그리고 Lab 실습마다 새로운 구글 계정이 부여되기 때문에 깔끔하게 처음부터 크롬 시크릿 창에서 하는 것을 권장한다. ...

August 5, 2024 · 12 min