git-teacher-setup

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에는 AskUserQuestion 카드 UI가 없다. 결정이 필요한 곳은 shared/questioning-policy.md §A의 채팅 번호형 선택지 블록으로 묻고, 사용자의 다음 자유 텍스트 답변을 읽는다.

Phase 1: 준비하기

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

Step 1: 병렬 상태 수집

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

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:

xcode-select --install

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

Linux:

sudo apt-get install git

설치 후 확인: git --version

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

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

macOS (Homebrew 있을 때):

brew install gh

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

Windows:

winget install --id GitHub.cli

Linux:

(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):

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

입력을 받으면:

git config --global user.name "사용자 이름"
git config --global user.email "사용자 이메일"

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

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

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):

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

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

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

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

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}
• [e-mail]:... 형태: git clone {URL}

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

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

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).