Claude Code 프로젝트의 첫 단추는 MVP PRD다
n개월 동안 견적서 발행 웹을 만들었다. 이메일 자동 발송, 다양한 템플릿, 클라이언트 댓글, 승인·거절, 결제 연동까지 모두 넣었다. 클라이언트에게 보여주자 한 마디가 돌아온다. “그냥 카카오톡으로 보내는 게 편한데요.” 스타트업이 실패하는 가장 큰 이유는 시장이 원하지 않는 제품을 만들었기 때문이다. Claude…
Claude Code 훅은 LLM이 가끔 잊는 일을 결정론으로 보장한다
같은 작업을 두 번 시켰는데 결과가 다르게 나온 적이 있을 것이다. Claude에게 버그를 고쳐 달라고 했더니 어느 날은 테스트까지 돌리지만 다음 날은 코드만 수정하고 끝낸다. 이 차이는 모델의 잘못이 아니라 LLM이 본질적으로 확률 기반으로 다음 토큰을 고르기 때문이다. 그러나 실제…
서브에이전트는 메인 컨텍스트를 지키는 전문가 시스템이다
오전에는 새 기능을 만들고, 오후에는 코드 리뷰를 하고, 저녁에는 보안 점검을, 밤늦게는 테스트를 돌린다. 각각의 작업은 서로 다른 전문 지식을 요구한다. 인테리어를 한 사람이 디자인부터 전기, 타일까지 모두 맡으면 어느 하나도 제대로 끝나지 않듯, Claude Code에 모든 관점을 동시에 요구하면…
커스텀 명령어는 자주 쓰는 프롬프트를 슬래시 한 줄로 압축한다
같은 프롬프트를 매일 반복해서 붙여 넣고 있다면 그 프롬프트는 이미 자동화 대상이다. Claude Code는 반복 프롬프트를 슬래시 명령어 한 줄로 줄여 주는 커스텀 명령어 기능을 제공한다. 마크다운 파일 하나만 만들면 끝난다. 이 글에서는 커스텀 명령어의 기본 구조, 프로젝트와 사용자 단위의…
웹 에디터와 이미지 저장 위치는 서비스 출시 전에 결정한다
상용 서비스를 목표로 바이브 코딩을 진행하다 보면, 가장 가볍게 다뤄지는데 가장 큰 비용을 만드는 결정이 두 개 있다. 웹 에디터를 어떻게 만들 것인가, 그리고 게시물의 이미지·영상을 어디에 저장할 것인가다. 결론부터 말하면 세 가지를 출시 전에 결정해야 한다. 에디터 코드의 분리…
Claude Code로 PHP 프로젝트를 Java로 옮겨보았다
PHP(Laravel) 기반 레거시 API 서버를 Java(Spring Boot)로 옮기는 작업을 Claude Code와 함께 진행한 기록이다 결론부터 말하면 세 가지가 가장 큰 차이를 만들었다. 작업을 한 번에 다 맡기지 않고 단계별로 쪼갠 것, plan.md와 handoff.md를 세션 간 워킹 메모리처럼 운영한 것, PHP와 Java를 동시에…
바이브코딩 To-Do 실전
도구 역할 분담이 로컬 개발의 성패를 가른다 Claude Code는 코드 생성을, IntelliJ는 빌드·실행을, SourceTree는 버전 관리를 맡는다 설계가 끝났다면 구현은 오히려 단조롭다. 그러나 단조로운 과정에서도 실수 한 번이면 DB를 다시 만들거나 포트를 죽이러 작업 관리자에 들어가야 한다. 로컬 환경에서 To-Do…
바이브코딩 첫 프로젝트 To-Do 리스트
To-Do 하나에 웹 서비스의 뼈대·권한·세션·스키마가 모두 들어 있다 바이브코딩 강의가 예제로 To-Do 리스트를 택하는 이유는 분명하다. 기능이 단순하지만 웹 서비스가 갖춰야 할 구조가 거의 전부 담겨 있기 때문이다. 게시판, 인증, 접근 권한, 파일 저장, DB 스키마, 배포 환경 전환까지 한…
바이브코딩의 본질은 코딩이 아니라 기획이다
바이브코딩을 오해하기 쉬운 지점이 있다. AI에게 “만들어 줘”라고 던지면 알아서 서비스가 나온다고 생각하는 순간, 결과물의 완성도는 급격히 떨어진다. 진짜 바이브코딩은 코드를 찍어내는 단계가 아니라, 코드를 찍어내기 직전까지의 기획 과정에 있다. 코딩 자체는 프린터 출력에 가깝다. 인쇄할 문서를 얼마나 제대로 만들어…
Plan Mode와 plan.md 그리고 handoff.md
세 개를 구분해야 Claude Code가 제대로 돌아간다 Claude Code를 쓰다 보면 이름이 비슷한 개념들 때문에 헷갈리기 쉽다. Plan Mode와 plan.md는 다르고, plan.md와 handoff.md도 다르다. 셋의 역할을 명확히 구분하면 긴 작업도 세션이 끊겨도 흔들리지 않는다 Plan Mode – Claude의 실행 상태…