Install

/plugin install git-workflows@claude-integration

Run it inside Claude Code after adding the marketplace with /plugin marketplace add m16khb/claude-integration.

Contents

Discovered from source

Commands 2

Smart Git Commit (Conventional Commits 1.0.0)

MISSION

변경사항을 분석하여 Conventional Commits 1.0.0 규격의 커밋을 생성합니다. SemVer와 연동: feat→MINOR, fix→PATCH, BREAKING CHANGE→MAJOR

Args: $ARGUMENTS


PHASE 1: Gather Context

echo "=== BRANCH ===" && git branch --show-current
echo "=== CHANGES ===" && git status --short
echo "=== STAGED ===" && git diff --cached --stat
echo "=== UNSTAGED ===" && git diff --stat
echo "=== RECENT COMMITS ===" && git log --oneline -5

PHASE 2: Security Check

CRITICAL RULES:
├─ 민감 파일 (.env, *.key, *secret*) → 경고 + 확인 필요
├─ main/master + push → 명시적 확인 필수
└─ 변경 없음 → "변경 사항 없음" 출력 후 종료

PHASE 2.5: BREAKING CHANGE Detection (NEW)

BREAKING CHANGE 감지 기준:
┌─────────────────────────────────────────────────────────┐
│ 1. API 시그니처 변경                                     │
│    - 함수/메서드 파라미터 변경                            │
│    - 반환 타입 변경                                      │
│    - 기존 메서드 삭제                                    │
│                                                         │
│ 2. 설정 파일 변경                                        │
│    - 환경변수 이름 변경                                   │
│    - 설정 키 삭제/이름 변경                               │
│                                                         │
│ 3. 데이터 스키마 변경                                     │
│    - DB 테이블/컬럼 삭제                                  │
│    - API 응답 형식 변경                                   │
│                                                         │
│ 4. 파일 삭제/이동                                        │
│    - public API 파일 삭제                                │
│    - 엔트리 포인트 변경                                   │
└─────────────────────────────────────────────────────────┘

IF BREAKING CHANGE detected:
  → AskUserQuestion: "BREAKING CHANGE로 표시하시겠습니까?"
  → 사용자 확인 시: 타입에 ! 추가 또는 꼬리말에 BREAKING CHANGE 추가
  → SemVer 영향: MAJOR 버전 증가 필요 알림

PHASE 3: Analyze & Group Changes

