Scope와 현재 프로젝트

Scope는 Glif가 탐색하고 검색할 수 있는 전체 로컬 문서 경계다. 현재 프로젝트는 Scope 안에서 지금 집중할 더 작은 작업 범위다. 둘을 나누면 진행 중인 문서는 간결하게 유지하면서도 이전 기록과 참고 문서를 같은 검색에서 다시 찾을 수 있다.

Scope
├─ 현재 프로젝트        ← 기본 탐색·검색의 집중 범위
├─ 보관 문서            ← 필요할 때 Scope 전체 검색으로 회수
└─ 참고 자료

현재 프로젝트를 바꾸는 일은 파일 이동이 아니다. Markdown의 실제 경로와 내용은 그대로이며, Shelf·검색·launcher가 우선 보여 줄 범위만 달라진다.

시작 절차

  1. 문서를 모아 둔 상위 폴더를 Scope로 연다.
  2. 그 안의 진행 중인 하위 폴더를 현재 프로젝트로 선택한다.
  3. Shelf에서 현재 프로젝트의 Markdown을 연다.
  4. 이름으로 찾을 때는 launcher를 사용한다.
  5. 본문 단어와 프로젝트 밖 기록까지 찾을 때는 Scope 검색을 사용한다.

Scope index가 실제로 현재 프로젝트 안팎을 어떻게 나누는지는 Scope 전체 검색과 결과 열기에서 네 문서 fixture와 영상으로 실습한다.

경계 확인

  • Scope를 너무 크게 잡으면 검색 결과와 갱신 대상이 불필요하게 늘 수 있다.
  • 현재 프로젝트를 너무 작게 잡아도 파일은 사라지지 않는다. Scope 전체 검색으로 다시 찾을 수 있다.
  • Scope 밖 폴더는 별도 mount 또는 새 Scope로 열기 전에는 검색 대상이 아니다.
  • Binder는 게시·출력 구성을 소유하는 경계다. 검색의 전체 경계인 Scope와 같은 개념으로 보지 않는다.

완료 확인

  • Scope와 현재 프로젝트가 서로 다른 경계임을 설명할 수 있다.
  • 현재 프로젝트를 바꾼 뒤 원본 파일 경로가 그대로다.
  • Shelf·launcher·Scope 검색 중 목적에 맞는 회수 방법을 선택했다.

Scope를 설계하는 최소 예제

다음 폴더를 하나의 Scope로 열고, 현재 프로젝트는 active/로 좁힌다.

guide-workspace/
  active/
    brief.md
    todo.md
  archive/
    2025-retro.md
  references/
    glossary.md
  • Scope 검색은 active/, archive/, references/ 전체를 대상으로 한다.
  • 현재 프로젝트 검색과 Shelf는 active/를 우선 보여 준다.
  • archive/를 현재 프로젝트로 옮기지 않아도 Scope 검색에서 과거 기록을 회수할 수 있다.
  • Binder가 active/만 포함하면 publish 결과에는 archive/와 references/가 들어가지 않는다.

실제 폴더를 이동하거나 복사하지 않고 현재 프로젝트 선택만 바꾸는지 Explorer와 Glif의 경로를 함께 확인한다.

Shelf·launcher·검색을 나누어 쓰기

찾고 싶은 것 가장 빠른 경로 이유
현재 프로젝트의 파일 이름 Shelf 계층과 상대 경로를 눈으로 확인
최근에 열었던 문서 Recent 경로를 다시 입력하지 않음
Scope 안의 특정 파일 빠른 열기 제목·경로 prefix로 좁힘
본문에 적힌 단어 Scope 검색 파일 이름이 아니라 내용으로 회수
실행할 명령 명령 팔레트 문서를 찾는 launcher와 action을 구분

파일 이름과 경로를 입력해 문서를 여는 빠른 열기

빠른 열기는 파일을 복제하거나 현재 프로젝트를 변경하지 않는다. 검색 결과를 열어도 Scope와 Binder의 경계는 그대로다.

launcher 키보드 흐름

  1. Ctrl+P를 눌러 빠른 열기를 연다.
  2. brief를 입력해 현재 프로젝트의 brief.md를 찾는다.
  3. 화살표와 Enter로 결과를 연다.
  4. Ctrl+Shift+P를 눌러 명령 팔레트를 연다.
  5. Scope, Preview, 설정처럼 실행할 action을 검색한다.
  6. 명령을 실행한 뒤 현재 문서와 Scope 경계가 의도대로 유지되는지 확인한다.

명령 팔레트에서 작업 공간 action을 검색하는 화면

명령 팔레트에서 Scope 해제 또는 외부 폴더 연결처럼 범위를 바꾸는 action을 실행할 때는 확인 dialog와 현재 경로를 먼저 읽는다. 단순히 문서를 여는 action과 경계를 바꾸는 action을 같은 것으로 취급하지 않는다.

경계와 복구

증상 원인 후보 확인·복구
현재 프로젝트 파일이 안 보임 선택 범위가 다른 하위 폴더 Scope 전체로 넓힌 뒤 경로를 확인
launcher 결과가 없음 파일이 Scope 밖이거나 저장되지 않음 Explorer에서 존재 여부와 Scope mount를 확인
검색은 되지만 Shelf에 없음 현재 프로젝트 밖의 결과 결과 경로를 보고 현재 프로젝트를 조정
Binder 결과에 파일이 없음 Binder가 별도 publish 범위를 소유 Binder 포함 목록과 build log를 확인
명령 실행 뒤 파일이 사라짐 경계 변경 action을 실행함 원본 경로를 확인하고 Scope를 다시 선택

Scope 밖 폴더는 자동으로 검색 대상이 되지 않는다. 외부 폴더가 필요하면 별도 Scope 또는 mount 절차를 사용하고, 현재 프로젝트를 바꿔 파일을 숨기는 방식으로 접근 권한을 우회하지 않는다.

완료 체크

  • Scope 전체와 현재 프로젝트의 실제 경로를 설명할 수 있다.
  • Shelf, launcher, 검색, 명령 팔레트의 목적을 구분한다.
  • 현재 프로젝트를 바꿔도 파일이 이동하지 않는지 확인했다.
  • Scope·Binder·publish 경계를 서로 다르게 기록했다.
  • 경계 변경 action 실행 전 확인 dialog와 복구 경로를 읽었다.