팀 공통 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

우선순위

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

공통 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 scripts/install.sh <repo-url> [branch]

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

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

새 스킬 추가 절차

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

SKILL.md 최소 형식:

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

Behavioral Guidelines

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

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

2.9 KiB Raw Blame History