gameservice-fe-agent 폴더 구조

팀 공통 Claude 지침 저장소 — 4개 폴더 구조 설명

개요

gameservice-fe-agent는 팀 전체에서 공통으로 사용하는 프론트엔드 Claude 지침 저장소입니다.

각 프로젝트는 이 저장소를 Git submodule로 포함하고, CLAUDE.md의 @import 구문으로 공통 지침을 불러와 사용합니다.

폴더 구조 및 역할

폴더 / 파일 설명 구성
rules/
매 대화마다 자동 로드되는 공통 규칙 모음
CLAUDE.md에서 @import로 불러오며, 모든 작업에 항상 자동으로 적용됩니다.
  • coding-conventions.md — 포맷팅·네이밍·타입
  • framework-rules.md — Vue/Nuxt/Tailwind 규칙
  • commit-pr.md — 커밋 & PR 규칙
  • claude-workflow.md — Claude 작업 방식 지침
4개 규칙 파일
skills/
Claude Code에서 호출할 수 있는 팀 공용 스킬 모음
link-skills.sh로 프로젝트의 .claude/skills/에 심볼릭 링크하여 사용합니다. submodule update 한 번으로 모든 프로젝트가 최신 스킬을 받습니다.
  • conventional-commit
  • markup-edm
  • plan-analyzer
  • plan-translation-generator
  • project-init
  • verify-component-review
  • work-log
7개 스킬
templates/
프로젝트 지침 초기화용 양식 파일 모음
install.sh 실행 시 .claude/project/로 자동 복사됩니다. 팀원은 복사된 양식에 프로젝트 고유 내용을 작성합니다.
  • CLAUDE.md.tpl — 루트 CLAUDE.md 템플릿
  • project/overview.md — 프로젝트 개요 양식
  • project/conventions.md — 프로젝트 컨벤션 양식
  • project/architecture.md — 아키텍처 양식
4개 템플릿
scripts/
프로젝트 설정 및 유지보수 자동화 스크립트
신규 프로젝트 도입부터 업데이트까지 반복 작업을 한 명령으로 처리합니다.
  • install.sh — submodule + 템플릿 복사 + skill 링크
  • init-project.sh — project/ 양식만 재초기화
  • link-skills.sh — 공통 skill 심볼릭 링크 관리
  • update.sh — 최신 공통 지침으로 업데이트
4개 스크립트
CLAUDE.md
README.md
저장소 진입점 문서
CLAUDE.md는 rules/*.md를 @import하는 공통 지침 엔트리 포인트입니다. README.md는 팀원을 위한 사용 가이드입니다.
  • CLAUDE.md — @import rules/* 엔트리
  • README.md — 도입·사용·업데이트 가이드

전체 파일 트리

gameservice-fe-agent/ ├── CLAUDE.md ← 공통 지침 엔트리 포인트 (rules/* @import) ├── README.md ← 도입·사용·업데이트 가이드 │ ├── rules/ ← 항상 자동 로드되는 공통 규칙 │ ├── coding-conventions.md ← 포맷팅, 네이밍, 타입 │ ├── framework-rules.md ← Vue 3 / Nuxt / Tailwind 규칙 │ ├── commit-pr.md ← Conventional Commits, PR 가이드 │ └── claude-workflow.md ← Claude 작업 순서 및 행동 지침 │ ├── skills/ ← 팀 공용 Claude skill 모음 │ ├── README.md │ ├── conventional-commit/ │ │ └── SKILL.md │ ├── markup-edm/ │ │ ├── SKILL.md │ │ ├── assets/ │ │ ├── references/ ← api_reference.md, html-patterns.md │ │ └── scripts/ │ ├── plan-analyzer/ │ │ ├── SKILL.md │ │ ├── references/ ← output-template.md │ │ └── scripts/ ← extract_pptx.py │ ├── plan-translation-generator/ │ │ ├── SKILL.md │ │ └── scripts/ ← generate_translation_keys.py │ ├── project-init/ │ │ └── SKILL.md │ ├── verify-component-review/ │ │ └── SKILL.md │ └── work-log/ │ └── SKILL.md │ ├── templates/ ← 프로젝트 지침 초기화 양식 │ ├── CLAUDE.md.tpl ← 루트 CLAUDE.md 템플릿 │ └── project/ │ ├── overview.md │ ├── conventions.md │ └── architecture.md │ └── scripts/ ← 자동화 스크립트 ├── install.sh ← 신규 프로젝트 도입 (all-in-one) ├── init-project.sh ← project/ 양식만 재초기화 ├── link-skills.sh ← skill 심볼릭 링크 관리 └── update.sh ← 최신 공통 지침 동기화

Skills 목록

conventional-commit
Conventional Commits 규칙에 따른 커밋 메시지 작성 지원
markup-edm
EDM(이메일 마케팅) HTML 마크업 생성 및 패턴 적용
plan-analyzer
기획서(PPT 등)를 분석하여 구조화된 개발 요구사항 도출
plan-translation-generator
기획서 기반 다국어 번역 키 자동 생성
project-init
신규 프로젝트 공통 지침 초기화 가이드
verify-component-review
Vue 컴포넌트 코드 리뷰 및 규칙 준수 검증
work-log
작업 내역 로그 기록 및 정리

프로젝트 도입 흐름

신규 프로젝트에서 install.sh 한 번으로 아래 4단계가 자동 처리됩니다:

1

Submodule 추가

install.sh

.claude/common/ 에 설치

2

템플릿 복사

templates/ → .claude/project/

프로젝트 지침 양식 생성

3

Skill 링크

link-skills.sh

.claude/skills/ 에 심볼릭 링크

4

CLAUDE.md 작성

@import 구문으로 연결

공통 + 프로젝트 지침 로드

핵심 요약

rules/ 의 4개 파일은 모든 Claude 작업에 자동으로 적용되며, templates/로 프로젝트 고유 지침을 초기화하고, skills/로 반복 업무를 스킬 명령으로 자동화합니다.
공통 지침 수정은 이 저장소에서만 진행합니다. 각 프로젝트는 git submodule update --remote 또는 scripts/update.sh로 최신 버전을 동기화합니다.