---
name: git-teacher-setup
description: Initial Git/GitHub setup and project folder creation for non-developers — handles install, GitHub connection, and first project scaffold. Auto-skips completed steps. Korean triggers — "깃 시작", "깃 설정", "처음이에요", "git 설치", "GitHub 연결", "프로젝트 만들기", "깃 세팅", "시작하기". English triggers — "start with git", "git setup", "connect GitHub", "new project".
---

# 시작하기 — Phase 1 + 2 (바르다 깃선생 — Codex)

Git/GitHub 초기 설정(Phase 1)과 프로젝트 폴더 만들기(Phase 2)를 한번에 처리한다.
이미 완료된 단계는 자동으로 스킵한다.

> 설명·교육 시 `git-teacher-help`의 §교육 원칙(`shared/questioning-policy.md` §3 Teaching)을 따른다. 겁먹은 초보에게는 원샷 금지 — 비유로 안심시키며 여러 턴에 걸쳐 손잡고 간다(§2a). 다만 사용자가 그냥 빨리 세팅만 원하면 강의하지 말고 단계만 진행한다(§2c).
> Codex CLI에는 객관식 카드 UI가 없다. 결정이 필요한 곳은 `shared/questioning-policy.md` §A의 **채팅 번호형 선택지 블록**으로 묻고, 사용자의 다음 자유 텍스트 답변을 읽는다.

## Phase 1: 준비하기

"Google Drive 앱을 설치하고 구글 계정으로 로그인하는 것과 같아요."

### Step 1: 병렬 상태 수집

다음 명령을 **병렬로(가능한 한 함께)** 실행한다:

```bash
git --version 2>/dev/null              # git 설치 확인
gh --version 2>/dev/null               # gh 설치 확인
git config --global user.name          # 이름 설정 확인
git config --global user.email         # 이메일 설정 확인
gh auth status 2>&1                    # GitHub 로그인 확인
```

### Step 2: 완료된 단계 스킵 + 미완료 단계 진행

수집 결과를 분석하여 이미 완료된 항목은 체크 표시로 보여주고, **미완료 항목만** 진행한다.

#### 2a. Git 설치 (미설치 시)

```
Git이 설치되어 있지 않아요. 설치할게요.
드라이브를 쓰려면 드라이브 앱이 필요한 것처럼, Git도 앱이 필요해요.
```

macOS:
```bash
xcode-select --install
```

Windows: https://git-scm.com/download/win 에서 설치 파일을 다운로드한다.

Linux:
```bash
sudo apt-get install git
```

설치 후 확인: `git --version`

#### 2b. GitHub CLI (gh) 설치 (미설치 시)

```
GitHub CLI를 설치할게요. GitHub에 파일을 올리는 데 필요한 도구예요.
```

macOS (Homebrew 있을 때):
```bash
brew install gh
```

Homebrew 없을 때: Homebrew 설치를 먼저 안내한다.

Windows:
```bash
winget install --id GitHub.cli
```

Linux:
```bash
(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
&& cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y
```

또는 배포판 저장소에서 바로 설치 가능한 경우: `sudo apt install gh`

설치 후 확인: `gh --version`

#### 2c. Git 사용자 정보 설정 (미설정 시)

먼저 비유로 안심시킨다:

```
Git에 이름과 이메일을 등록해야 해요.
구글 계정을 만들 때 이름을 입력하는 것과 같아요.
파일을 저장할 때 "누가 수정했는지" 기록하는 데 쓰여요.
```

그다음 채팅에 번호형 선택지로 묻는다 (`shared/questioning-policy.md` §A):

```text
질문: Git에 등록할 이름과 이메일을 어떻게 할까요?
1. 직접 입력 — 이름/이메일을 한 줄로 알려주세요 (예: 홍길동 / hong@email.com)
2. GitHub 계정과 동일 — GitHub 로그인 후 자동으로 가져올게요
3. 문장으로 직접 수정 요청
(모르면 1번으로 진행하겠습니다.)
```

입력을 받으면:
```bash
git config --global user.name "사용자 이름"
git config --global user.email "사용자 이메일"
```

#### 2d. GitHub 로그인 (미로그인 시)

