ttipo
7897f2de20
템플릿 점검에서 나온 항목을 한 번에 반영한다. 항목별 이유: - Node 20 → 24 LTS (Dockerfile·CI): Node 20 은 2026-04-30 에 지원이 끝나 보안 패치가 없다 - backend·frontend .dockerignore 추가: `COPY . .` 가 호스트 node_modules(Windows 바이너리)·dist· .env*(시크릿)를 이미지에 넣고 있었다 - 업로드 디렉터리 쓰기 검사(fail-fast): Linux 에서 Docker 가 root 소유로 만든 바인드 마운트에 비-root 앱이 쓰지 못해 첫 업로드에서야 SYS_001 로 터졌다. 기동 시 해결 명령을 안내한다 - DB 커넥션 풀 100 → 10 (DB_POOL_MAX): PostgreSQL 기본 max_connections(100)를 앱 하나가 다 잡았다 - Swagger 운영 기본 비활성 (SWAGGER_ENABLED): API 구조 전체가 공개 도메인에 노출됐다 - 헬스체크 운영 응답에서 오류 상세 제거: 드라이버 오류 문구에 내부 주소·DB 계정명이 담긴다. 원인은 error 로그로 남긴다 - nginx: location 의 add_header 때문에 정적 자원에서 보안 헤더가 빠지던 문제와, index.html 이 캐시돼 배포 직후 빈 화면이 날 수 있던 문제를 고친다 - vite allowedHosts: true 제거 (DEV_ALLOWED_HOSTS): DNS rebinding 보호가 꺼져 있었다 - 전역 설정을 configureApp() 으로 분리해 main.ts 와 e2e 가 공유: e2e 가 설정을 복사해 재현해 실제 설정과 어긋나도 통과할 수 있었다. PORT 도 빈 값을 방어하는 파서를 거친다 - 쓰이지 않던 WEBSOCKET_PORT 제거: 별도 포트는 같은 도메인 라우팅과 맞지 않는다 - 예제 useUser 가 메시지 대신 에러 코드를 보관하도록 수정, testing.md 표 깨짐 수정, settings.json 허용 목록에서 npm install 제거 (Windows lock 파일 규칙과 충돌) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
에이전트 팀원 규칙
이 디렉터리는 역할(누가 무엇까지 책임지는가) 을 정의한다.
어떻게 만드는가는 .claude/skills/, 무엇을 지키는가는 .claude/rules/ 가 담당한다.
.claude/rules/ 무엇을 지키는가 (응답 포맷·에러 코드·보안 …) — 전원 공통
.claude/skills/ 어떻게 만드는가 (nestjs·vue3·flutter·docker) — 스택별
.claude/agents/ 누가 맡는가 (이 디렉터리) — 역할별
역할 목록
| 역할 | 파일 | 주 책임 | 코드 수정 |
|---|---|---|---|
| 백엔드 개발 | backend-dev.md |
backend/ API·도메인 로직 |
O |
| 프론트엔드 개발 | frontend-dev.md |
frontend/ 화면·상태·API 연동 |
O |
| 모바일 개발 | mobile-dev.md |
flutter/ 화면·상태·API 연동 |
O |
| 테스터 | tester.md |
테스트 작성·실행, 계약 테스트 유지 | O (테스트 한정) |
| 리뷰어 | reviewer.md |
공유 계약 위반·규칙 드리프트 점검 | X |
| 인프라/릴리스 | release-ops.md |
compose·env·마이그레이션·배포 | O (인프라 한정) |
| 사용자 관점 | persona-user.md |
일반 사용자 입장의 수용 기준 검토 | X |
| 관리자 관점 | persona-admin.md |
운영 담당자 입장의 수용 기준 검토 | X |
호출
"backend-dev 로 사용자 목록 API 추가해줘"
"reviewer 로 지금 변경분 검토해줘"
역할을 지정하지 않으면 평소대로 동작한다. 역할은 필요할 때 부르는 것이지, 모든 작업을 역할로 나눠야 하는 것은 아니다.
전원 공통 규칙
- 규칙을 복사하지 않는다. 역할 파일은 규칙을 참조만 한다.
응답 포맷·에러 코드·코딩 규칙의 SSOT 는
.claude/rules/와.claude/skills/다. 역할 파일에 같은 내용을 옮겨 적으면 진실 공급원이 둘로 갈라진다 (error-codes 와 같은 이유). - 경계를 넘지 않는다. 담당 범위 밖의 파일이 고쳐져야 한다면, 직접 고치지 말고 무엇이 왜 필요한지 적어 인계한다. 남의 영역을 조용히 고치면 그 영역의 규칙 검토를 건너뛰게 된다.
- 공유 계약은 단독으로 바꾸지 않는다. 응답 포맷·에러 코드·API 규약은 세 클라이언트가 함께 쓰는 계약이다. 변경이 필요하면 checklist 5절 절차를 따르고 영향 범위를 보고한다.
- 완료를 스스로 판정하지 않는다. 각 역할의 "완료 기준"에 적힌 명령을 실제로 실행하고 그 결과를 보고한다. 실행하지 않았으면 "실행하지 않음"이라고 적는다.
- 모든 산출물(주석·커밋·보고)은 한국어 (coding-common).
인계 형식
작업을 마치면 아래 4줄로 보고한다. 길게 쓰지 않는다.
- 한 일:
- 건드린 파일:
- 확인한 것: (실행한 명령과 결과. 실행 못 했으면 그 이유)
- 남은 것/인계: (다음 역할과 넘기는 이유)