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

# 첫 번째 프로젝트 만들기

> SoloEnt에서 새로운 집필 프로젝트 설정하기

SoloEnt에서 각 작품은 로컬 컴퓨터에 폴더로 저장되는 독립적인 프로젝트입니다.

<Info>
  Agent가 필요에 따라 프로젝트 폴더 내에서 파일을 자동으로 생성하고 정리합니다.
</Info>

## 새 프로젝트 만들기

<Steps>
  <Step title="위치 선택">
    프로젝트를 생성할 상위 폴더를 선택합니다.
  </Step>

  <Step title="새 폴더 만들기">
    **새 폴더**를 클릭하고 프로젝트 이름을 지정합니다.
  </Step>

  <Step title="SoloEnt에서 열기">
    SoloEnt가 자동으로 새 프로젝트 폴더를 엽니다.
  </Step>
</Steps>

## 기존 프로젝트 열기

<Steps>
  <Step title="열기 클릭">
    SoloEnt에서 **폴더 열기**를 선택합니다.
  </Step>

  <Step title="프로젝트로 이동">
    프로젝트 폴더 위치를 찾아갑니다.
  </Step>

  <Step title="폴더 선택">
    프로젝트 폴더를 선택하고 **열기**를 클릭합니다.
  </Step>
</Steps>

<Warning>
  항상 개별 파일이 아닌 **프로젝트 폴더**를 여십시오. 이렇게 하면 Agent가 전체 프로젝트 구조를 관리할 수 있습니다.
</Warning>

## 폴더 권한

<Accordion title="SoloEnt에서 폴더 접근이 필요한 이유는?" icon="lock">
  **처음 접근 시:**

  * 시스템에서 보안을 위해 비밀번호를 요청할 수 있습니다
  * 이를 통해 SoloEnt에 파일 읽기 및 쓰기 권한이 부여됩니다

  **보안:**

  * 권한은 여는 특정 폴더로 제한됩니다
  * SoloEnt는 시스템의 다른 부분에 접근할 수 없습니다
  * 시스템 설정에서 언제든지 권한을 취소할 수 있습니다
</Accordion>

## 프로젝트 정리 팁

<CardGroup cols={2}>
  <Card title="폴더당 하나의 프로젝트" icon="folder">
    각 작품을 전용 폴더에 보관하세요
  </Card>

  <Card title="설명적인 이름 사용" icon="tag">
    명확한 프로젝트 이름을 사용하세요 (예: "SF-소설-2026")
  </Card>

  <Card title="버전 관리 사용" icon="code-branch">
    Timeline으로 버전 기록을 추적하세요
  </Card>

  <Card title="특수 문자 피하기" icon="circle-exclamation">
    문자, 숫자, 하이픈, 밑줄만 사용하세요
  </Card>
</CardGroup>

## 열기 후 무슨 일이 일어나나요?

프로젝트 폴더를 열면:

1. **파일 관리자 표시**: 왼쪽 패널에 프로젝트 구조가 표시됩니다
2. **Agent 활성화**: 집필 작업을 도울 준비가 됩니다
3. **에디터 준비**: 파일 생성 또는 편집을 시작합니다
4. **시작할 준비 완료**: 창작 여정을 시작합니다

## 첫 번째 집필 세션 시작하기

<Steps>
  <Step title="Agent에게 아이디어 말하기">
    Agent 채팅에서 작성하고 싶은 내용을 설명합니다.

    예: "젊은 마법사에 대한 판타지 소설을 쓰고 싶어"
  </Step>

  <Step title="Agent가 구조 설정하게 하기">
    Agent가 필요한 폴더와 초기 파일을 생성합니다.
  </Step>

  <Step title="집필 시작">
    아웃라인, 캐릭터, 또는 첫 번째 챕터 작업을 시작합니다.
  </Step>
</Steps>

## 문제 해결

<AccordionGroup>
  <Accordion title="폴더를 열 수 없음">
    * 폴더 권한 확인
    * 폴더가 존재하고 경로가 올바른지 확인
    * 대신 새 폴더 만들기 시도
    * SoloEnt 재시작 후 다시 시도
  </Accordion>

  <Accordion title="권한 거부됨">
    * 메시지가 표시되면 시스템 비밀번호 입력
    * 시스템 보안 설정 확인
    * 다른 폴더 위치 시도
    * 적절한 권한으로 SoloEnt 실행
  </Accordion>

  <Accordion title="파일이 표시되지 않음">
    * 파일이 아닌 폴더를 열었는지 확인
    * 폴더에 호환되는 파일이 있는지 확인
    * 파일 관리자 새로고침
    * SoloEnt 재시작
  </Accordion>
</AccordionGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="Plan Mode" icon="lightbulb" href="../essentials/plan-mode">
    Agent로 전략적 계획 배우기
  </Card>

  <Card title="에디터 기능" icon="pen-to-square" href="../essentials/editor">
    집필 에디터 마스터하기
  </Card>

  <Card title="Agent 명령어" icon="terminal" href="../essentials/commands">
    강력한 집필 명령어 사용하기
  </Card>

  <Card title="방법론" icon="book-open" href="../essentials/methodology">
    SoloEnt의 집필 접근법 이해하기
  </Card>
</CardGroup>
