Run: conversation log conversion
Argument: $ARGUMENTS
Step 0: Pre-check
"$HOME/vibe-sunsang/config/project_names.json" Check whether the file exists.
If not present:
"Barseonsaeng initial setup hasn't been done yet.
/vibe-sunsang 시작Please run it first." → Exit here
Step 1: Run the conversion script
Analyze the argument and run with the appropriate options:
| Argument | Action |
|---|---|
| (none) | Incremental conversion (new sessions only) |
| "all", "force", "again" | --force Full re-conversion |
| "detailed", "verbose" | --verbose Include error logs |
| Project name | --project <이름> Only that project |
If a project name is specified: "$HOME/vibe-sunsang/conversations/INDEX.md"Read the project list from and find a matching project. If there is no exactly matching project, EXECUTE: immediately call the AskUserQuestion tool with the JSON below:
{
"questions": [{
"question": "어떤 프로젝트의 대화를 변환할까요?",
"header": "프로젝트 선택",
"options": [
{"label": "{프로젝트명1}", "description": "{세션 수}개 세션"},
{"label": "{프로젝트명2}", "description": "{세션 수}개 세션"}
],
"multiSelect": false
}]
}
Generate options dynamically from the project list read from INDEX.md. Sort by highest session count.
# 기본: 증분 변환
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/convert_sessions.py --names-file "$HOME/vibe-sunsang/config/project_names.json" --output-dir "$HOME/vibe-sunsang/conversations" 2>/dev/null || python ${CLAUDE_PLUGIN_ROOT}/scripts/convert_sessions.py --names-file "$HOME/vibe-sunsang/config/project_names.json" --output-dir "$HOME/vibe-sunsang/conversations"
# --force: 인자에 "전체", "force", "다시" 포함 시
# python3 ${CLAUDE_PLUGIN_ROOT}/scripts/convert_sessions.py --force --names-file "$HOME/vibe-sunsang/config/project_names.json" --output-dir "$HOME/vibe-sunsang/conversations" 2>/dev/null || python ${CLAUDE_PLUGIN_ROOT}/scripts/convert_sessions.py --force --names-file "$HOME/vibe-sunsang/config/project_names.json" --output-dir "$HOME/vibe-sunsang/conversations"
# --verbose: 인자에 "상세", "verbose" 포함 시 추가
# --project: 인자에 프로젝트명 포함 시 추가
Error handling
If a problem occurs while running the conversion script, guide the user in a way a non-developer can understand:
| Situation | Message to show the user |
|---|---|
| No Python | "Python is not installed. Please run python3 --versionin the terminal to check." |
| No project folder | "Cannot find Claude Code conversation history. Please check whether you have used Claude Code in another project." |
| Permission error | "Cannot access the file. "$HOME/.claude/projects/" Please check the permissions of the folder." |
| 0 conversions | "There are no new conversations to convert. It's already up to date!" |
Step 2: Check the index
After conversion is complete, read the index and show the status:
"$HOME/vibe-sunsang/conversations/INDEX.md"Read with the Read tool.
Summarize the conversion results:
- Total number of projects
- Total number of sessions
- Recently converted sessions
Step 3: Suggest analysis templates
Once conversion is complete, suggest the following analysis options:
Available analyses:
-
Project pattern analysis
"Analyze the sessions for [project name]. Summarize the main task types, recurring errors, and tool usage patterns."
-
Growth tracker → "Create a growth report" or
/vibe-sunsang 성장Generate a growth report. (v2: includes 6-axis technical dimension analysis + radar chart)
-
Mentoring session → "Mentor me" or
/vibe-sunsang 멘토링Receive coaching on AI utilization skills. (v2: 6-axis-centered tailored analysis)
-
Bug/Mistake Patterns
"Find the mistake patterns I experienced across all projects."
-
Team Mode Review
"Analyze the team mode session and evaluate coordination efficiency."
-
Cost Analysis
"Summarize token usage and model distribution by project."
-
6-Axis Analysis
"Analyze the recent session based on the 6 axes (DECOMP/VERIFY/ORCH/FAIL/CTX/META)."
Data Path
- Source:
"$HOME/.claude/projects/{프로젝트}/세션ID.jsonl" - Conversion Result:
"$HOME/vibe-sunsang/conversations/{프로젝트명}/" - Index:
"$HOME/vibe-sunsang/conversations/INDEX.md" - Settings:
"$HOME/vibe-sunsang/config/" - Save Report:
"$HOME/vibe-sunsang/exports/"