gptaku_plugins: Instructions file for Claude Code

gptaku-plugins 마켓플레이스

프로젝트 구조

gptaku_plugins/           # 마켓플레이스 (parent repo)
  plugins/                # 각 플러그인은 git submodule (신규는 in-tree 임시 허용)
    dd/                   # 클립보드 드롭 (/dd, /ㅇㅇ)
    ddiring/              # 멀티세션 완료 알림 (띠링)
    docs-guide/
    gaseo/                # Paseo 세션 등록
    git-teacher/
    goaljaby/
    insane-design/
    insane-research/
    insane-review/        # GPT Pro 웹 브릿지 코드 리뷰
    insane-search/
    kkirikkiri/
    nopal/
    pumasi/
    sangse/               # 상세페이지 컷 시트 제작 (/sangse)
    show-me-the-prd/
    skillers-suda/
    tikeytaka/            # API 키 중앙 볼트
    vibe-sunsang/
    # 이외 in-tree WIP/프라이빗: insane-crawl(WIP), insane-slide·insane-video(프라이빗, gitignore)

플러그인 버전 업데이트 체크리스트

플러그인 코드를 수정하고 버전을 올릴 때 반드시 아래 순서를 따른다. 하나라도 빠지면 캐시 불일치로 구버전이 로드된다.

Step 1: 서브모듈 내에서 작업

cd plugins/<plugin-name>
# 코드 수정 완료 후
# 1) plugin.json 버전 업데이트
# 2) git add + commit + push

Step 2: 서브모듈에 GitHub 릴리즈 생성

플러그인은 각자 자기 레포(서브모듈)이므로 릴리즈도 서브모듈 레포에 단다. 버전 bump 커밋을 push한 직후, 그 커밋을 가리키는 태그 + 릴리즈를 만든다.

cd plugins/<plugin-name>
# tag(v<new-version>)는 gh가 자동 생성한다. 별도 git tag 불필요.
gh release create v<new-version> \
  --title "v<new-version> — <한 줄 요약>" \
  --notes "<변경 내용 요약 (커밋 메시지 재활용 가능)>" \
  --target main

• 태그 컨벤션: v<plugin.json의 version> (예: v0.21.3). plugin.json 버전과 반드시 일치.
• 이미 같은 태그가 있으면 실패하므로, 재릴리즈가 필요하면 gh release delete v<ver> --cleanup-tag 후 다시 생성한다.

Step 3: 부모 저장소에서 서브모듈 포인터 업데이트

cd /Users/chulrolee/gptaku_plugins
git add plugins/<plugin-name>
git commit -m "chore: update <plugin-name> submodule to v<new-version>"
git push

Step 4: 마켓플레이스 클론 동기화

cd ~/.claude/plugins/marketplaces/gptaku-plugins
git pull
git submodule update --init plugins/<plugin-name>

Step 5: 캐시 교체

# 1) 이전 버전 캐시 삭제
trash ~/.claude/plugins/cache/gptaku-plugins/<plugin-name>/<old-version>

# 2) 새 버전 캐시 생성 (마켓플레이스에서 복사)
cp -R ~/.claude/plugins/marketplaces/gptaku-plugins/plugins/<plugin-name> \
      /tmp/<plugin-name>-staging
mkdir -p ~/.claude/plugins/cache/gptaku-plugins/<plugin-name>/<new-version>
cp -R /tmp/<plugin-name>-staging/* \
      ~/.claude/plugins/cache/gptaku-plugins/<plugin-name>/<new-version>/
trash /tmp/<plugin-name>-staging