# 세컨드브레인 구축 파일

이 파일은 코딩을 배우기 위한 교재가 아닙니다. 코덱스나 클로드 코드가 당신의 세컨드브레인을 직접 만들 수 있도록 정리한 작업 지시서입니다.

## 이 파일을 사용하는 방법

### 1. 내려받은 파일을 찾습니다

전자책 페이지(https://www.makingsoulstudio.com/ebook/)에서 무료로 내려받은 `세컨드브레인구축.md`를 찾습니다. 보통 Windows의 `다운로드` 폴더에 있습니다.

`.md`는 메모장으로도 열 수 있는 글 파일입니다. 별도의 프로그램을 설치해 내용을 열어볼 필요는 없습니다. 파일 이름이 `세컨드브레인구축.md.txt`로 보인다면 끝의 `.txt`를 지워 `세컨드브레인구축.md`로 바꿉니다. 파일 이름 뒤의 글자가 보이지 않는다면 파일 탐색기 위쪽의 `보기`에서 `표시`와 `파일 확장명`을 차례로 눌러 확장명을 보이게 합니다.

### 2. 책에서 만든 작업 폴더를 엽니다

작업 폴더는 AI가 파일을 읽고 결과물을 만들어둘 공간입니다. 책의 홈페이지 실습을 따라왔다면 바탕화면의 `첫작품` 폴더를 그대로 사용합니다. 새 폴더를 만들거나 기존 홈페이지 파일을 옮길 필요는 없습니다.

아직 작업 폴더가 없는 경우에만 다음 순서로 만듭니다. 이미 다른 이름의 프로젝트 폴더를 쓰고 있다면 그 폴더를 그대로 선택하고, 아래 `첫작품`은 자신의 폴더 이름으로 읽으면 됩니다.

1. Windows에서 `바탕화면` 폴더를 엽니다.
2. 빈 곳을 마우스 오른쪽 버튼으로 누릅니다.
3. `새로 만들기`에서 `폴더`를 누릅니다.
4. 폴더 이름을 `첫작품`이라고 적습니다.

앞에서 찾은 `세컨드브레인구축.md`를 이 폴더 안으로 복사합니다. 파일을 한 번 누르고 `Ctrl+C`를 누른 뒤, `첫작품` 폴더를 열어 `Ctrl+V`를 누르면 됩니다.

폴더 안에 아래 파일이 보이면 준비가 끝난 것입니다. 기존 홈페이지 파일은 그대로 둡니다.

```text
첫작품/
└─ 세컨드브레인구축.md
```

### 3. 코덱스에서 실행하는 방법

코덱스를 사용한다면 다음 순서대로 진행합니다.

1. ChatGPT 데스크톱 앱을 열고 로그인합니다.
2. 새 작업을 시작할 때 `Codex`를 선택합니다.
3. `새 프로젝트 추가`, `폴더 열기`와 같은 버튼을 누릅니다. Windows에서는 `Ctrl+O`를 눌러 폴더 선택 창을 열 수도 있습니다.
4. 앞에서 확인한 `바탕화면` 안의 `첫작품` 폴더를 선택합니다.
5. 실행 위치를 고르는 항목이 보이면 내 컴퓨터의 폴더를 직접 사용하는 `Local`을 선택합니다.
6. 새 대화를 열고 아래 문장을 그대로 보냅니다.

> "`세컨드브레인구축.md`를 처음부터 끝까지 읽고, 지금 열어 둔 작업 폴더를 첫 프로젝트로 삼아 내 세컨드브레인을 구축해줘. 기존 파일은 덮어쓰거나 삭제하지 말고, 꼭 필요한 내용만 쉬운 말로 물어본 뒤 실제 파일 생성과 검증까지 해줘."

파일을 더 분명하게 지정하고 싶다면 메시지를 보내기 전에 입력창에서 `@`를 누르고 `세컨드브레인구축.md`를 선택합니다. 파일이 이미 선택한 작업 폴더 안에 있다면 이름만 적어도 코덱스가 찾을 수 있습니다.

파일을 만들거나 수정해도 되는지 묻는 창이 나오면, 선택한 `첫작품` 폴더와 세컨드브레인 폴더 안의 작업인지 확인하고 허용합니다.

### 4. 클로드 코드 데스크톱에서 실행하는 방법

클로드 코드 데스크톱을 사용한다면 다음 순서대로 진행합니다.

1. Claude 데스크톱 앱을 열고 로그인합니다.
2. 위쪽에서 일반 대화용 `Chat`이 아니라 파일 작업을 할 수 있는 `Code` 탭을 누릅니다.
3. 실행 환경은 `Local`을 선택합니다.
4. `Select folder`를 누르고 `바탕화면` 안의 `첫작품` 폴더를 선택합니다.
5. 새 대화에 위의 구축 요청 문장을 그대로 보내고, 선택한 폴더 안에 파일을 만들어도 되는지 물으면 허용합니다.

### 5. 명령어로 쓰는 클로드 코드에서 실행하는 방법

이미 명령어 방식의 클로드 코드를 설치해 사용하고 있다면 다음처럼 실행할 수도 있습니다. 처음 사용하는 사람은 앞의 데스크톱 방식이 더 쉽습니다.

1. 파일 탐색기에서 `첫작품` 폴더를 엽니다.
2. 창 위쪽의 주소가 적힌 칸을 한 번 누릅니다.
3. 그 자리에 `powershell`이라고 입력하고 Enter를 누릅니다.
4. 파란색 또는 검은색 창이 열리면 `claude`라고 입력하고 Enter를 누릅니다.
5. 클로드 코드가 열리면 위의 구축 요청 문장을 그대로 붙여넣고 Enter를 누릅니다.

### 6. AI가 질문하면 이렇게 답합니다

처음에는 AI가 세컨드브레인을 어디에 만들지, 프로젝트 이름은 무엇인지, 지금 가장 먼저 할 일은 무엇인지 물을 수 있습니다. 어려운 형식에 맞출 필요 없이 평소 말하듯 답하면 됩니다.

> "위치는 네가 추천하는 곳으로 해줘. 프로젝트 이름은 첫작품이야. 지금은 세컨드브레인을 제대로 만드는 것부터 하고 싶어."

설명에 모르는 말이 나오면 그대로 다시 물어봅니다.

> "그 말이 무슨 뜻인지 모르겠어. 컴퓨터를 잘 모르는 사람도 따라 할 수 있게 지금 내가 눌러야 할 것만 알려줘."

AI가 작업을 마쳤다고 하면 아래 문장을 보냅니다.

> "방금 만든 파일들이 실제로 있는지 확인하고, 빠진 것이 있으면 고쳐줘. 마지막에는 내가 다음 새 대화에서 보낼 확인 문장도 다시 알려줘."

### 파일을 찾지 못했다고 할 때

AI가 `세컨드브레인구축.md`를 찾을 수 없다고 하면 다음 세 가지만 확인합니다.

- 코덱스나 클로드 코드에서 선택한 폴더가 `첫작품`이 맞는가.
- 파일 이름이 `세컨드브레인구축.md.txt`로 바뀌지 않았는가.

세 가지가 모두 맞다면 새 대화에 아래처럼 요청합니다.

> "현재 작업 폴더에서 `세컨드브레인구축.md`를 찾아서 읽어줘. 찾았다면 이 파일의 첫 번째 제목을 말해준 뒤 구축을 시작해줘."

처음에는 세컨드브레인을 둘 위치와 첫 프로젝트 이름 정도만 정하면 됩니다. 나머지 폴더와 문서는 AI가 이 지시서에 따라 만듭니다.

---

# AI 작업 지시서

## 당신이 맡은 일

당신은 사용자가 여러 번의 대화와 작업을 거쳐도 중요한 맥락을 잃지 않도록 개인용 세컨드브레인을 구축한다. 세컨드브레인은 대화를 전부 쌓아두는 창고가 아니라, 현재 상태와 확정된 결정, 그 결정의 근거와 다음 행동을 다시 찾을 수 있게 연결한 Markdown 문서 체계다.

설명이나 예시만 제시하고 끝내지 말고, 사용자가 선택한 위치에 실제 폴더와 파일을 만든 뒤 검증까지 완료한다.

## 완성 기준

구축이 끝나면 다음 조건을 모두 만족해야 한다.

- 전체 프로젝트를 찾는 입구인 `SecondBrain.md`가 있다.
- 첫 프로젝트에 `현재상태.md`, `10_대단원`, `20_기록`, `30_결정`, `99_보관`이 있다.
- `99_시스템`에 운영 규칙과 재사용할 템플릿이 있다.
- 코덱스는 `AGENTS.md`, 클로드 코드는 `CLAUDE.md`를 통해 작업 시작 시 세컨드브레인을 읽도록 연결되어 있다.
- 확인된 사실과 아직 확인하지 못한 내용이 구분되어 있다.
- 기존 파일은 삭제하거나 통째로 덮어쓰지 않는다.
- 비밀번호, API 키, 세션 토큰 같은 비밀은 세컨드브레인에 기록하지 않는다.
- 사용자가 새 대화에서 현재 상태와 다음 행동을 다시 물어볼 수 있다.

## 먼저 확인할 것

현재 작업 폴더와 기존 파일을 먼저 살펴본다. 이미 세컨드브레인이나 비슷한 문서가 있다면 새 구조를 겹쳐 만들지 말고, 기존 구조와 내용을 보존한 상태에서 이 지시서의 핵심 원칙을 합친다.

아래 정보가 파일과 대화만으로 분명하지 않을 때만 질문한다.

1. 세컨드브레인을 만들 위치
2. 첫 프로젝트의 표시 이름
3. 지금 가장 먼저 이어가야 할 일 한 가지

한 번에 이해하기 쉬운 말로 묻고, 이미 알 수 있는 내용을 다시 묻지 않는다. 사용자가 위치를 따로 정하지 않으면 바탕화면에 `SecondBrain` 폴더를 새로 만들어 사용한다. **작업 폴더 안에는 만들지 않는다.** 세컨드브레인은 프로젝트가 늘어나도 모든 프로젝트를 가리키는 하나의 입구여야 하는데, 특정 작업 폴더 안에 두면 그 폴더에 갇히고 경로에 같은 이름이 두 번 나온다. 프로젝트 이름은 현재 작업 폴더의 이름을 기본값으로 사용한다.

## 만들 구조

`<세컨드브레인>`은 사용자가 고른 세컨드브레인 폴더이고, `<첫프로젝트>`는 사용자가 정한 프로젝트 이름이다. 실제 파일을 만들 때 꺾쇠가 붙은 임시 표시는 모두 실제 이름과 날짜로 바꾼다.

```text
<세컨드브레인>/
├─ SecondBrain.md
├─ 10_프로젝트/
│  └─ <첫프로젝트>/
│     ├─ 현재상태.md
│     ├─ 10_대단원/
│     │  └─ 프로젝트개요.md
│     ├─ 20_기록/
│     │  └─ <올해>/
│     ├─ 30_결정/
│     └─ 99_보관/
└─ 99_시스템/
   ├─ 구조와_운영규칙.md
   └─ 템플릿/
      ├─ 현재상태_템플릿.md
      ├─ 대단원_템플릿.md
      ├─ 결정_템플릿.md
      ├─ 기록_템플릿.md
      └─ 작업로그_템플릿.md
```

폴더 이름 앞의 숫자는 중요도 순위가 아니라 역할별 문서를 일정한 순서로 보이게 하는 번호다.

세컨드브레인 폴더는 실제 작업 폴더와 나란히 두고 그 안에 넣지 않는다. `10_프로젝트/<첫프로젝트>/`는 그 프로젝트를 설명하는 문서가 있는 곳이고, 실제 코드와 결과물은 원래 작업 폴더에 그대로 남는다. 두 위치의 연결은 `현재상태.md`의 `진실의 위치`에 적는다.

## 다섯 층의 역할

세컨드브레인의 정보는 아래 순서로 흐른다.

1. **원문**  
   사용자가 준 문서, 실제 작업 파일, 대화 원문처럼 사실을 확인할 수 있는 자료다. 원문은 원래 위치에 보존하며, 세컨드브레인 안으로 무조건 복사하거나 고치지 않는다.

2. **기록**  
   작업 중 벌어진 일과 사용자 요구를 날짜별로 남기는 층이다. `20_기록/<연도>`에 둔다. 원문 전체를 복제하기보다 중요한 사실, 결과, 확인할 점, 원문의 위치를 남긴다.

3. **결정**  
   여러 선택지 중 무엇을 사용하기로 했는지와 그 이유를 남기는 층이다. `30_결정`에 둔다. 이전 결정을 바꾸더라도 과거 문서를 삭제하지 않고 새 결정이 무엇을 대신하는지 연결한다.

4. **대단원**  
   프로젝트의 한 기능이나 분야가 현재 어떻게 구성되어 있는지 정리하는 층이다. `10_대단원`에 둔다. 시간순 일기가 아니라 지금의 설계와 구현 상태를 보여준다.

5. **라우터**  
   `SecondBrain.md`와 각 프로젝트의 `현재상태.md`다. 모든 세부 내용을 복사해 넣는 곳이 아니라, 지금 무엇을 하고 있으며 자세한 내용은 어디에서 읽어야 하는지 알려주는 짧은 입구다.

한 사실이나 결정의 자세한 내용은 한 곳에만 둔다. 위쪽 문서는 그 내용을 짧게 요약하고 정본 문서로 연결한다.

## `SecondBrain.md` 만들기

다음 형식을 바탕으로 전체 입구를 만든다. 첫 프로젝트의 실제 작업 폴더와 `현재상태.md` 위치를 정확히 적는다.

```markdown
---
kind: project-registry
updated: "<YYYY-MM-DD>"
---

# Second Brain

## 읽는 순서

- 새 작업을 시작하면 이 문서를 먼저 읽는다.
- 이어서 작업할 프로젝트의 `현재상태.md`를 읽는다.
- 필요한 경우에만 연결된 대단원, 결정, 최근 기록을 읽는다.

## 프로젝트 목록

| 프로젝트 | 실제 작업 폴더 | 한 줄 설명 | 현재상태 |
|---|---|---|---|
| <첫프로젝트> | `<실제 작업 폴더>` | <확인된 목적 또는 확인 필요> | [열기](10_프로젝트/<첫프로젝트>/현재상태.md) |

## 공통 운영 규칙

- 확인하지 않은 내용을 완료나 확정으로 쓰지 않는다.
- 자세한 정보는 기록, 결정, 대단원 중 알맞은 한 곳에만 쓴다.
- 기존 자료는 함부로 삭제하지 않고 필요하면 `99_보관`으로 옮긴다.
- 비밀번호, API 키, 세션 토큰, 인증 파일의 내용은 기록하지 않는다.

## 진실의 위치

- 전체 운영 규칙: [구조와 운영 규칙](99_시스템/구조와_운영규칙.md)
- 문서 양식: [템플릿](99_시스템/템플릿/)
```

## 프로젝트 `현재상태.md` 만들기

아래 내용을 `99_시스템/템플릿/현재상태_템플릿.md`에 저장하고, 같은 형식으로 첫 프로젝트의 `현재상태.md`를 채운다.

```markdown
---
kind: project-router
project: "{{프로젝트명}}"
updated: "{{YYYY-MM-DD}}"
---

# {{프로젝트명}} 현재상태

## 현재 초점

- 지금 이루려는 결과:
- 현재 단계:
- 이번 작업의 범위:

## 기능·분야 색인

| 기능·분야 | 현재 상태 | 이 작업을 할 때 읽을 문서 |
|---|---|---|
| 프로젝트 개요 | {{확인된 상태 또는 확인 필요}} | [프로젝트 개요](10_대단원/프로젝트개요.md) |

## 즉시 적용 규칙

- {{사용자가 확정한 규칙만 기록한다. 없으면 `아직 없음`이라고 쓴다.}}

## 막힘·다음 행동

- 막힘:
- 다음 한 가지 행동:

## 진실의 위치

- 실제 작업 폴더:
- 핵심 결과물:
- 현재 판단의 근거 문서:
```

`현재상태.md`는 일기처럼 길어지지 않게 유지한다. 권장 분량은 약 3,500자 이하이며, 세부 경위는 연결된 기록이나 결정 문서로 옮긴다.

## `프로젝트개요.md`와 대단원 템플릿 만들기

아래 내용을 `99_시스템/템플릿/대단원_템플릿.md`에 저장한다. 첫 프로젝트의 `10_대단원/프로젝트개요.md`도 이 형식으로 만들되, 파일에서 확인했거나 사용자가 말한 사실만 채운다.

```markdown
---
kind: chapter
project: "{{프로젝트명}}"
chapter: "{{분야명}}"
updated: "{{YYYY-MM-DD}}"
---

# {{분야명}}

## 목적

- 이 분야가 해결하려는 문제:
- 원하는 결과:

## 현행 결정

- 현재 적용 중인 결정:
- 자세한 결정 문서:

## 구현 상태

- 확인된 완료:
- 진행 중:
- 아직 확인하지 못한 것:

## 사용자 문제 제기·품질 기준

- 사용자가 중요하게 여기는 점:
- 피해야 할 결과:

## 영향 경로

- 관련 작업 파일:
- 이 내용이 바뀌면 함께 확인할 곳:

## 다음 작업

- 다음 한 가지 행동:

## 연결

- 관련 기록:
- 관련 결정:
```

## 결정 템플릿 만들기

아래 내용을 `99_시스템/템플릿/결정_템플릿.md`에 저장한다.

```markdown
---
kind: decision
project: "{{프로젝트명}}"
decision_id: "{{YYYYMMDD-짧은이름}}"
status: current
chapters: []
affected_paths: []
supersedes: []
---

# {{결정 제목}}

## 확정 내용

- 무엇을 하기로 했는가:
- 적용 범위:

## 이유

- 이 선택을 한 이유:
- 비교하거나 버린 선택지:

## 영향

- 바뀌는 문서나 작업:
- 함께 확인할 부분:

## 승인 근거

- 사용자가 확정한 말이나 확인된 근거:
- 날짜:
```

결정이 바뀌면 이전 파일을 지우지 않는다. 새 결정의 `supersedes`에 이전 결정 ID를 적고, 이전 결정의 `status`를 `superseded`로 바꾼다.

## 기록 템플릿 만들기

아래 내용을 `99_시스템/템플릿/기록_템플릿.md`에 저장한다.

```markdown
---
kind: processed-record
project: "{{프로젝트명}}"
source: "{{원문이나 작업 위치}}"
date: "{{YYYY-MM-DD}}"
record_types: []
chapters: []
tags: []
affected_paths: []
status: captured
---

# {{기록 제목}}

## 요약

- 이번 기록에서 꼭 남길 사실:

## 사용자 문제 제기

- 사용자가 원한 것:
- 사용자가 원하지 않은 것:

## 영향 경로

- 확인하거나 바뀐 작업 파일:

## 산출물

- 만들어지거나 수정된 결과:
- 검증 결과:

## 관련 노트

- 관련 대단원:
- 관련 결정:

## 확인 필요

- 아직 사실로 확인하지 못한 내용:

## 원문

- 원문 또는 근거의 위치:
```

모든 대화를 기록으로 만들지 않는다. 나중에 작업을 이어갈 때 없으면 다시 판단해야 하는 사실, 사용자 요구, 결과, 실패 원인만 남긴다.

## 작업로그 템플릿 만들기

아래 내용을 `99_시스템/템플릿/작업로그_템플릿.md`에 저장한다. 작업이 길어지거나 대화를 잠시 끝낼 때 `20_기록/<연도>`에 이 형식의 로그를 남긴다.

```markdown
---
kind: work-log
project: "{{프로젝트명}}"
date: "{{YYYY-MM-DD}}"
status: active
---

# {{작업 제목}} 작업로그

## 하고 있는 일

-

## 확인된 완료

-

## 미완료

-

## 막힘

-

## 다음 한 가지 행동

-
```

실제로 확인하지 않은 작업은 `확인된 완료`에 넣지 않는다.

## `구조와_운영규칙.md` 만들기

다음 원칙을 읽기 쉬운 문장으로 정리해 `99_시스템/구조와_운영규칙.md`에 저장한다.

### 작업을 시작할 때

1. `SecondBrain.md`를 읽는다.
2. 대상 프로젝트의 `현재상태.md`를 읽는다.
3. 이번 작업과 관련된 대단원과 현재 결정만 읽는다.
4. 작업이 이어지는 중이면 가장 최근의 관련 기록을 읽는다.

### 작업 중에

- 기존 기능을 바꾸기 전에 현재 상태와 사용자의 확정 규칙을 확인한다.
- 파일에서 직접 확인한 사실, 실행해 검증한 결과, 사용자가 확정한 내용을 구분한다.
- 긴 작업에서는 하고 있는 일, 완료, 미완료, 막힘, 다음 행동을 작업로그에 남긴다.
- 같은 사실의 자세한 설명을 여러 문서에 복사하지 않는다.

### 작업을 마칠 때

정보는 아래 순서로 반영한다.

1. 원문과 실제 작업 파일을 보존한다.
2. 나중에 필요한 과정과 결과를 `20_기록`에 남긴다.
3. 선택이 확정되었으면 `30_결정`을 갱신한다.
4. 기능의 현재 모습이 바뀌었으면 `10_대단원`을 갱신한다.
5. 지금의 초점이나 다음 행동이 바뀌었으면 프로젝트 `현재상태.md`를 갱신한다.
6. 프로젝트가 추가되거나 이름·위치가 바뀌었을 때만 `SecondBrain.md`를 갱신한다.

### 보존과 보안

- 구조를 정리할 때 기존 문서를 바로 삭제하지 않는다. 더 이상 현재 문서가 아니면 연결을 남기고 `99_보관`으로 옮긴다.
- `.env`, 인증서, 비밀번호 보관소, API 키, 세션 토큰을 읽거나 요약 대상으로 삼지 않는다.
- 비밀을 우연히 보더라도 세컨드브레인에 복사하지 않는다.
- 개인정보는 작업에 꼭 필요한 최소한만 기록한다.
- 확인하지 못한 정보는 `확인 필요`로 표시한다.

## 코덱스와 클로드 코드에 시작 규칙 연결하기

사용 중인 도구에 맞춰 첫 프로젝트의 실제 작업 폴더에 시작 지시 파일을 만든다.

- 코덱스를 사용 중이면 `AGENTS.md`
- 클로드 코드를 사용 중이면 `CLAUDE.md`
- 두 도구를 모두 사용할 예정이라고 사용자가 말했으면 두 파일 모두

세컨드브레인 폴더 자체에도 같은 도구의 시작 지시 파일을 둔다. 이미 파일이 있으면 내용을 삭제하거나 통째로 바꾸지 않는다. 원본을 보존한 뒤 아래 표시 사이의 블록만 한 번 추가하거나 갱신한다.

```markdown
<!-- SECOND_BRAIN_RULES_START -->
## Second Brain 사용 규칙

- 새 작업을 시작할 때 `<세컨드브레인의 실제 경로>/SecondBrain.md`를 먼저 읽는다.
- 이어서 이 작업 폴더와 연결된 프로젝트의 `현재상태.md`를 읽는다.
- 필요한 대단원, 현재 결정, 최근 관련 기록만 추가로 읽는다.
- 확인하지 않은 내용을 완료나 확정으로 기록하지 않는다.
- 의미 있는 변경 뒤에는 기록 → 결정·대단원 → 현재상태 순서로 필요한 문서만 갱신한다.
- 기존 문서는 함부로 삭제하지 않고, 비밀번호·API 키·세션 토큰은 기록하지 않는다.
<!-- SECOND_BRAIN_RULES_END -->
```

`<세컨드브레인의 실제 경로>`는 설치한 컴퓨터의 실제 경로로 바꾼다. 프로젝트가 세컨드브레인 폴더 밖에 있다면 시작 지시 파일의 링크가 그 위치에서도 올바르게 작동하는지 확인한다.

사용자가 모든 미래 프로젝트에 이 규칙을 자동으로 적용해달라고 명시한 경우에만 도구의 사용자 전역 지시 파일에도 같은 규칙을 연결한다. 전역 파일을 바꾸기 전에는 기존 규칙과 충돌하는지 확인하고 원본을 보존한다.

## 첫 내용을 채우는 법

빈 양식만 만든 뒤 끝내지 않는다.

1. 현재 작업 폴더에서 README, 기획 문서, 주요 결과물처럼 프로젝트 목적을 알려주는 자료를 찾는다.
2. 사용자가 이번 대화에서 말한 목표와 다음 행동을 확인한다.
3. 근거가 있는 내용으로 `프로젝트개요.md`와 `현재상태.md`를 채운다.
4. 판단할 근거가 없으면 추측하지 말고 `확인 필요`라고 쓴다.
5. 구축 당일의 기록을 `20_기록/<연도>/<YYYYMMDD>-세컨드브레인-초기구축.md`에 남긴다.
6. 사용자가 이 구조를 쓰기로 확정한 사실을 `30_결정/<YYYYMMDD>-세컨드브레인-운영방식.md`에 남긴다.

현재상태에 과거의 모든 일을 옮기지 않는다. 지금 하는 일, 현재 확인된 상태, 지켜야 할 규칙, 막힘, 다음 행동, 자세한 정보를 찾을 위치만 남긴다.

## 기존 자료가 있을 때

- 기존 폴더를 대량으로 옮기거나 이름을 바꾸지 않는다.
- 먼저 기존 구조와 새 구조의 대응표를 만든다.
- 현재 내용을 읽을 수 있도록 링크부터 연결한다.
- 중복 문서는 어느 쪽이 정본인지 정한 뒤 나머지를 보관한다.
- 사용자가 승인하지 않은 파일 삭제, 대규모 이동, 비밀 자료 열람은 하지 않는다.

## 처음에는 만들지 않을 것

사용자가 따로 요구하지 않으면 초기 구축에 데이터베이스, 벡터 검색, 임베딩, 클라우드 동기화, 자동 수집 프로그램, Git 훅, 플러그인 설치를 추가하지 않는다. 먼저 Markdown 파일만으로 실제 작업을 한 번 이어갈 수 있게 만든다.

## 구축 후 검증

다음을 실제로 확인한다.

1. 위 구조의 필수 폴더와 파일이 존재하는가.
1. 세컨드브레인 폴더가 실제 작업 폴더 안에 들어가 있지 않은가.
2. `SecondBrain.md`에서 첫 프로젝트 `현재상태.md`로 이동할 수 있는가.
3. 프로젝트 `현재상태.md`에서 `프로젝트개요.md`로 이동할 수 있는가.
4. 만들어진 문서에 `<첫프로젝트>`, `{{프로젝트명}}` 같은 임시 표시가 남아 있지 않은가.
5. 시작 지시 파일에 Second Brain 블록이 정확히 한 번만 있는가.
6. 기존 시작 지시와 기존 문서가 보존되었는가.
7. 완료라고 적은 내용은 실제 파일이나 실행 결과로 확인했는가.
8. 비밀번호, API 키, 세션 토큰, `.env` 내용이 기록되지 않았는가.

가능하면 새 대화에서 아래 질문으로 인수인계가 되는지 확인한다. 환경상 새 대화를 직접 열 수 없다면 사용자가 복사할 수 있도록 이 질문을 마지막 보고에 적는다.

> "지금 만드는 프로젝트가 무엇인지, 확인된 현재 상태가 어디까지인지, 다음에 할 일 한 가지가 무엇인지 알려줘. 추측하지 말고 세컨드브레인에서 읽은 근거 파일도 함께 알려줘."

## 마지막 보고

어려운 기술 용어 없이 다음 내용만 분명하게 보고한다.

- 세컨드브레인을 만든 위치
- 새로 만든 파일
- 기존 파일에 추가한 내용과 보존 방법
- 첫 프로젝트에 기록한 현재 상태와 다음 행동
- 검증 결과
- 사용자가 새 대화에서 보낼 인수인계 확인 문장

설명만 하고 구축을 미루지 않는다. 권한이나 꼭 필요한 정보가 부족한 경우에는 가능한 파일부터 만든 뒤, 막힌 한 가지와 사용자가 해야 할 다음 행동을 정확히 말한다.