guide

# /guide - 첫 사용자 인터랙티브 가이드

이 가이드는 약 3분이면 끝납니다. Claude Forge를 처음 사용하는 분을 위한 튜토리얼입니다.

---

## 1단계: 환영 + 상태 진단

먼저 현재 환경을 진단한다:

1. **프로젝트 폴더 확인**: `package.json`, `go.mod`, `Cargo.toml`, `pyproject.toml` 중 하나라도 있는지 확인
2. **CLAUDE.md 존재 여부**: 현재 디렉토리 또는 상위에 `CLAUDE.md`가 있는지 확인
3. **Git 초기화 여부**: `.git` 디렉토리 존재 확인
4. **온보딩 완료 여부**: `~/.claude/.forge-onboarded` 마커 파일 존재 확인

진단 결과를 다음 형식으로 출력한다:

```
Claude Forge 가이드에 오신 것을 환영합니다!

현재 상태:
  프로젝트:  [감지된 프로젝트 타입 또는 "프로젝트 파일 없음"]
  CLAUDE.md: [있음 / 없음]
  Git:       [초기화됨 / 안됨]
```

---

## 2단계: 상황별 안내

진단 결과에 따라 분기한다:

### 프로젝트 파일이 없는 경우

```
여기는 프로젝트 폴더가 아닌 것 같습니다.

다음 중 선택하세요:
  1. 기존 프로젝트 폴더로 이동하고 싶다 -> 해당 폴더에서 claude를 다시 실행하세요
  2. 새 프로젝트를 시작하고 싶다 -> /init-project로 프로젝트를 만들 수 있습니다
```

### CLAUDE.md가 없는 경우

```
이 프로젝트에 CLAUDE.md가 없습니다.
CLAUDE.md는 AI에게 이 프로젝트의 규칙을 알려주는 설정 파일입니다.

/init-project를 실행하면 자동으로 생성됩니다.
```

### Git이 초기화되지 않은 경우

```
Git이 초기화되지 않았습니다.
코드 관리와 커밋/PR 기능을 사용하려면 Git이 필요합니다.

git init으로 초기화할 수 있습니다.
```

### 모두 준비된 경우

```
프로젝트가 준비되었습니다!
```

---

## 3단계: 워크플로우 선택

```
뭘 하고 싶으세요?

  1. 새 기능 만들기
     -> /plan [기능 설명]
     예: /plan 로그인 기능 만들기

  2. 버그 수정하기
     -> /tdd [버그 설명]
     예: /tdd 결제 금액이 0원으로 나오는 버그

  3. 코드 정리하기
     -> /refactor-clean
     사용하지 않는 코드를 찾아서 정리합니다

  4. 보안 점검하기
     -> /security-review
     보안 취약점을 자동으로 검사합니다

  5. 전체 자동 모드
     -> /auto [작업 설명]
     계획부터 커밋까지 한 번에 자동 실행

자주 쓰는 커맨드 TOP 6:
  /plan           AI가 구현 계획을 세워줍니다
  /tdd            테스트 먼저 만들고 코드 작성
  /code-review    코드 보안+품질 검사
  /handoff-verify 빌드/테스트/린트 자동 검증
  /commit-push-pr 커밋+푸시+PR 한 번에
  /sync           프로젝트 문서 동기화 (세션 시작/완료 후)
```

---

## 4단계: 온보딩 완료 마커 생성

가이드 출력이 끝나면 마커 파일을 생성한다:

```bash
touch ~/.claude/.forge-onboarded
```

---

## 5단계: 추가 안내

```
더 알고 싶다면:
  docs/FIRST-STEPS.md     - 용어 사전 + 첫 사용자 가이드
  docs/WORKFLOW-RECIPES.md - 상황별 레시피 5가지
  setup/GLOSSARY.md        - 전체 용어 사전
```