GROUPING:
├─ 경로 기반: src/auth/* → "auth" 그룹
├─ 타입 기반: *.test.ts → "test" 그룹
└─ 패턴 기반: A(added)→feat, M(modified)→fix/refactor

COMMIT TYPE 매트릭스:
┌────────────────┬────────────────┬─────────┐
│ 변경 패턴       │ 커밋 타입       │ SemVer  │
├────────────────┼────────────────┼─────────┤
│ 새 파일 추가    │ feat/test/docs │ MINOR   │
│ 기존 파일 수정  │ fix/refactor   │ PATCH   │
│ 파일 삭제      │ refactor/chore │ -       │
│ 설정 파일      │ chore          │ -       │
│ BREAKING 변경  │ type!          │ MAJOR   │
└────────────────┴────────────────┴─────────┘

PHASE 3.5: Multi-Commit Strategy (≥2 그룹)

IF groups >= 2:
  TUI 선택:
  ├─ 그룹별 개별 커밋 (Recommended)
  ├─ 전체 단일 커밋
  └─ 선택적 커밋

COMMIT ORDER:
chore → refactor → feat → fix → test → docs

PHASE 4: Create Commit

4.1 일반 커밋

MESSAGE FORMAT (Conventional Commits 1.0.0):
<type>(<scope>): <Korean description>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

4.2 BREAKING CHANGE 커밋

방법 1: ! 문법
<type>(<scope>)!: <description>

BREAKING CHANGE: <상세 설명>

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>

방법 2: 꼬리말만
<type>(<scope>): <description>

BREAKING CHANGE: <상세 설명>

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>

4.3 revert 커밋

revert: <되돌리는 커밋의 subject>

This reverts commit <SHA>.

Refs: <SHA>

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>

4.4 커밋 실행

git commit -m "$(cat <<'EOF'
<type>: <Korean description>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

PHASE 5: Push (Conditional)

IF "push" in $ARGUMENTS:
  ├─ upstream 없음 → git push -u origin $BRANCH
  └─ upstream 있음 → git push origin $BRANCH

PHASE 6: Report

## ✅ 커밋 완료

| 항목        | 내용                       |
| ----------- | -------------------------- |
| 커밋        | `<hash>` <type>: <message> |
| 브랜치      | <branch>                   |
| 푸시        | ✅/⏭️/❌                   |
| 변경        | +<insertions>/-<deletions> |
| SemVer 영향 | MAJOR/MINOR/PATCH/없음     |
| BREAKING    | ⚠️/✅                      |

PHASE 7: Follow-up TUI

AskUserQuestion:
  question: "다음 작업을 선택하세요"
  options:
    - 푸시 → git push
    - 추가 커밋 → PHASE 1로 재실행
    - 완료 → 종료

ERROR HANDLING

ErrorResponse
Nothing to commit"변경 사항 없음"
Merge conflict"충돌 파일 확인 후 해결"
Push rejected"git pull --rebase 후 재시도"
Pre-commit hook fail수정 제안 표시

SEMVER QUICK REFERENCE

SEMANTIC VERSIONING 연동:
┌──────────────────┬─────────────────────────────┐
│ 커밋             │ SemVer 영향                  │
├──────────────────┼─────────────────────────────┤
│ feat             │ MINOR (1.x.0)               │
│ fix              │ PATCH (1.0.x)               │
│ BREAKING CHANGE  │ MAJOR (x.0.0)               │
│ docs/style/...   │ 영향 없음                    │
└──────────────────┴─────────────────────────────┘

Documentation

상세 내용은 agent-docs/ 참조:

  • @../agent-docs/commit-conventions.md - Conventional Commits 1.0.0 전체 규격
  • @../agent-docs/branch-strategies.md - Git Flow 브랜치 전략
  • @../agent-docs/automation-patterns.md - 다중 커밋, 스마트 그룹화

Git Worktree Manager

MISSION

Git worktree를 안전하게 생성, 조회, 삭제합니다. 여러 브랜치에서 동시에 작업할 수 있도록 독립된 작업 디렉토리를 관리합니다.

Args: $ARGUMENTS


SYNTAX

/git-workflows:git-worktree <action> [branch] [name]

Actions:
  add <branch> [name]   - 새 워크트리 생성
  list                  - 워크트리 목록 조회
  remove <name>         - 워크트리 삭제
  prune                 - 삭제된 워크트리 정리

Arguments:
  branch  - 타겟 브랜치 (기존 또는 새 브랜치)
  name    - 워크트리 디렉토리 이름 (기본: 브랜치명)

PHASE 1: Parse Arguments

ARGUMENT PARSING:
┌─────────────────────────────────────────────────────────┐
│ $ARGUMENTS 파싱                                          │
├─────────────────────────────────────────────────────────┤
│ 예시:                                                    │
│   "add feature/auth"        → branch: feature/auth      │
│   "add feature/auth mywork" → branch: feature/auth      │
│                               name: mywork              │
│   "list"                    → action: list              │
│   "remove mywork"           → name: mywork              │
│   "prune"                   → action: prune             │
└─────────────────────────────────────────────────────────┘

IF no arguments OR invalid action:
  → AskUserQuestion으로 action 선택 요청

PHASE 2: Context Gathering

echo "=== CURRENT REPO ===" && pwd
echo "=== CURRENT BRANCH ===" && git branch --show-current
echo "=== EXISTING WORKTREES ===" && git worktree list
echo "=== AVAILABLE BRANCHES ===" && git branch -a --format='%(refname:short)' | head -20

PHASE 3: Safety Checks

SAFETY VALIDATION:
┌─────────────────────────────────────────────────────────┐
│ 1. Git 저장소 확인                                       │
│    - .git 디렉토리 존재 여부                             │
│    - bare 저장소 아닌지 확인                             │
│                                                         │
│ 2. 브랜치 검증 (add 시)                                  │
│    - 이미 다른 워크트리에서 체크아웃 중인지              │
│    - 브랜치 존재 여부 (없으면 생성 확인)                 │
│                                                         │
│ 3. 경로 검증                                             │
│    - 디렉토리 이미 존재하는지                            │
│    - 상위 디렉토리 쓰기 권한                             │
│    - 경로 충돌 없는지                                    │
│                                                         │
│ 4. 워크트리 상태 확인 (remove 시)                        │
│    - 커밋되지 않은 변경사항 있는지                       │
│    - 스태시된 변경사항 있는지                            │
└─────────────────────────────────────────────────────────┘

PHASE 4: Execute Action

4.1 ADD - 워크트리 생성

ADD WORKTREE FLOW:
┌─────────────────────────────────────────────────────────┐
│ 1. 브랜치 확인                                           │
│    IF 브랜치 존재:                                       │
│      → git worktree add <path> <branch>                 │
│    ELSE:                                                │
│      → 사용자 확인 후 새 브랜치 생성                     │
│      → git worktree add -b <branch> <path>              │
│                                                         │
│ 2. 경로 결정                                             │
│    - 기본: ../worktrees/<name>                          │
│    - 또는: ../<name>                                    │
│                                                         │
│ 3. 생성 실행                                             │
│    git worktree add <path> <branch>                     │
└─────────────────────────────────────────────────────────┘
# 기존 브랜치로 워크트리 생성
git worktree add "../worktrees/$NAME" "$BRANCH"

# 새 브랜치 생성과 함께 워크트리 생성
git worktree add -b "$BRANCH" "../worktrees/$NAME"

# 원격 브랜치 추적하며 생성
git worktree add --track -b "$LOCAL_BRANCH" "../worktrees/$NAME" "origin/$REMOTE_BRANCH"

4.2 LIST - 워크트리 목록

echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📂 Git Worktrees"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
git worktree list --porcelain | while read line; do
  # 포맷팅된 출력
done
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

4.3 REMOVE - 워크트리 삭제

REMOVE WORKTREE FLOW:
┌─────────────────────────────────────────────────────────┐
│ 1. 워크트리 존재 확인                                    │
│                                                         │
│ 2. 변경사항 확인                                         │
│    IF 커밋되지 않은 변경:                                │
│      ⚠️  경고 표시                                       │
│      → 사용자 확인 요청                                  │
│      → 강제 삭제 시 --force 사용                         │
│                                                         │
│ 3. 삭제 실행                                             │
│    git worktree remove <path>                           │
│    OR                                                   │
│    git worktree remove --force <path>                   │
└─────────────────────────────────────────────────────────┘
# 안전한 삭제 (변경사항 있으면 실패)
git worktree remove "../worktrees/$NAME"

# 강제 삭제 (변경사항 무시)
git worktree remove --force "../worktrees/$NAME"

4.4 PRUNE - 정리

# 삭제된 워크트리 참조 정리
git worktree prune

# Dry-run으로 먼저 확인
git worktree prune --dry-run

PHASE 5: Report

ADD 성공 시

## ✅ 워크트리 생성 완료

| 항목   | 내용                                  |
| ------ | ------------------------------------- |
| 경로   | `../worktrees/<name>`                 |
| 브랜치 | `<branch>`                            |
| 상태   | 새 브랜치 생성 / 기존 브랜치 체크아웃 |

### 다음 단계

```bash
# 워크트리로 이동
cd ../worktrees/<name>

# 작업 시작
code .
```

### LIST 출력

```markdown
## 📂 Git Worktrees

| # | 경로 | 브랜치 | HEAD |
|---|------|--------|------|
| 1 | /path/to/main | main | abc1234 |
| 2 | /path/to/feature | feature/auth | def5678 |
| 3 | /path/to/hotfix | hotfix/bug | ghi9012 |

총 3개 워크트리

REMOVE 성공 시

## ✅ 워크트리 삭제 완료

| 항목        | 내용                         |
| ----------- | ---------------------------- |
| 삭제된 경로 | `../worktrees/<name>`        |
| 브랜치      | `<branch>` (브랜치는 유지됨) |

ℹ️ 브랜치를 함께 삭제하려면:

```bash
git branch -d <branch>
```

---

## ERROR HANDLING

| Error | Response |
|-------|----------|
| Not a git repository | "Git 저장소가 아닙니다" |
| Branch already checked out | "브랜치가 이미 다른 워크트리에서 사용 중입니다" |
| Path already exists | "경로가 이미 존재합니다" |
| Worktree not found | "워크트리를 찾을 수 없습니다" |
| Uncommitted changes | "커밋되지 않은 변경사항이 있습니다. --force로 강제 삭제" |
| Invalid branch name | "유효하지 않은 브랜치 이름입니다" |

---

## INTERACTIVE MODE

인자 없이 실행 시: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌲 Git Worktree Manager

작업을 선택하세요:

[1] 새 워크트리 생성 (add) 브랜치를 별도 디렉토리에서 작업

[2] 워크트리 목록 (list) 현재 워크트리 상태 확인

[3] 워크트리 삭제 (remove) 더 이상 필요 없는 워크트리 제거

[4] 정리 (prune) 삭제된 워크트리 참조 정리

[q] 취소 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 선택:


---

## USE CASES

### 1. 기능 개발 중 긴급 버그 수정

```bash
# 현재 feature/payment 작업 중
# hotfix가 필요한 상황

# 새 워크트리 생성
/git-workflows:git-worktree add hotfix/critical-bug hotfix

# 결과:
# ../worktrees/hotfix 디렉토리에서 hotfix 작업
# 기존 feature/payment 작업은 유지

2. 여러 브랜치 동시 빌드/테스트

# main, develop, feature 동시에 빌드 확인
/git-workflows:git-worktree add main main-build
/git-workflows:git-worktree add develop dev-build

# 각 워크트리에서 독립적으로 빌드 실행

3. 코드 리뷰를 위한 PR 브랜치 체크아웃

# PR 브랜치를 별도 워크트리로
/git-workflows:git-worktree add feature/user-auth review-pr-123

# 현재 작업 중단 없이 PR 코드 리뷰

BEST PRACTICES

DO ✅:
├─ 워크트리 디렉토리를 일관된 위치에 생성 (../worktrees/)
├─ 작업 완료 후 워크트리 삭제
├─ 정기적으로 prune 실행
└─ 워크트리 이름을 명확하게 지정

DON'T ❌:
├─ 너무 많은 워크트리 생성 (관리 어려움)
├─ 워크트리 내부를 Git 저장소로 착각
├─ 워크트리 디렉토리를 수동으로 삭제 (git worktree remove 사용)
└─ 같은 브랜치로 여러 워크트리 생성 시도

WORKTREE DIRECTORY STRUCTURE

project/
├── main-repo/           ← 메인 저장소
│   ├── .git/
│   ├── src/
│   └── ...
│
└── worktrees/           ← 워크트리 디렉토리 (권장)
    ├── feature-auth/    ← feature/auth 브랜치
    ├── hotfix-bug/      ← hotfix/bug 브랜치
    └── review-pr-123/   ← PR 리뷰용

Documentation

  • @../agent-docs/branch-strategies.md - Git Flow 브랜치 전략
  • @../agent-docs/automation-patterns.md - 자동화 패턴

Sponsors

Details

Marketplace
m16khb/claude-integration
Source
plugins/git-workflows
Category
Development

More from m16khb/claude-integration

All 7