개발자도 글을 잘 써야 하는 시대

댓글 0
댓글을 작성하려면 로그인이 필요합니다.
아직 댓글이 없습니다. 첫 번째 댓글을 작성해보세요!

댓글을 작성하려면 로그인이 필요합니다.
아직 댓글이 없습니다. 첫 번째 댓글을 작성해보세요!
PR을 올렸는데 리뷰어한테 이런 코멘트를 받은 적 있다.
"이 PR이 왜 필요한지 모르겠어요. 설명 좀 더 요청 드립니다. "
코드는 완벽하게 짰다. 기능도 잘 돌아간다. 근데 PR 설명란에는 "버그 수정" 네 글자만 적혀 있었다. 리뷰어는 코드를 처음부터 끝까지 읽어가며 맥락을 직접 파악해야 했다. 이 상황, 한 번쯤 겪어봤을 것이다.
코드 실력과 별개로, 글쓰기가 협업의 병목이 되는 순간이다.
팀에서 혼자 코드를 짜는 사람은 없다. 누군가는 내가 짠 코드를 6개월 뒤에 읽는다. 그 누군가가 나 자신일 때도 많다.
함수 하나에 주석 없이 복잡한 비즈니스 로직을 구겨 넣으면, 다음 사람은 코드를 해석하는 데 30분을 쓴다. 명세서나 README가 없으면 신입 온보딩에 시니어 개발자 하루가 통째로 날아간다.
글쓰기가 필요한 순간:
왜(Why) 를 남길 때즉시 실천 팁:
주석을 쓸 때 무엇(What) 이 아니라 왜(Why) 를 써라. // 리스트를 정렬한다 는 코드만 봐도 안다. // 정렬 기준을 createdAt DESC로 고정한 이유: 클라이언트 캐시 정책상 순서가 바뀌면 UX 이슈 발생 이게 진짜 주석이다.
코드 리뷰는 코드만 보는 자리가 아니다. 리뷰어는 왜 이렇게 바꿨는지, 어떤 대안을 고려했는지, 사이드 이펙트는 없는지 를 판단해야 한다. 이 정보를 PR 설명에 담지 않으면 리뷰 시간이 두 배로 늘어난다.
회고나 포스트모템도 마찬가지다. 장애가 났을 때 "서버가 다운됐고 재시작했다" 로 끝나는 보고서는 재발 방지에 아무 도움이 안 된다. 원인 분석 → 타임라인 → 재발 방지책까지 구조화된 글이 있어야 팀 전체가 학습한다.
글쓰기가 필요한 순간:
즉시 실천 팁:
PR 설명 템플릿을 만들어라. ## 변경 이유 / ## 구현 방식 / ## 테스트 방법 세 섹션만 있어도 리뷰 품질이 달라진다. 팀에 없으면 내 PR부터 먼저 적용해봐라.
이직 시장에서 포트폴리오와 깃허브는 기본이 됐다. 여기에 기술 블로그가 있으면 게임이 달라진다.
면접관은 블로그를 보고 이 사람이 어떻게 생각하는지, 문제를 어떻게 분석하는지, 기술을 얼마나 깊이 이해하는지 를 확인한다. 실제로 채용 공고에 기술 블로그 우대 항목이 늘고 있다. 스택오버플로우의 2023년 개발자 설문에서 기술 글쓰기는 커리어 성장에 중요한 역량 상위 5위 안에 들었다.
블로그는 단기 성과가 아니다. 글 한 편이 구글 검색에 올라와서 매달 수백 명에게 노출된다. 이게 누적되면 인바운드 채용 제안이나 사이드 프로젝트 기회로 연결된다.
글쓰기가 필요한 순간:
즉시 실천 팁:
처음부터 완성도 높은 글을 쓰려고 하지 마라. 오늘 겪은 에러 하나, 해결 과정, 원인을 500자로 써라. 에러 메시지 + 원인 + 해결법 구조만 갖춰도 검색 유입이 생긴다.
ChatGPT, Claude, Cursor를 쓰는 개발자는 이미 많다. 그런데 같은 도구를 써도 결과물 품질이 다르다. 차이는 프롬프트다.
"이 코드 리팩토링해줘" 와 "이 코드는 Python 3.11 기반이고, 현재 O(n²) 복잡도인데 O(n log n) 이하로 개선해줘. 외부 라이브러리는 사용하지 말고, 기존 테스트 코드는 그대로 통과해야 해" 의 결과물은 다르다.
AI에게 좋은 결과를 뽑으려면 맥락을 명확하게 전달해야 한다. 제약 조건, 목적, 형식, 예외 상황을 글로 구조화하는 능력이 곧 AI 활용 능력이다. 이건 기존 글쓰기 역량과 정확히 연결된다.
글쓰기가 필요한 순간:
즉시 실천 팁:
프롬프트를 쓸 때 역할 + 맥락 + 제약 + 출력 형식 네 가지를 넣어라. 이 구조를 파일로 저장해두고 반복 사용하면 AI 활용 생산성이 눈에 띄게 달라진다.
| 영역 | 핵심 상황 | 즉시 실천 팁 |
|---|---|---|
| 코드 주석 / 기술 문서 | 협업, 온보딩, 레거시 파악 | What 말고 Why 를 써라 |
| PR / 회고 / 포스트모템 | 코드 리뷰, 장애 대응, 스프린트 | PR 설명 3섹션 템플릿 만들기 |
| 기술 블로그 | 이직, 브랜딩, 인바운드 기회 | 트러블슈팅 500자부터 시작 |
| AI 프롬프트 | 코드 생성, 문서 작성, 자동화 | 역할+맥락+제약+형식 구조화 |
XR을 활용한 게임 개발 3기(유니티) 수강생입니다. 곧 수료 하지만 앞으로 이곳에 가끔 저의 개발 경험이 나 지식 기록할까 합니다. 더 나아가 이 사이트가 제 개인위키의 역할을 할 수 있으면 좋겠습니다. 한국 게임 시장을 흔들겠습니다

게임 광고 수익은 단순히 광고를 붙이는 것이 아니라, 여러 광고 네트워크를 경쟁시켜 가장 높은 수익을 만드는 구조입니다.

안녕하세요. 플밍 4기 입니다. 게임 개발을 배우기 전 네트워크 엔지니어 도메인에서 익히고 배웠던 네트워크 이론에 대한 기초 입니다. 학습에 도움이 되길 바라며 공유 드립니다.