refboard/임포트
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하나
임포트 CLI는 로컬 폴더를 재귀로 읽어 디렉터리를 refboard 폴더로, .md 파일을 문서로 만든다. 원래의 부모·자식 경로와 Markdown 본문을 유지하므로 큰 GDD를 브라우저에서 하나씩 복사할 필요가 없다.
2. 준비
- refboard 프로젝트 의존성이 설치돼 있어야 한다.
.env.local에서 대상 Neon 데이터베이스 연결이 가능해야 한다.- 가져올 루트 폴더와 대상 프로젝트를 정한다.
CLI는 숨김 이름으로 시작하는 항목을 건너뛰고 .md 외 파일을 무시한다. 이미지나 기타 첨부 파일은 함께 올라가지 않는다.
3. 새 프로젝트로 가져오기
프로젝트 저장소에서 다음 형태로 실행한다.
npm run import:yggdrasil -- --create-project --root /path/to/docs
이 모드는 Yggdrasil 이름의 새 프로젝트를 만들고 전체 Markdown 트리를 삽입한다. 기본 설정에서는 루트에 Vision과 Audio 보강 폴더와 정해진 하위 문서도 추가한다.
4. 기존 프로젝트로 가져오기
npm run import:yggdrasil -- --project-id <PROJECT_ID> --root /path/to/docs
<PROJECT_ID>는 이미 존재하는 refboard 프로젝트 UUID다. 표준 Vision·Audio 보강을 원하지 않으면 --no-augment를 덧붙인다.
5. 실행 결과 확인
CLI 로그에서 스캔한 파일시스템 노드 수, 계획된 항목 수, 생성된 폴더·문서 수와 프로젝트 ID를 확인한다. 이후 라이브에 로그인해 해당 프로젝트의 문서 트리를 펼치고 제목, 계층, 본문이 맞는지 표본 문서를 연다.
6. 중요한 주의
- 임포트는 멱등하지 않다. 같은 프로젝트에 같은 명령을 두 번 실행하면 중복 slug와 문서가 생길 수 있다.
- 전체 작업을 감싸는 트랜잭션이 없다. 중간 실패 시 일부 문서만 들어갈 수 있으므로 로그와 트리를 확인한다.
- 가장 안전한 흐름은 새 프로젝트에 한 번 임포트하고 검수하는 것이다.
- 파일명은 확장자를 제거하고 소문자 slug로 변환되며, 케밥 케이스 제목은 Title Case로 바뀐다.
- 범용 임포터처럼 보이지만 명령 이름과 기본 보강 구조는 Yggdrasil 사용 사례에 맞춰져 있다.