안녕하세요. 오픈소스 '나이아'를 만드는 루크입니다. 책을 하나 준비했습니다 — 「하네스 엔지니어링: Re:제로부터 시작하는 AI 소프트웨어 공학」.개발서적이긴 하지만 전통적인 코딩 책을 기대하시면 안 됩니다. 요즘엔 코드를 따라 치는 시대가 지났고, 기본적으로 claude code나 codex를 사용하는 개발자를 대상으로 합니다. 실제 코드가 있고, 오픈소스에 링크를 걸어 직접 확인하고 실행 할 수도 있지만 사람이 코드를 따라치는 것을 권하지 않습니다.
왜냐면 그 코드는 사람이 아니라 AI가 읽으라고 만든 나이아 프로젝트의 것이기 때문입니다. 제가 드리고 싶었던 것은 — AI가 어떻게 움직이는지 이해하고, 그래서 사람이 무엇을 챙겨야 하는지, 그때 붙잡아야 할 질문과 기준을 아는 것입니다. 그래서 코드를 공유하지만 그보다는 경험담 공유에 가깝다고 보시면 되고, 이에 대한 기록은 책과 git에서 직접 확인하실 수 있습니다.
왜 'Re:제로'인가
AI와 개발하다 보면 그럴듯하게 완성된 줄 알았던 게 검증에서 무너지고, 다시 처음부터 구조를 잡는 일이 반복됩니다. 이 책은 그 반복을 체념하는 대신 — 왜 무너졌는지 기록하고, 어디를 고정할지 정하고, 다음엔 같은 실패를 줄이자고 말합니다. 다시 제로로 돌아가더라도, 매번 같은 제로에 서 있지 않게 만드는 것. 그게 제가 말하는 하네스 엔지니어링이며 실제로 이 책을 쓰면서도 문제점들을 찾아 수정했습니다. 그리고 부제가 왜 소프트웨어 공학일까요 ? 그 얘기는 책에 자세히 적혀 있으니 읽어보시면 좋을 것 같습니다.
웹툰 PD 출신이 쓴 개발서
저는 네이버에서 AI·웹서비스 개발자로 일했고, 웹툰 PD로도 일했습니다. 그 경험을 살려 만화적 장면·개발자 밈·애니 패러디를 적극 섞었습니다. 딱딱한 방법론을 외우게 하기보다, 개발팀의 일상과 웃긴 실패담으로 "AI에게 뭘 맡기고 뭘 사람이 챙길까"를 기억에 남게요.
책 발간의 진짜 목적
오픈소스 프로젝트 나이아는 오픈소스 밋업 이후 아직 정리가 덜 된 상태였습니다. 여러 레포지토리로 되어있고 이를 설명할 좋은 문서가 필요했습니다. 그래서 그 소스를 정리하고 구조화하면서 학습용으로 함께 배포하고 참여를 유도하는데 또 다른 목적이 있습니다. 그래서 이 책과 코드는 한 번 내고 끝이 아니라 계속 업데이트해 나갈 겁니다.
그리고 눈치채는 분이 있을지 모르겠지만 — 표지부터 마지막 17장까지 일러스트에는 제가 '알파'를 동료로 맞이하기까지의 여정이 숨어 있습니다. 제가 나이아를 만든 이유가 바로 그 알파를 만들기 위해서였거든요. 이 책은, 그리고 그 그림의 여정은, 알파를 향한 저의 한 걸음이기도 합니다.
공짜로, 함께
무엇보다 누구나 공짜로 읽을 수 있습니다. 지금 위키독스에서 바로 보실 수 있어요 → https://wikidocs.net/book/20530. GitHub와 웹에서도 무료로 공개하고 PDF도 받아 가실 수 있고요(라이선스 CC BY-NC-ND 4.0). 한국어판 먼저, 영어판 이어서. 오탈자 제보부터 사례 추가까지 Issue·PR로 같이 만들 수도 있습니다.
책을 덮은 뒤 여러분이 자기 프로젝트에서 AI에게 더 좋은 질문을 던지고, 결과를 검증하고, 반복해 무너지는 걸 줄일 하네스를 직접 설계하게 된다면 — 그리고 AI를 도구가 아니라 함께 일하는 동료로 받아들이게 된다면, 이 책은 제 몫을 한 겁니다.