```
GitHub에 로그인할게요. 구글 계정으로 드라이브에 로그인하는 것과 같아요.
브라우저 창이 열리면 로그인하고 승인해주세요.
```

```bash
gh auth login --web --git-protocol https
```

> 브라우저 인증은 사용자가 직접 완료해야 한다. 명령을 띄운(또는 안내한) 뒤 **인증이 끝났는지 확인하고 멈춘다.** 인증이 끝난 것처럼 단정하지 않는다.

### Step 3: Phase 1 완료 확인

```
준비 완료!
  - Git 설치됨 (v2.xx)
  - GitHub 로그인됨 (계정: username)

이제 프로젝트 폴더를 만들 수 있어요.
```

## Phase 2: 폴더 만들기

"Google Drive에 새 공유 폴더를 만드는 것과 같아요."

### Step 4: 프로젝트 선택

채팅에 번호형 선택지로 묻는다 (`shared/questioning-policy.md` §A):

```text
질문: 프로젝트 폴더를 어떻게 만들까요?
1. 새 프로젝트 시작하기 — 빈 폴더를 만들어요
2. 기존 프로젝트 가져오기 — GitHub에 있는 폴더를 복사해요
3. 현재 폴더를 프로젝트로 만들기 — 지금 이 폴더를 Git으로 관리해요
4. 문장으로 직접 수정 요청
(모르면 1번으로 진행하겠습니다.)
```

#### 선택 1: 새 프로젝트 시작하기

채팅에서 프로젝트 이름을 받는다. 이어서 공개 여부를 §A 번호 블록으로 확인한다:

```text
질문: 이 프로젝트를 공개로 만들까요, 비공개로 만들까요?
1. 비공개(private) — 나만 볼 수 있어요 (추천)
2. 공개(public) — 누구나 볼 수 있어요
3. 문장으로 직접 수정 요청
```

```bash
mkdir {project-name} && cd {project-name}
git init
gh repo create {project-name} --{public|private} --source=. --remote=origin --push
```

> 사용자가 공개를 **명확히** 고르지 않았으면 절대 공개로 만들지 않는다 (기본은 비공개).

#### 선택 2: 기존 프로젝트 가져오기

채팅에서 GitHub URL 또는 저장소 이름을 받는다.

사용자 입력을 분석하여 적절한 명령을 실행한다:
- `owner/repo` 형태: `gh repo clone {owner/repo}`
- `https://github.com/...` 형태: `git clone {URL}`
- `git@github.com:...` 형태: `git clone {URL}`

#### 선택 3: 현재 폴더를 프로젝트로 만들기

공개 여부를 §A 번호 블록으로 확인한다 (선택 1과 동일, 기본은 비공개).

```bash
git init
gh repo create {folder-name} --{public|private} --source=. --remote=origin --push
```

### Step 5: Phase 2 완료 확인

```
폴더 준비 완료!
  - 내 컴퓨터: /Users/me/my-project
  - 클라우드: https://github.com/username/my-project

이 두 곳이 연결되어 있어요. 드라이브의 "동기화 폴더"와 비슷하죠.
단, 자동 동기화는 안 돼요 — 직접 "저장"하고 "올려야" 해요.

파일을 수정한 뒤 "저장해줘"라고 하면 됩니다.
```

## 이미 모든 게 설정된 경우

모든 검사가 통과되면:

```
이미 다 준비되어 있어요!

  - Git 설치됨 (v2.xx)
  - GitHub 로그인됨 (계정: username)
  - 프로젝트 연결됨: https://github.com/username/my-project

바로 작업을 시작할 수 있어요.
"상태 확인"으로 현재 상태를 볼 수 있고,
파일을 수정한 뒤 "저장해줘"로 저장할 수 있어요.
```

## Safety

- 브라우저 인증을 임의로 완료된 것으로 가정하지 않는다 — 인증 명령을 띄우거나 안내한 뒤 멈춘다.
- 사용자가 공개를 명확히 고르지 않으면 공개 저장소를 만들지 않는다.
- GitHub 업로드는 수동임을 설명한다: 저장(commit) → 올리기(push).