> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallelane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 스마트 그룹

> 글롭 패턴으로 브랜치와 태그를 그룹으로 모으기

<Info>
  **PRO 전용:** 그룹의 **이 저장소** 범위는 Pro 기능입니다.
  **전역** 범위는 [모든 요금제에서 사용할 수 있습니다](/ko/quickstart#요금제).
</Info>

**스마트 그룹** 은 이름이 패턴에 맞는 ref를 자동으로 한 묶음에 모읍니다.
패턴만 정해 두면 나중에 생긴 ref도 저절로 들어갑니다.
저장소(Repository) 패널의 **로컬 브랜치**, **원격 브랜치**, **태그** 세 섹션이 각각 독립된 그룹 목록을 가집니다.

<Note>
  그룹은 화면 정리 전용이며 앱 안에만 저장됩니다.
  git 저장소나 원격에는 영향이 없습니다.
</Note>

<Frame>
  <img src="https://mintcdn.com/railgit/Youoqr4OEBTwrnAk/images/history-smart-groups.png?fit=max&auto=format&n=Youoqr4OEBTwrnAk&q=85&s=0b20dc06434f413b880077f0df5dcafc" alt="Repository 패널. LOCAL BRANCHES 아래 Features 그룹이 브랜치 5개를 담아 feature/canary-router, feature/multiregion, feature/protocol-v3, feature/swift-bindings, feature/telemetry-batch를 나열하고, 그룹에 속하지 않은 main, experiment/wasm, maintenance/1.x, rebase/telemetry-base, release/2.x는 그 아래에 남아 있으며, TAGS 아래 SDK releases 그룹이 sdk/v1.0.0, sdk/v2.0.0, sdk/v2.4.0, sdk/v3.1.0-signed를 담고 있다" width="2266" height="1784" data-path="images/history-smart-groups.png" />
</Frame>

## 그룹 만들기

<Steps>
  <Step title="섹션 헤더에서 새 그룹 열기">
    섹션 헤더에 마우스를 올리면 나타나는 **＋** 버튼(**새 그룹**)을 누릅니다.
    그룹이 하나 이상 있으면 그 왼쪽에 톱니 버튼(**그룹 관리**)도 함께 나타납니다.

    <Tip>
      이 버튼들은 섹션 헤더에 마우스를 올릴 때만 드러납니다.
    </Tip>
  </Step>

  <Step title="이름과 매칭 패턴 입력">
    **그룹 이름**(예: `릴리스`)과 **매칭 패턴 (글롭)**(예: `release/*`)을 입력합니다.
  </Step>

  <Step title="범위 고르고 생성">
    **범위(Scope)** 에서 **전역(Global, 기본값)** 은 모든 저장소에, **이 저장소(This repo)** 는 현재 저장소에만 적용합니다.
    **생성(Create)** 을 누르면 패턴에 맞는 ref가 곧바로 모입니다.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/railgit/Youoqr4OEBTwrnAk/images/history-smart-group-create.png?fit=max&auto=format&n=Youoqr4OEBTwrnAk&q=85&s=a16c1ae78d166622ef9f2a67dbd4e39f" alt="New group 다이얼로그. GROUP NAME에 Features, MATCH PATTERN (GLOB)에 feature/*가 들어가 있고, SCOPE 드롭다운은 Global로 선택돼 있으며, 아래에 Cancel 버튼과 초록 Create 버튼이 놓여 있다" width="886" height="688" data-path="images/history-smart-group-create.png" />
</Frame>

## 매칭 패턴 (글롭)

패턴은 ref 이름 **전체와 일치**해야 하며 대소문자는 구분하지 않습니다.
`*` 는 임의 길이의 문자열(`/` 포함), `?` 는 한 글자입니다.

비교 대상은 섹션마다 다릅니다.

* **로컬 브랜치** 는 브랜치 이름을 비교합니다 (`feature/login`)
* **원격 브랜치** 는 원격 이름을 포함한 전체를 비교합니다 (`origin/feature/login`)
* **태그** 는 태그 이름을 비교합니다 (`v1.2.0`)

<Tip>
  원격 브랜치 섹션에서는 패턴에 리모트가 들어가야 합니다. `*/feature/*` 또는 `origin/feature/*` 로 써야 걸립니다.
</Tip>

<Note>
  하나의 ref는 한 그룹에만 들어갑니다.
  여러 패턴에 걸리면 **이 저장소 전용 그룹 → 전역 그룹** 순으로 먼저 확인된 그룹이 가져가며, 같은 범위에서는 목록 순서를 따릅니다.
  좁은 패턴을 위로 두는 편이 예측하기 쉽습니다.
</Note>

어떤 그룹에도 걸리지 않은 ref는 원래 자리에 그대로 남습니다.

## 그룹 다루기

* 그룹 헤더에는 접기 화살표, 그룹 이름, 매칭된 개수가 표시됩니다.
  헤더를 클릭하면 접거나 펼칩니다.
* 헤더를 우클릭하면 **그룹 편집… / 위로 / 아래로 / 삭제** 메뉴가 열립니다.
  편집에서는 이름, 패턴, 범위를 모두 바꿀 수 있습니다.
* 섹션 헤더의 **그룹 관리** 버튼을 누르면 그 섹션의 모든 그룹을 한 화면에서 정렬, 편집, 삭제할 수 있습니다.
  순서 이동은 같은 범위 안에서만 이뤄집니다.
* 매칭이 0개인 그룹도 개수 0으로 계속 표시됩니다.

<Warning>
  그룹 **삭제** 는 확인 절차 없이 처리됩니다.
  그룹만 없어지고 브랜치와 태그는 원래 목록으로 돌아옵니다.
</Warning>
