ttipo
700a100a38
규칙과 구현이 어긋나 있던 부분을 바로잡고, 작업하며 발견한 함정을 기록한다.
- 스킬 문서의 "기본 제공 골격" 표를 실제 파일 목록과 일치시킴
- 커밋 전 체크리스트에 테스트 실행·에러 코드 동기화 절차 추가
- 커밋 규칙에 scope·브랜치 전략·PR 규칙 보강
- 새 규칙 파일(api-design, logging)을 CLAUDE.md import 목록에 등록하고,
규칙 추가 시 등록이 필수라는 메타 규칙 명시
- README 를 현재 구조에 맞게 갱신 (traceId·페이지네이션·에러 코드 SSOT·로컬 개발 명령)
작업 중 실제로 겪은 함정들을 규칙으로 남긴다:
- Windows 에서 npm install 하면 Linux 전용 optional 의존성이 lock 에서 잘려
Docker 의 npm ci 가 실패한다 → 의존성 변경은 컨테이너 안에서 수행
- --build 만으로는 node_modules 익명 볼륨이 갱신되지 않아
새 패키지가 컨테이너에 반영되지 않는다 → --renew-anon-volumes 필요
- compose 는 미정의 변수를 빈 문자열로 주입해 Number('')===0 함정이 생긴다
- dev 는 PID 1 이 npm 이라 graceful shutdown 확인은 운영 이미지로 해야 한다
- Redis 는 컨테이너만 떠 있고 사용처가 없다 — 확장 지점임을 명시
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
# 프로젝트 개요
|
|
|
|
이 저장소는 **풀스택 모노레포 기본 템플릿**이다. 누구나 클론하여 바로 개발을 시작할 수 있도록 공통 규칙과 언어별 규칙을 정의한다.
|
|
|
|
| 디렉터리 | 스택 | 역할 | 개발 규칙 (스킬) |
|
|
| ----------- | -------------- | ------------------------ | ----------------------------------------- |
|
|
| `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/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
|