Vibe Sunsang Onboard

바선생 온보딩 (Codex)

처음 한 번만 실행한다. 워크스페이스 자가 치유 → 프로젝트 매핑 → 유형 분류 → AGENTS.md 생성 → 첫 변환.

Codex는 skill-first다 (별도 커맨드 파일 없음). 객관식은 Codex CLI에 카드 UI가 없으므로 $PLUGIN_ROOT/shared/questioning-policy.md §A 번호 블록으로 채팅에서 묻는다 (위젯 흉내 금지).

참조 경로

• 사용자 데이터 루트: ~/vibe-sunsang/
• 설정: ~/vibe-sunsang/config/
• 변환 결과: ~/vibe-sunsang/conversations/
• 결과 저장: ~/vibe-sunsang/exports/
• 종단 로그: ~/vibe-sunsang/growth-log/
• Codex 세션 원본: ~/.codex/sessions/ (JSONL. $CODEX_HOME/sessions가 있으면 그쪽)
• AGENTS.md 템플릿: $PLUGIN_ROOT/references/AGENTS-MD-TEMPLATE.md
• 스크립트: $PLUGIN_ROOT/scripts/ensure_workspace.py, $PLUGIN_ROOT/scripts/convert_sessions.py

Step 0: 사용자 데이터 디렉토리 준비

~/vibe-sunsang/ 디렉토리가 있는지 확인합니다.

이미 존재하는 경우 (재온보딩) → shared/questioning-policy.md §A 번호 블록:

질문: 이전에 설정한 바선생 데이터가 있습니다. 어떻게 할까요?
1. 새 프로젝트만 추가 — 기존 설정을 유지하면서 새 프로젝트만 추가해요 (추천)
2. 처음부터 다시 — 기존 config 파일을 백업(*.bak)하고 새로 시작해요
(모르면 1번으로 진행하겠습니다)

선택에 따라:

• 1번 → 기존 config 파일을 읽어 매핑된 프로젝트를 건너뛰고 새 프로젝트만 진행
• 2번 → 기존 config 파일을 백업(*.bak) 후 새로 생성

존재하지 않거나 v1 구조인 경우 — 디렉토리 생성/마이그레이션은 스크립트에 위임:

python3 "$PLUGIN_ROOT/scripts/ensure_workspace.py" 2>/dev/null || python "$PLUGIN_ROOT/scripts/ensure_workspace.py"

