AI 코딩 에이전트가 규칙을 안 지킬 때 — 문서 말고 훅으로 막기
CLAUDE.md에 규칙을 아무리 적어도 에이전트는 가끔 어긴다. 지침을 강제 장치로 옮겨 실수 자체를 불가능하게 만든 방법을 정리했다.
개발 기록
만들면서 겪은 문제와 해결 과정
7개의 글
브라우저에서 서버랙을 3D로 조립하기 — 빌드 없는 Three.js
알루미늄 프로파일로 서버랙을 짜기 전에 웹에서 미리 조립해보는 도구를 만들었다. 빌드 도구 없이 CDN만 쓰고, 정적 서버가 공개할 파일을 화이트리스트로 제한한 이야기.
오픈소스를 fork 하지 않고 서브모듈로 관리하기 — GPU 서버 여덟 개를 굴리며
TTS, LLM, STT, OCR 서버를 한 저장소에서 관리한다. 오픈소스를 복사하거나 fork 하는 대신 서브모듈로 묶은 이유와 그 구조를 정리했다.
설치가 필요 없는 도구 만들기 — 파이썬 표준 라이브러리만으로
여러 장비에 배포할 모니터링 도구를 pip 설치 없이 만들었다. 의존성을 0개로 유지했을 때 실제로 얻은 것과 포기한 것을 정리했다.
아이가 쓸 앱에서 LLM을 실시간 호출하지 않기로 한 이유
자녀용 독서 퀴즈 앱을 만들며 내린 결정. 문장 해설을 실시간 생성 대신 미리 만들어둔 이유와 그때 얻은 것들을 정리했다.
서버 20개를 한 머신에 띄우며 정한 규칙 — 희귀 포트와 WireGuard 전용 바인딩
개인 프로젝트 서버가 늘어나면 포트가 충돌하고 0.0.0.0 바인딩이 쌓인다. 포트를 프로젝트 고정값으로 박고 wg0 에만 묶기로 한 이유를 정리했다.
터미널 창 60개를 동시에 띄우면 생기는 일 — 연결 슬롯 예산 만들기
SSH 터미널을 가상 데스크톱마다 독립 프로세스로 띄웠더니 동시 접속이 몰려 터졌다. 슬롯 예산과 프로세스 격리로 해결한 과정.