> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

> 일반적인 개발 문제를 해결하기 위한 실행 가능한 단계입니다.

## “수정 시도”에서 막혔을 때

Lumi을 사용한 빌드는 빠르고 직관적으로 설계되었지만, 다른 강력한 도구와 마찬가지로 때때로 문제가 발생할 수 있습니다. 코드가 의도한 대로 실행되지 않거나 AI가 지시를 잘못 해석하여 예기치 않은 동작이 발생할 수 있습니다.

다음은 이러한 문제를 해결하고 다시 빌드 작업을 시작하는 데 도움이 되는 단계별 가이드입니다.

<Steps>
  <Step title="'수정 시도' 버튼 먼저 사용하기">
    오류가 나타나면 가장 먼저 "수정 시도" 버튼을 클릭해야 합니다. Lumi가 로그를 분석하고 문제를 식별한 후 빠른 수정을 적용합니다. 이 방법으로 문제가 해결되지 않으면 다음 단계로 넘어갑니다.
  </Step>

  <Step title="예기치 않은 동작 진단하기">
    때로는 코드가 오류 없이 실행되지만 의도한 대로 작동하지 않을 수 있습니다. 이를 예기치 않은 동작이라고 하며 디버깅하기 까다로울 수 있습니다. 다음과 같이 접근해 보세요:

    * **프롬프트 검토:** 원래 지시 사항이 명확했는지 다시 확인하세요.
    * **문제 분리:** 개별 구성 요소와 로직을 검사하여 문제가 발생한 부분을 정확히 찾아내세요.
    * **시각적 맥락 제공:** 스크린샷이나 녹화본을 사용하여 AI에게 무엇이 작동하지 않는지 정확하게 보여주세요.
  </Step>

  <Step title="더 효과적인 프롬프트 작성하기">
    명확하고 구조화된 프롬프트는 더 나은 결과를 만들어냅니다. 최상의 결과를 위해 다음 형식을 따르세요:

    * **프로젝트 개요:** 무엇을 빌드하고 있는지 간략하게 설명하세요.
    * **페이지 구조:** 주요 페이지와 구성 요소의 목록을 작성하세요.
    * **탐색 로직:** 의도된 사용자 흐름을 설명하세요.
    * **시각 자료:** 와이어프레임이나 목업을 업로드하세요.
    * **구현 단계:** 원하는 빌드 순서의 개요를 설명하세요.
  </Step>

  <Step title="논리적인 순서로 빌드하기">
    구조화된 개발 접근 방식은 많은 일반적인 문제를 예방합니다. 다음 권장 워크플로우를 따르세요:

    1. 메인 레이아웃과 페이지를 만듭니다.
    2. 백엔드 또는 데이터베이스를 연결합니다.
    3. 사용자 인증 및 역할을 설정합니다.
    4. 각 기능의 로직을 계획합니다.
    5. Lumi에게 기능을 하나씩 구현하도록 프롬프트를 입력합니다.
  </Step>

  <Step title="안내를 위해 토론 모드 사용하기">
    막혔다고 느껴지면 토론 모드로 전환하여 도움을 받으세요:

    * Lumi에게 프로젝트의 현재 상태를 분석해달라고 요청하세요.
    * 이미 시도된 해결책의 요약을 요청하세요.
    * 지속적인 문제를 해결하기 위한 새로운 전략을 프롬프트로 요청하세요.
  </Step>

  <Step title="까다로운 버그에 고급 전술 적용하기">
    문제가 지속되면 다음과 같은 고급 기술을 시도해 보세요:

    * **구체적으로 설명하기:** 버그와 예상되는 결과를 명확하게 설명하세요.
    * **시각 자료 사용:** 스크린샷이나 화면 녹화는 복잡한 문제를 설명하는 데 매우 유용합니다.
    * **대안 요청:** "다른 방법은 없을까요?"라고 직접 물어 새로운 아이디어를 얻으세요.
    * **롤백:** 프로젝트를 이전에 작동하던 버전으로 복원하고 문제가 있는 기능을 단계별로 다시 빌드하세요.
  </Step>
</Steps>

## **일반적인 문제 해결 영역**

대부분의 문제는 다음 범주 중 하나에 속합니다:

* UI 및 레이아웃 결함
* API 또는 백엔드 오류
* 프롬프트 오해
* AI 무응답 또는 오작동
* 플랫폼 또는 통합 실패

아래 섹션을 확장하여 특정 증상을 확인하고 각각에 대한 실행 가능한 해결책을 찾아보세요.

