vibe-sunsang-onboard

vibe-sunsang-onboard for Codex

바선생 초기 설정. 처음 한 번만 실행한다. 로컬 워크스페이스 생성 → 유형 분류 → CLAUDE.md 생성 → 첫 변환.

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

참조 경로

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

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

~/vibe-sunsang/가 있는지 확인한다.

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

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

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

존재하지 않는 경우:

mkdir -p "$HOME/vibe-sunsang/config" "$HOME/vibe-sunsang/conversations" "$HOME/vibe-sunsang/exports" "$HOME/vibe-sunsang/growth-log/weekly"

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

CLAUDE.md 생성 — ~/vibe-sunsang/CLAUDE.md가 없으면:

1. $PLUGIN_ROOT/skills/vibe-sunsang-onboard/references/CLAUDE-MD-TEMPLATE.md를 읽는다 (인라인 하드코딩 금지).
2. ~/vibe-sunsang/CLAUDE.md로 저장한다.

이미 있으면: "기존 CLAUDE.md를 유지합니다."

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

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

git init — ~/vibe-sunsang/.git이 없으면 cd "$HOME/vibe-sunsang" && git init. 플러그인 디렉토리에서는 실행하지 않는다.

Step 1: 환영 & 설명

다음을 보여준다:

---

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

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

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

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

를 발견할 수 있습니다. 지금부터 초기 설정을 진행하겠습니다.

---

Step 2: Codex 세션 확인

~/.codex/sessions/를 확인하여 사용 가능한 세션(JSONL)이 있는지 본다:

ls "$HOME/.codex/sessions/"

세션이 없으면:

"아직 Codex 대화 기록이 없습니다. 먼저 Codex로 작업한 후 다시 와주세요." → 종료

세션이 있으면 다음 단계로 진행한다.

Step 3: 프로젝트(워크스페이스) 매핑

Codex 세션은 각 JSONL의 session_meta.cwd(작업 디렉토리)로 워크스페이스를 식별한다. 변환기가 cwd의 마지막 경로 조각을 워크스페이스 이름으로 쓴다.

1. 세션 파일을 가볍게 훑어 등장하는 cwd(워크스페이스) 목록과 각 빈도를 파악한다.
2. 알아보기 쉬운 이름을 붙일 수 있게 안내한다. 변경이 필요하면 shared/questioning-policy.md §A 번호 블록으로 워크스페이스별로 묻는다:

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

질문과 1번 라벨은 각 워크스페이스에 맞게 동적 생성한다.

규칙:

• 한 번에 5개까지만 묻는다 (피로 방지). 5개 초과면 5개씩 나눠 "더 진행할까요?" 확인.
• 세션이 5개 미만인 워크스페이스는 자동으로 건너뛴다 (사용자에게 알림).
• "건너뛰기"는 매핑에서 제외. 재온보딩 시 이미 매핑된 워크스페이스는 건너뛴다.

결과를 ~/vibe-sunsang/config/project_names.json에 저장한다 (cwd → 표시명 매핑).

Step 4: 워크스페이스 유형 분류

각 워크스페이스 디렉토리(cwd)의 CLAUDE.md/AGENTS.md/README.md를 읽어 유형을 추론한다.

유형 분류 기준:

문서를 못 찾으면 파일 구조를 간단히 확인(.py/.js가 많으면 Builder 등). 추론이 어려우면 shared/questioning-policy.md §A 번호 블록으로 묻는다:

질문: [워크스페이스명]을(를) 분석해보니 [추론된 유형] 워크스페이스로 보입니다. 맞나요?
1. Builder (코딩) — 코딩/개발 프로젝트
2. Explorer (리서치/학습) — 리서치/Q&A/스터디
3. Designer (기획) — 기획/아이디에이션
4. Operator (자동화) — 업무 자동화/데이터처리
(추론한 유형이 맞으면 그 번호로, 아니면 다른 번호로 답해주세요)

question은 각 워크스페이스 이름과 추론 유형으로 동적 생성. 여러 목적이면 주된 목적 1개. 같은 유형이 반복되면 묶어서 한 번에 확인.

결과를 ~/vibe-sunsang/config/workspace_types.json에 저장:

{
  "schema_version": 1,
  "type_definitions": {
    "builder": "코딩/개발",
    "explorer": "리서치/Q&A/스터디",
    "designer": "기획/아이디에이션",
    "operator": "자동화/데이터처리"
  },
  "default_type": "builder",
  "workspaces": {
    "my-app": {
      "type": "builder",
      "name": "my-app",
      "detected_from": "CLAUDE.md",
      "confirmed": true
    }
  }
}

Step 5: 첫 변환 실행

python3 "$PLUGIN_ROOT/skills/vibe-sunsang-retro/scripts/convert_sessions.py" --force --output-dir "$HOME/vibe-sunsang/conversations" 2>/dev/null || python "$PLUGIN_ROOT/skills/vibe-sunsang-retro/scripts/convert_sessions.py" --force --output-dir "$HOME/vibe-sunsang/conversations"

변환 진행 상황을 보여주고 완료되면 요약한다:

• 총 워크스페이스 수
• 총 세션 수
• 가장 활발한 워크스페이스 TOP 3
• 유형별 분포 (Builder N개, Explorer N개, ...)

Step 6: 사용법 안내

---

설정 완료! 유형별 맞춤 분석을 받을 수 있습니다:

v2 레벨 시스템 — 6가지 기술 차원으로 AI 활용 능력을 분석합니다:

레벨은 L1.0(입문)부터 L7.0(마스터)까지 0.5 단위로 측정됩니다. 유형마다 중요한 축이 달라 맞춤 분석을 받을 수 있어요.

사용할 수 있는 기능 (Codex skill로 실행):

추천 루틴: 매주 금요일 "변환해줘" → "멘토링해줘"로 이번 주 리뷰 → 행동 계획 실천.

---

Step 7: 바로 시작할지 물어보기

shared/questioning-policy.md §A 번호 블록:

질문: 바로 이번 주 리뷰를 시작해볼까요?
1. 멘토링 시작 — AI 활용 능력 코칭 세션을 바로 시작해요 (6축 분석)  → vibe-sunsang-mentor
2. 성장 리포트 생성 — 성장 분석 리포트를 자동 생성해요 (6축 레이더)  → vibe-sunsang-growth
3. 나중에 할게요 — 여기서 마무리할게요
(모르면 1번으로 진행하겠습니다)

선택에 따라: 1→ vibe-sunsang-mentor, 2→ vibe-sunsang-growth, 3→ 종료.

Gotchas

• CLAUDE-MD-TEMPLATE.md를 인라인으로 하드코딩하지 않는다. 반드시 $PLUGIN_ROOT/skills/vibe-sunsang-onboard/references/CLAUDE-MD-TEMPLATE.md에서 읽는다.
• 기존 데이터가 있는 디렉토리를 덮어쓰지 않는다. 충돌 시 사용자에게 확인받는다.
• git init은 사용자 워크스페이스(~/vibe-sunsang/)에서만 실행한다.
• Codex 세션 원본은 ~/.codex/sessions/다 (Claude Code의 ~/.claude/projects/가 아님).
• 변환 중 분석이 완료됐다고 말하지 않는다. 변환은 데이터 준비일 뿐이다.