개발 가이드
설정 오류, 데이터 형식, 도구 사용법을 실제 실행해 확인한 결과와 함께 정리하는 개발 가이드입니다.
글 5개
개발 가이드
AI tool schema는 계약서다 — 계약이 어긋나는 3가지 방식
LLM function calling의 tool 정의는 모델과 코드 사이의 계약입니다. 계약서 자체가 거부되는 타입 오타, 스키마로는 유효한데 영원히 이행 불가능한 required 오타, 모델이 추측하게 만드는 애매한 정의 — 실제 JSON Schema 검증기로 재현하며 정리합니다.
자세히 보기 →
개발 가이드
.env 파일에서 헷갈리는 것들, 직접 실행해서 확인한 답 7가지
.env 값에 공백·따옴표·#이 있으면 어떻게 되는지, 같은 키를 두 번 쓰면 어느 값이 이기는지 — Node.js --env-file과 dotenv로 직접 실행해 확인한 결과를 Q&A로 정리합니다. 같은 파일을 파서마다 다르게 읽는 사례도 있습니다.
개발 가이드
MCP 서버 연결이 안 될 때 확인 순서 5단계
MCP 서버를 설정했는데 연결되지 않을 때 원인을 좁히는 확인 순서를 정리합니다. JSON 문법 오류, spawn ENOENT, Windows에서 npx가 실패하는 이유까지 실제 재현한 출력과 함께 설명합니다.
개발 가이드
package.json exports에서 자주 하는 실수 6가지
package.json에 exports를 추가했더니 기존 import가 깨지는 이유부터 ERR_PACKAGE_PATH_NOT_EXPORTED 에러 읽는 법까지, Node.js exports 필드에서 자주 하는 실수 6가지와 확인 방법을 정리합니다.
개발 가이드
멀쩡해 보이는 CSV가 깨지는 이유 — 재현으로 확인한 사례 4가지
열이 한 칸 밀리거나, 여러 행이 통째로 사라지거나, 한글이 외계어가 되는 CSV 문제를 실제 파서로 재현해 원인별로 분석합니다. 값 속 쉼표, 닫히지 않은 따옴표, 따옴표 안 줄바꿈, 인코딩 불일치 네 가지 사례입니다.