### 일반적인 문제

<Accordion title="문제에 대한 빠른 진단을 받으려면 어떻게 해야 하나요?">
  채팅 모드로 전환하여 “무언가 제대로 작동하지 않습니다. 문제를 설명하고 이미 시도한 방법을 알려주시겠어요?”라고 질문하세요.
</Accordion>

<Accordion title="UI 또는 레이아웃 문제에 대해 어떻게 해야 하나요?">
  * 컴포넌트 계층 구조를 검사하고 적용된 스타일을 검토하세요.
  * 스크린샷을 사용하여 시각적 결함을 명확하게 보여주세요.
  * Lumi에게 직접 프롬프트를 입력하세요: “이 요소가 잘못 정렬되었습니다. 수정해 주세요.”
</Accordion>

<Accordion title="오류에 완전히 막혔다면 어떻게 해야 하나요?">
  * 이 프롬프트를 시도해 보세요: “한 걸음 물러서서 생각해 봅시다. 오류를 분석하고 대안적인 해결책을 제안해 주세요.”
  * 작업을 더 작고 관리하기 쉬운 단계로 나누세요.
  * 오류가 지속되면 되돌리기 버튼을 사용하여 작동하는 버전으로 롤백하세요.
</Accordion>

<Accordion title="‘코드 샌드박스 오류’는 무엇을 의미하나요?">
  이는 플랫폼 문제를 나타내며 발생해서는 안 됩니다. 즉시 저희 지원팀에 보고해 주세요.
</Accordion>

<Accordion title="‘미리보기를 찾을 수 없음’ 또는 ‘샌드박스 가동 중’ 메시지가 표시되면 어떻게 해야 하나요?">
  먼저 브라우저를 강력 새로고침해 보세요. 문제가 해결되지 않으면 지원팀에 문의하여 도움을 받으세요.
</Accordion>

### AI 신뢰성

<Accordion title="프롬프트 엔지니어링 시 AI의 실수를 어떻게 피할 수 있나요?">
  * 명확하고 잘 구조화된 프롬프트를 작성하세요.
  * 역 메타 프롬프팅 기술을 사용하세요.
  * 주요 변경 사항을 구현하기 전에 토론 모드에서 프롬프트를 테스트하세요.
</Accordion>

<Accordion title="AI가 응답하지 않으면 어떻게 해야 하나요?">
  이는 예기치 않은 문제입니다. 즉시 지원팀에 보고하여 도움을 받으세요.
</Accordion>

<Accordion title="지속적인 수정 오류 루프를 어떻게 끊을 수 있나요?">
  목표를 명확히 하기 위해 프롬프트를 다듬거나, AI에게 단계별 디버깅 가이드를 요청하세요.
</Accordion>

<Accordion title="리팩토링이 큰 문제를 일으키면 어떻게 해야 하나요?">
  변경 사항을 점진적으로 구현하세요. 문제가 계속되면 안정적인 버전으로 되돌리거나 토론 모드를 사용하여 디버깅하세요.
</Accordion>

<Accordion title="AI가 오류 루프에 빠지거나, 환각을 일으키거나, 깨진 로직을 사용하면 어떻게 하나요?">
  오류 루프나 결함 있는 로직을 발견하면 안정적인 버전으로 되돌리세요. 그런 다음, 시각적 편집기를 사용하거나 지식 파일을 첨부하여 다음 프롬프트에 더 구체적인 컨텍스트를 제공하세요.
</Accordion>

<Accordion title="AI가 요청한 변경 사항을 구현하지 못하면 어떻게 해야 하나요?">
  AI가 요청을 잘못 해석하거나 잘못된 파일을 대상으로 할 수 있습니다. 매우 구체적인 지침을 제공하거나 수동으로 편집하세요.
</Accordion>

<Accordion title="토론 모드나 에이전트 모드가 응답하지 않거나 불완전한 답변을 제공하면 어떻게 하나요?">
  이는 예기치 않은 문제입니다. 즉시 지원팀에 보고하여 도움을 받으세요.
</Accordion>

<Accordion title="예기치 않은 충돌, 오류 또는 루프에 대해 어떻게 해야 하나요?">
  * 정확히 동일한 프롬프트를 다시 시도하지 말고, 대신 단순화하거나 다른 말로 표현하세요.
  * AI에게 질문하세요: “우리가 이미 시도한 해결책은 무엇인가요?”
  * 프로젝트의 이전 작동 버전으로 복원하세요.
</Accordion>