81 lines
2.9 KiB
Markdown
81 lines
2.9 KiB
Markdown
# 팀 공통 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
|
|
|
|
> 불필요한 코드 작성과 섣부른 구현을 방지하기 위한 지침. 단순한 작업은 판단하여 적용.
|
|
|
|
- **코딩 전 먼저 생각**: 가정하지 말고, 불확실하면 질문. 여러 해석이 가능하면 제시.
|
|
- **단순함 우선**: 요청된 것만 구현. 단일 사용 코드에 추상화 금지. 추측성 기능 추가 금지.
|
|
- **최소 변경**: 요청에 직접 연결되지 않는 코드는 건드리지 않음. 인접 코드 "개선" 금지.
|
|
- **성공 기준 정의**: 복잡한 작업은 검증 가능한 단계로 분리하여 진행.
|