템플릿 리브랜딩

Next.js(및 NestJS) 프로젝트 리브랜딩

순서대로 단계를 진행하세요. 모든 단계는 검사로 끝납니다: 검사를 실행하고, 발견된 문제를 수정한 후에만 다음 단계로 넘어가세요. CHECK는 프로젝트 루트에서 다음 명령어를 실행하는 것을 의미합니다:

node ${CLAUDE_SKILL_DIR}/scripts/rebrand-check.mjs check \
  --old "이전 이름" --old "다른 스크립트의 이전 이름" \
  --new "새 이름" --new "다른 스크립트의 새 이름"

이전 이름이 일반 단어(STORE)인 경우 --case를 추가하고, 의도적으로 이전 이름을 유지하는 파일에는 --allow <path>를 사용하세요. 절대 무작정 find-and-replace를 실행하지 마세요.

0. 브리핑, 맵 및 기준선

1. 프로젝트에서 사용하는 모든 형태의 이전 이름(각 언어, 슬러그, 이메일 도메인)과 새 이름(각 언어), 브랜드 색상, 로고 파일, 톤을 기록하세요. 요청에서 누락된 항목이 있으면 적절한 값을 선택하고 계속 진행한 후 보고서에 선택 사항을 나열하세요.
2. node ${CLAUDE_SKILL_DIR}/scripts/rebrand-check.mjs map을 실행하세요.
3. 편집 전에 맵에 있는 각 앱의 빌드 명령어를 한 번 실행하세요.

검사: 맵, 줄여야 할 CHECK 히트 수, 모든 빌드 결과가 있어야 합니다. 이미 실패한 빌드는 리브랜딩으로 인한 것이 아님을 기록하세요.

1. 이름 및 워드마크

브랜드 설정 파일, 로고 컴포넌트, 웹 앱 매니페스트, 시드가 작성하는 모든 설정 행(이메일 발신자 이름이 여기에 있는 경우가 많음)을 변경하세요. 패키지 이름, 환경 변수 이름, 데이터베이스 이름, Docker 볼륨 및 스토리지 접두사는 요청하지 않는 한 그대로 두세요. 이름을 바꾸면 설치 및 기존 데이터가 손상됩니다.

검사: CHECK에서 "brand config" 아래에 0개의 히트가 표시됩니다. 유지한 인프라 히트는 보고서에 포함하세요.

2. 색상

맵에 나열된 테마 파일의 브랜드 토큰(라이트 및 다크)과 매니페스트 또는 뷰포트의 브라우저 테마 색상을 변경하세요. 컴포넌트에 색상을 직접 작성하지 마세요.

검사: 각 이전 브랜드 색상에 대해 --old "#구헥스"를 사용한 CHECK에서 0개의 히트가 표시되고, 새 색상의 텍스트는 두 테마 모두에서 4.5:1 명암비를 유지합니다.

3. 로고 및 아이콘 파일

맵에 나열된 워드마크, 마크, 파비콘, 앱 아이콘 및 공유 이미지를 교체하세요. 파일 이름과 크기를 유지하거나 모든 참조를 업데이트하세요. 각 새 파일을 열어 확인하세요.

검사: CHECK에서 public/에 누락된 그림 경로가 0개, 의도적으로 유지한 파일 외에는 이전 이름이 포함된 파일 또는 폴더 이름이 0개라고 보고합니다.

4. 모든 로케일의 카피

단순히 이름만 바꾸지 말고 다시 작성하세요: 히어로, 어바웃, 푸터, 법적, 지원, SEO 및 이전 비즈니스를 설명하는 모든 문장. 모든 로케일에서 동일한 키를 사용하고, 각 언어는 해당 언어로 작성하세요.

검사: CHECK에서 "messages" 아래에 0개의 히트가 표시되고, 어떤 로케일 또는 메시지 파일에도 한 언어에는 새 이름이 있지만 다른 언어에는 없는 경우가 없습니다.

5. 메타데이터 및 SEO

루트 및 페이지 레이아웃, generateMetadata, 타이틀 템플릿, Open Graph 및 Twitter 필드, JSON-LD, 사이트맵, robots, 매니페스트 name 및 short_name을 변경하세요.

검사: CHECK에서 "metadata and SEO" 아래에 0개의 히트가 표시됩니다.

6. 이메일

API가 전송하는 모든 언어의 발신자 이름, 제목, 헤더 및 푸터, 링크를 변경하세요. 발신자 주소와 도메인은 환경 변수에서 가져옵니다: 보고서에 나열하세요.

검사: CHECK에서 "emails" 아래에 0개의 히트가 표시됩니다.

7. 시드 및 모의 데이터

시더, 픽스처 및 모의 카탈로그: 제품, 카테고리, 설정 행, 데모 계정 이메일 도메인, 이미지 경로를 변경하세요. API 시드와 프론트엔드 모의 데이터가 일치해야 합니다.

검사: CHECK에서 "seed data" 아래에 0개의 히트가 표시됩니다.

8. 빌드 및 최종 검사

맵에 있는 각 앱의 빌드 명령어를 다시 실행하세요. 모든 오류를 수정하여 각 빌드가 통과할 때까지 반복하세요. 요청하지 않는 한 개발 또는 프로덕션 서버를 시작하지 마세요.

검사: 모든 빌드가 0으로 종료되고, CHECK에서 Result: PASS를 출력합니다.

보고서

단계별로 변경된 파일, 브리핑에서 누락된 항목에 대해 선택한 사항, 허용된 각 히트와 그 이유, 빌드 결과, 그리고 사람에게 남은 작업(도메인, DNS, 이메일 발신자, 법적 텍스트)을 포함하세요.