# 팀 공통 Claude 지침 (gameservice-fe-agent)

이 파일은 팀 전체에서 공통으로 사용하는 Claude 작업 지침의 **엔트리 포인트**입니다.
각 프로젝트의 `CLAUDE.md`에서 `@.claude/common/CLAUDE.md` 형태로 참조하여 사용합니다.

## 적용 범위

- 팀 내 모든 프론트엔드 프로젝트
- Claude Code / Claude 기반 자동화 작업 전반

## 포함된 지침

아래 문서들은 Claude가 이 파일을 읽을 때 자동으로 함께 로드됩니다.

@rules/coding-conventions.md

@rules/framework-rules.md

@rules/commit-pr.md

@rules/claude-workflow.md

@skills/squad-orchestration/docs/automation-guide.md

## 우선순위

1. 프로젝트 `CLAUDE.md`에 명시된 **프로젝트 지침**이 최우선입니다.
2. 이 공통 지침은 프로젝트 지침과 충돌하지 않는 범위 내에서 항상 적용됩니다.
3. 충돌이 발생하면 프로젝트 지침을 따르되, 차이를 사용자에게 알려주세요.

## 공통 Skill

공통 저장소는 `skills/` 폴더에 팀 공용 Claude skill 들을 함께 관리합니다.
프로젝트는 `scripts/link-skills.sh` 로 `.claude/skills/` 에 심볼릭 링크하여 사용합니다.
자세한 내용은 `skills/README.md` 를 참고하세요.

## 업데이트

- 공통 지침은 이 레파지토리(`gameservice-fe-agent`)에서만 수정합니다.
- 각 프로젝트는 `scripts/update.sh`(또는 `git submodule update --remote`)로 최신 버전을 받아갑니다.
- 수정 제안은 PR로 받습니다. 자세한 내용은 루트 `README.md` 참고.

## 주요 명령어 (이 레포에서 작업 시)

```bash
# 프로젝트에 이 레포 설치 (대상 프로젝트에서 실행)
bash scripts/install.sh <repo-url> [branch]

# 공통 skill 을 .claude/skills/ 로 심볼릭 링크
bash .claude/common/scripts/link-skills.sh

# 최신 버전으로 submodule 업데이트 (대상 프로젝트에서 실행)
bash .claude/common/scripts/update.sh
```

## 새 스킬 추가 절차

1. `skills/<skill-name>/SKILL.md` 파일 생성 (YAML frontmatter + 지시문)
2. 필요 시 `skills/<skill-name>/` 하위에 보조 파일 추가
3. PR로 팀 리뷰 후 머지
4. 각 프로젝트에서 `update.sh` + `link-skills.sh` 실행

`SKILL.md` 최소 형식:

```markdown
---
name: <skill-name>
description: <Claude가 이 skill을 언제 써야 하는지 한 줄로>
---
# <스킬 제목>
```

## Behavioral Guidelines

> 불필요한 코드 작성과 섣부른 구현을 방지하기 위한 지침. 단순한 작업은 판단하여 적용.

- **코딩 전 먼저 생각**: 가정하지 말고, 불확실하면 질문. 여러 해석이 가능하면 제시.
- **단순함 우선**: 요청된 것만 구현. 단일 사용 코드에 추상화 금지. 추측성 기능 추가 금지.
- **최소 변경**: 요청에 직접 연결되지 않는 코드는 건드리지 않음. 인접 코드 "개선" 금지.
- **성공 기준 정의**: 복잡한 작업은 검증 가능한 단계로 분리하여 진행.