이 스크립트가 config/ conversations/ exports/ growth-log/weekly/를 보장하고, v1 번호 접두사 구조(40-conversations, 90-exports, 30-growth-log, 그리고 10-scripts/*.json config)를 비파괴적으로 새 구조로 이관한다. 출력 STATUS v1_migrated면 다음과 같이 안내한다:

"이전 버전의 폴더 구조를 감지해 데이터(대화·리포트·성장로그·설정)를 새 구조로 자동 이관했습니다. 기존 파일은 덮어쓰지 않았어요."

00-system/, 20-knowledge-base/ 등 나머지 v1 잔여물은 데이터가 아니므로 그대로 두거나, 사용자가 원하면 정리하도록 안내만 한다(자동 삭제 금지).

Step 0.5: 워크스페이스 환경 구성

디렉토리 생성·마이그레이션은 Step 0의 ensure_workspace.py가 이미 끝냈다. 아래는 나머지 초기화만 수행한다.

AGENTS.md 생성 (Codex가 이 폴더에서 읽는 지침 파일):

~/vibe-sunsang/AGENTS.md가 없으면:

1. $PLUGIN_ROOT/references/AGENTS-MD-TEMPLATE.md의 내용을 읽는다
2. ~/vibe-sunsang/AGENTS.md에 저장한다

이미 있으면:

"기존 AGENTS.md를 유지합니다."

.gitignore 생성:

~/vibe-sunsang/.gitignore가 없으면 생성:

# Large conversation files
conversations/**/*.md
!conversations/INDEX.md

이미 있으면 건너뛴다.

git init:

~/vibe-sunsang/.git이 없으면:

cd "$HOME/vibe-sunsang" && git init

이미 있으면 건너뛴다.

Gotchas

• AGENTS-MD-TEMPLATE.md를 인라인으로 하드코딩하지 않는다. 반드시 $PLUGIN_ROOT/references/AGENTS-MD-TEMPLATE.md에서 읽는다.
• 마이그레이션 시 기존 데이터가 있는 디렉토리를 덮어쓰지 않도록 주의한다. 충돌 시 사용자에게 확인받는다.
• git init은 사용자 워크스페이스에서만 실행한다. 플러그인 디렉토리에서 실행하지 않는다.
• Codex 세션 원본은 ~/.codex/sessions/다. 다른 코딩 에이전트의 세션 폴더는 변환기가 읽지 않는다 (형식이 다름).
• 변환 중 분석이 완료됐다고 말하지 않는다. 변환은 데이터 준비일 뿐이다.

Step 1: 환영 & 설명

다음 메시지를 사용자에게 보여줍니다:

바선생에 오신 것을 환영합니다!

바선생은 Codex와 나눈 대화를 돌아보고, AI와 더 잘 협업하는 법을 배우게 해주는 AI 멘토 에이전트입니다.

매주 한 번 여기서 이번 주 대화를 리뷰하면:

• 내가 어떤 실수를 반복하고 있는지
• AI에게 어떻게 요청하면 더 효과적인지
• 어떤 개념을 모르고 넘어갔는지

를 발견할 수 있습니다.

지금부터 초기 설정을 진행하겠습니다.

Step 2: Codex 세션 확인

변환기로 사용 가능한 프로젝트(작업 디렉토리) 목록을 가져옵니다. Codex 세션은 각 JSONL의 session_meta.cwd로 프로젝트가 식별됩니다:

python3 "$PLUGIN_ROOT/scripts/convert_sessions.py" --list-projects --names-file "$HOME/vibe-sunsang/config/project_names.json" 2>/dev/null || python "$PLUGIN_ROOT/scripts/convert_sessions.py" --list-projects --names-file "$HOME/vibe-sunsang/config/project_names.json"

출력은 cwd<TAB>sessions<TAB>display_name TSV(세션 수 내림차순)입니다.

세션 디렉토리가 없어 [ERROR]가 나오거나 목록이 비어 있으면:

"아직 Codex 대화 기록이 없습니다. 먼저 다른 프로젝트에서 Codex를 사용한 후 다시 와주세요." → 여기서 종료

프로젝트가 있으면 다음 단계로 진행합니다.

Step 3: 프로젝트 이름 매핑

발견된 프로젝트 목록을 보여주고, 사용자에게 읽기 좋은 이름을 지정하도록 안내합니다.

안내 메시지:

Codex가 저장한 프로젝트들을 발견했습니다. 각 프로젝트에 알아보기 쉬운 이름을 붙여주세요.

경로가 복잡해 보여도 걱정하지 마세요 - 실제 작업 폴더 경로입니다.

각 프로젝트에 대해:

1. display_name(폴더명에서 자동 생성된 이름)을 추측값으로 쓴다. 같은 폴더명이 다른 경로에 있으면 변환기가 부모 폴더명을 접두로 붙여 구분해 준다.
2. shared/questioning-policy.md §A 번호 블록으로 묻는다 (프로젝트별로 반복):

질문: 이 프로젝트(`~/code/my-project`, 세션 12개)의 이름을 뭐라고 할까요?
1. my_project — 폴더 이름에서 추측한 이름이에요 (추천)
2. 문장으로 직접 다른 이름 알려주세요
3. 건너뛰기 — 이 프로젝트는 분석하지 않아요
(모르면 1번으로 진행하겠습니다)

질문과 1번 라벨은 각 프로젝트에 맞게 동적 생성한다.

규칙:

• 한 번에 5개까지만 질문합니다 (너무 많으면 피로)
• 프로젝트가 5개를 초과하면 5개씩 나눠서 반복합니다. 각 묶음 후 "더 진행할까요?"를 확인합니다.
• 세션이 5개 미만인 프로젝트는 자동으로 건너뜁니다 (사용자에게 알림). 임시 폴더(/tmp, /private/var/folders)에서 돈 세션도 건너뜁니다.
• "건너뛰기"를 선택한 프로젝트는 매핑에서 제외
• 재온보딩 시: 이미 매핑된 프로젝트는 건너뛰고 새 프로젝트만 질문

결과를 ~/vibe-sunsang/config/project_names.json에 저장합니다 (키 = cwd 경로, 값 = 표시 이름):

{
  "/home/me/code/my-project": "my_project"
}