ttipo
2f94b6db12
지금까지 .claude 에는 "무엇을 지키는가"(rules)와 "어떻게 만드는가"(skills)만 있었고 "누가 어디까지 책임지는가"를 적을 자리가 없었다. 역할 파일은 규칙을 복사하지 않고 참조만 한다. 구현 규칙을 옮겨 적으면 스킬과 진실 공급원이 둘로 갈라져, 한쪽만 고쳐졌을 때 어느 쪽이 맞는지 알 수 없게 된다. 역할 고유의 것(담당 범위·경계·완료 기준·인계 형식)만 담는다. 리뷰어와 페르소나 둘은 frontmatter 에서 Edit/Write 를 빼 도구 수준으로 읽기 전용이다. CLAUDE.md 에는 @ import 하지 않는다 — 호출 시점에 로드되는 역할 정의다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
3.5 KiB
3.5 KiB
프로젝트 개요
이 저장소는 풀스택 모노레포 기본 템플릿이다. 누구나 클론하여 바로 개발을 시작할 수 있도록 공통 규칙과 언어별 규칙을 정의한다.
| 디렉터리 | 스택 | 역할 | 개발 규칙 (스킬) |
|---|---|---|---|
backend/ |
NestJS (TS) | REST API 서버 | /nestjs → @.claude/skills/nestjs/SKILL.md |
frontend/ |
Vue 3 (TS) | 웹 프론트엔드 | /vue3 → @.claude/skills/vue3/SKILL.md |
flutter/ |
Flutter (Dart) | 모바일 앱 | /flutter → @.claude/skills/flutter/SKILL.md |
| 루트 | Docker Compose | 로컬/운영 오케스트레이션 | /docker → @.claude/skills/docker/SKILL.md |
세 클라이언트는 동일한 표준 응답 포맷과 에러 코드 맵을 공유한다 (아래 공통 규칙 참조).
규칙은
.claude/아래로 모듈화되어 있다.
.claude/rules/— 세 플랫폼 공통 규칙 (코딩·응답 포맷·에러 코드·API 설계·로깅·커밋·보안·환경변수·테스트) 새 규칙 파일을 추가하면 반드시 아래@import 목록에도 등록한다(등록하지 않으면 로드되지 않는다)..claude/skills/— 도메인별 개발 규칙 (스킬). 슬래시 명령(/nestjs등) 또는 해당 디렉터리 작업 시 자동 적용.claude/agents/— 역할별 규칙 (에이전트 팀원). 역할을 지정해 호출할 때 적용@import 하지 않는다 — 규칙이 아니라 호출 시점에 로드되는 역할 정의다 (아래 목록 참조).claude/settings.json— Claude Code 권한·환경 설정
공통 규칙 (모든 디렉터리 적용)
@.claude/rules/coding-common.md @.claude/rules/response-format.md @.claude/rules/error-codes.md @.claude/rules/api-design.md @.claude/rules/logging.md @.claude/rules/git-convention.md @.claude/rules/security.md @.claude/rules/env-structure.md @.claude/rules/testing.md @.claude/rules/checklist.md
도메인별 개발 규칙 (스킬)
- 백엔드(NestJS): @.claude/skills/nestjs/SKILL.md
- 프론트엔드(Vue 3): @.claude/skills/vue3/SKILL.md
- 모바일(Flutter): @.claude/skills/flutter/SKILL.md
- 실행/배포(Docker): @.claude/skills/docker/SKILL.md
역할별 규칙 (에이전트 팀원)
세 층의 역할 분담은 다음과 같다. 규칙은 한 곳에만 적는다 — 역할 파일은 규칙을 참조만 한다.
.claude/rules/ 무엇을 지키는가 — 전원 공통 (위 @import 목록)
.claude/skills/ 어떻게 만드는가 — 스택별
.claude/agents/ 누가 맡는가 — 역할별
| 역할 | 파일 | 코드 수정 |
|---|---|---|
| 백엔드 개발 | .claude/agents/backend-dev.md |
O |
| 프론트엔드 개발 | .claude/agents/frontend-dev.md |
O |
| 모바일 개발 | .claude/agents/mobile-dev.md |
O |
| 테스터 | .claude/agents/tester.md |
O (테스트 한정) |
| 리뷰어 | .claude/agents/reviewer.md |
X |
| 인프라/릴리스 | .claude/agents/release-ops.md |
O (인프라 한정) |
| 사용자 관점 | .claude/agents/persona-user.md |
X |
| 관리자 관점 | .claude/agents/persona-admin.md |
X |
공통 계약(경계·인계 형식·완료 기준)은 .claude/agents/README.md 참조.
역할을 지정하지 않으면 평소대로 동작한다 — 모든 작업을 역할로 나눌 필요는 없다.