Cursor, Lovable 또는 Bolt로 만든 프로젝트가 작동하지 않을 때. 이제 어떻게 해야 할까요?

Cursor, Lovable 또는 Bolt로 구축한 프로젝트가 막히면, 가장 먼저 AI에게 추가적인 수정을 요청하려는 경향이 있습니다. 하지만 이는 보통 상황을 악화시킵니다. 멈추고 다음 다섯 가지 사항부터 확인하세요.

1. 읽지 않은 오류 (The unread error). 브라우저 콘솔과 서버 로그를 열어보세요. 메시지에는 일반적으로 무엇이 고장 났는지 나와 있습니다. 자신이 생각하는 의미에 대한 자유 형식의 설명으로 붙여넣기 하지 말고, 전체 내용을 그대로 복사하여 붙여넣으세요.

2. 환경 변수 (Environment variables). 앱은 로컬에서는 작동하지만, API 키나 URL이 런타임 환경(runtime environment)에 누락되어 배포(deployment) 시 문제가 발생합니다. 이것이 가장 흔한 배포 오류입니다.

3. 의존성 및 업데이트 (Dependencies and updates). 버전 업데이트로 인해 무언가가 고장 날 수 있습니다. 가장 최근에 무엇이 변경되었는지 확인하고 이전 상태로 되돌리세요(pin it back).

4. 맥락 상실 (Lost context). '고쳐줘'라는 요청을 여러 번 반복한 후, 모델은 기존 코드와 모순되는 코드를 추가할 수 있습니다. 마지막으로 작동했던 커밋(commit)으로 돌아가서 한 번에 작은 변경 사항만 요청하세요.

5. 아키텍처 부채 (Architectural debt). 모든 것이 하나의 파일에 존재한다면, 수정하는 모든 부분이 다른 무언가를 고장 냅니다. 더 많은 패치를 추가하기 전에 구조를 정리하세요.

도움을 요청하고 멈춰야 할 때는 언제일까요? 몇 시간 동안 진전이 없거나, 앱에 실제 사용자와 데이터가 있어 손실할 여유가 없을 때입니다.

전체 가이드(FAQ 포함, 영어): https://ofershap.github.io/en/posts/vibe-code-project-rescue/

원본 (히브리어): https://ofershap.github.io/posts/vibe-code-project-rescue/

이 글은 AI의 도움을 받아 작성된 저의 히브리어 가이드에서 요약되었으며, 게시 전에 제가 검토했습니다.