Files
project-base/CLAUDE.md
T
ttipo 6306160dda refactor: .claude 규칙 체계를 skills·rules 구조로 재편
- 슬래시 커맨드(nestjs/vue3/flutter)를 정식 스킬(.claude/skills)로 전환하고
  docker 스킬을 신설(루트 command.md 이관)
- 공통 규칙을 .claude/rules 로 모듈화(coding-common·response-format·error-codes·
  git-convention·security·env-structure·testing·checklist)하고 CLAUDE.md 에서 @import
- 파일·식별자 네이밍 규약, 테스트 규칙 추가
- .claude/settings.json(권한·환경) 추가
- CLAUDE.md·README.md 참조 갱신, 단독 실행(non-Docker) 안내 정리

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-28 13:58:01 +09:00

1.9 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/ — 세 플랫폼 공통 규칙 (코딩·응답 포맷·에러 코드·커밋·보안·환경변수)
  • .claude/skills/ — 도메인별 개발 규칙 (스킬). 슬래시 명령(/nestjs 등) 또는 해당 디렉터리 작업 시 자동 적용
  • .claude/settings.json — Claude Code 권한·환경 설정

공통 규칙 (모든 디렉터리 적용)

@.claude/rules/coding-common.md @.claude/rules/response-format.md @.claude/rules/error-codes.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