Plan mode를 활용해 코드베이스를 감사하고 오류를 체계적으로 분석하는 디버깅 프롬프트 모음입니다.
앱 디버깅하고 개선하기
버그를 잘 설명해 Lovable이 고치게 하고, Plan mode에서 근본 원인을 조사하고, 코드베이스 감사·성능 점검·신중한 변경으로 동작하는 앱을 개선하세요.
무언가 고장 나는 것은 빌드 과정의 정상적인 일부입니다. 이 가이드는 Lovable이 고칠 수 있도록 버그를 설명하는 법, 끈질긴 문제를 조사하는 법, 코드베이스 감사나 성능 점검 같은 심화 작업을 위한 준비된 프롬프트를 다룹니다.
작업 흐름을 짧게 정리하면 이렇습니다. 오류가 나타나면 Try to fix를 한두 번 써 봅니다. 그래도 문제가 남으면 재시도를 멈추고 Plan mode로 전환해 코드를 더 바꾸기 전에 근본 원인을 찾습니다. 원인을 모른 채 반복해서 고치면 진짜 문제를 가리는 코드만 쌓이기 쉽습니다.
좌절이 아니라 버그를 설명하기
Lovable은 가리킬 수 있는 것을 고칩니다. 무엇이 어디에서 고장 났는지, 무엇을 기대했고 대신 무슨 일이 일어났는지 말하세요.
두루뭉술하고 광범위한 프롬프트는 피하세요.
Nothing works, fix it!증상과 위치를 구체적으로 밝히세요.
The screen goes blank when I open the Projects page, and I can no longer make edits. Can you check what happened?Lovable에게 더 많은 단서를 주는 세 가지 방법이 있습니다.
-
스크린샷 첨부. 특히 레이아웃 문제라면 고장 난 상태의 스크린샷을 첨부하세요.
-
오류 붙여넣기. Lovable은 앱의 콘솔 로그를 스스로 읽지만, 미리보기 밖에서(예를 들어 게시된 사이트에서) 오류가 날 때는 브라우저 개발자 도구나 백엔드 로그의 정확한 오류 메시지를 붙여넣는 것이 여전히 도움이 됩니다.
My published app shows a blank screen. Here's the error from the browser console: TypeError: Q9() is undefined at https://example.lovable.app/assets/index-DWQbrtrQQj.js:435 -
시점을 가리키기. 예전에는 동작했다면 그 사실을 말하고, 무엇이 바뀌었는지 Lovable이 살펴보게 하세요.
The email notification worked yesterday and no longer sends. Review your recent changes to the notification flow, figure out which one broke it, and explain before fixing.
Plan mode에서 지속되는 문제 조사하기
고친 것이 유지되지 않거나 같은 오류가 새로운 형태로 계속 돌아온다면 근본 원인을 아직 찾지 못한 것입니다. Plan mode로 전환해 다시 빌드하기 전에 조사하세요. 효과적인 프롬프트는 다음과 같습니다.
What is the root cause of this build error? Show me the relevant code and explain what is going wrong before proposing a fix.What solutions have we already tried for this error? List them so we don't repeat ourselves.Explain in simple terms why this error occurs.This error keeps coming back. Can we take a different approach to achieve the same goal that avoids the problematic area?"이제 뭘 하지?"만 묻지 말고 "왜 이런 일이 일어났지?"를 물으세요. 빠른 수정은 뒤에 있는 로직을 다루지 않은 채 오류만 잠재울 수 있습니다.
You fixed the null pointer error by adding a check, but why was the value null in the first place? Can we address that cause?한 곳을 고쳤더니 다른 곳에서 새 문제가 생겼다면, 둘을 따로 다루지 말고 연관성을 물으세요.
We fixed the booking form, and now the schedule page is acting up. Could the fix have caused it? What do the two share?그리고 하나의 컴포넌트가 손볼 수 없을 만큼 망가졌다면 그 부분을 격리하세요. 그 컴포넌트만 새로 최소한으로 다시 만들고, 동작을 확인한 뒤 다시 통합하도록 Lovable에게 요청하세요. 한 조각을 다시 만드는 편이 과하게 망가진 것을 기우는 것보다 대개 빠릅니다.
되돌리고 다른 길로 가기
일련의 수정으로 코드가 엉켰다면, 풀어내기보다 되감기가 대개 빠릅니다. 버전 기록에서 동작하던 상태로 복원하거나, 지난 메시지를 편집하고 Revert and resend를 선택해 그 지점부터 새 방향으로 나아가세요. 되돌린 뒤에는 무엇을 했는지 Lovable에게 알려 맥락을 주세요.
I reverted the project to before the notifications feature. Let's implement it again, but in smaller steps this time.어려운 버그를 해결한 뒤에는 앞으로의 세션이 도움을 받도록 마무리를 지으세요.
Summarize what the issue was and how we fixed it, so we can add it to the project knowledge.고급 프롬프트
심화 작업을 위한 준비된 프롬프트입니다. 감사는 Plan mode에서 실행해 무언가 바뀌기 전에 분석을 먼저 받으세요.
코드베이스 감사
프로젝트가 커지면서 구조적 문제가 의심될 때 유용합니다.
Perform a comprehensive audit of the codebase and report without changing any code:
- Identify files, components, or logic that are misplaced or could be better organized.
- Check the separation of concerns (data handling vs UI vs state) and point out overly coupled sections.
- Highlight code that is overly complex or not following best practices.
- Present the findings as an ordered list of recommended steps, from most critical to optional.그다음 권장 사항을 하나씩 구현하며 미리보기에서 각각 확인할 수 있습니다.
성능 감사
앱이 동작하지만 느리게 느껴질 때 유용합니다.
The app works but feels sluggish. Analyze the project for performance bottlenecks and report without changing any code:
- Unnecessary or duplicated network and database calls.
- Components that re-render too often or do heavy work.
- Large assets or bundles that slow down loading.
- Recommend specific improvements, ordered by expected impact.민감한 변경
인증이나 결제처럼 예민한 영역을 건드리기 직전이라면, 작업과 같은 프롬프트에 안전장치를 함께 설정하세요.
The next change is in a critical part of the app, so proceed with caution. Examine all related code before making changes, avoid modifying unrelated components, and pause and explain if anything is uncertain.
Task: add Google sign-in on top of the existing email and password login, without breaking either flow.커뮤니티 디버깅 가이드북
이 가이드북은 커뮤니티 Discord에서 공유된 것으로 프로젝트 디버깅에 유용할 수 있습니다. 상황에 맞는 지침을 프롬프트에 추가하거나, 모든 요청에 적용되도록 프로젝트 knowledge에 추가하세요.
도움을 요청할 때
이 모든 방법을 써도 막힌다면, 이 문서의 어느 페이지에서든 문서 어시스턴트에게 물어보거나 Discord 커뮤니티에 자세한 내용을 가져오세요. 먼저 Lovable로 구체적인 정보(오류, 시도한 것, 언제 시작됐는지)를 모아 두면 다른 사람이 빠르게 도울 수 있습니다.