From 6364d6c963eb6915a520c7630c2a4203ae8eb3a7 Mon Sep 17 00:00:00 2001 From: ondal Date: Tue, 14 Oct 2025 15:55:53 +0900 Subject: [PATCH] release --- .claude/commands/design-api.md | 6 + .claude/commands/design-class.md | 14 ++ .claude/commands/design-data.md | 5 + .claude/commands/design-fix-prototype.md | 7 + .claude/commands/design-front.md | 18 ++ .claude/commands/design-help.md | 73 ++++++ .claude/commands/design-high-level.md | 8 + .claude/commands/design-improve-prototype.md | 7 + .claude/commands/design-improve-userstory.md | 4 + .claude/commands/design-logical.md | 6 + .claude/commands/design-pattern.md | 5 + .claude/commands/design-physical.md | 8 + .claude/commands/design-prototype.md | 5 + .claude/commands/design-seq-inner.md | 6 + .claude/commands/design-seq-outer.md | 6 + .claude/commands/design-test-prototype.md | 4 + .claude/commands/design-uiux.md | 5 + .claude/commands/design-update-uiux.md | 4 + .claude/commands/develop-db-guide.md | 4 + .claude/commands/develop-db-install.md | 12 + .claude/commands/develop-db-remove.md | 12 + .claude/commands/develop-dev-backend.md | 12 + .claude/commands/develop-dev-front.md | 15 ++ .claude/commands/develop-fix-backend.md | 7 + .claude/commands/develop-help.md | 47 ++++ .claude/commands/develop-make-run-profile.md | 13 ++ .claude/commands/develop-mq-guide.md | 4 + .claude/commands/develop-mq-install.md | 11 + .claude/commands/develop-mq-remove.md | 10 + .claude/commands/develop-test-backend.md | 15 ++ .claude/commands/think-help.md | 10 + .claude/commands/think-planning.md | 7 + .claude/commands/think-userstory.md | 21 ++ .claude/settings.local.json | 12 + CLAUDE.md | 31 +++ claude/design-prompt.md | 220 +++++++++++++++++++ claude/develop-prompt.md | 180 +++++++++++++++ claude/think-prompt.md | 41 ++++ 38 files changed, 875 insertions(+) create mode 100644 .claude/commands/design-api.md create mode 100644 .claude/commands/design-class.md create mode 100644 .claude/commands/design-data.md create mode 100644 .claude/commands/design-fix-prototype.md create mode 100644 .claude/commands/design-front.md create mode 100644 .claude/commands/design-help.md create mode 100644 .claude/commands/design-high-level.md create mode 100644 .claude/commands/design-improve-prototype.md create mode 100644 .claude/commands/design-improve-userstory.md create mode 100644 .claude/commands/design-logical.md create mode 100644 .claude/commands/design-pattern.md create mode 100644 .claude/commands/design-physical.md create mode 100644 .claude/commands/design-prototype.md create mode 100644 .claude/commands/design-seq-inner.md create mode 100644 .claude/commands/design-seq-outer.md create mode 100644 .claude/commands/design-test-prototype.md create mode 100644 .claude/commands/design-uiux.md create mode 100644 .claude/commands/design-update-uiux.md create mode 100644 .claude/commands/develop-db-guide.md create mode 100644 .claude/commands/develop-db-install.md create mode 100644 .claude/commands/develop-db-remove.md create mode 100644 .claude/commands/develop-dev-backend.md create mode 100644 .claude/commands/develop-dev-front.md create mode 100644 .claude/commands/develop-fix-backend.md create mode 100644 .claude/commands/develop-help.md create mode 100644 .claude/commands/develop-make-run-profile.md create mode 100644 .claude/commands/develop-mq-guide.md create mode 100644 .claude/commands/develop-mq-install.md create mode 100644 .claude/commands/develop-mq-remove.md create mode 100644 .claude/commands/develop-test-backend.md create mode 100644 .claude/commands/think-help.md create mode 100644 .claude/commands/think-planning.md create mode 100644 .claude/commands/think-userstory.md create mode 100644 .claude/settings.local.json create mode 100644 claude/design-prompt.md create mode 100644 claude/develop-prompt.md create mode 100644 claude/think-prompt.md diff --git a/.claude/commands/design-api.md b/.claude/commands/design-api.md new file mode 100644 index 0000000..0662f15 --- /dev/null +++ b/.claude/commands/design-api.md @@ -0,0 +1,6 @@ +``` +@architecture +API를 설계해 주세요: +- '공통설계원칙'과 'API설계가이드'를 준용하여 설계 + +``` diff --git a/.claude/commands/design-class.md b/.claude/commands/design-class.md new file mode 100644 index 0000000..9e7a392 --- /dev/null +++ b/.claude/commands/design-class.md @@ -0,0 +1,14 @@ +``` +@architecture +'공통설계원칙'과 '클래스설계가이드'를 준용하여 클래스를 설계해 주세요. +프롬프트에 '[클래스설계 정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시합니다. +{안내메시지} +'[클래스설계 정보]' 섹션에 아래 예와 같은 정보를 제공해 주십시오. +[클래스설계 정보] +- 패키지 그룹: com.unicorn.tripgen +- 설계 아키텍처 패턴 + - User: Layered + - Trip: Clean + - Location: Layered + - AI: Layered +``` diff --git a/.claude/commands/design-data.md b/.claude/commands/design-data.md new file mode 100644 index 0000000..94e6349 --- /dev/null +++ b/.claude/commands/design-data.md @@ -0,0 +1,5 @@ +``` +@architecture +데이터 설계를 해주세요: +- '공통설계원칙'과 '데이터설계가이드'를 준용하여 설계 +``` diff --git a/.claude/commands/design-fix-prototype.md b/.claude/commands/design-fix-prototype.md new file mode 100644 index 0000000..9c3b19b --- /dev/null +++ b/.claude/commands/design-fix-prototype.md @@ -0,0 +1,7 @@ +``` +@fix as @front +'[오류내용]'섹션에 제공된 오류를 해결해 주세요. +프롬프트에 '[오류내용]'섹션이 없으면 수행 중단하고 안내 메시지 표시 +{안내메시지} +'[오류내용]'섹션 하위에 오류 내용을 제공 +``` diff --git a/.claude/commands/design-front.md b/.claude/commands/design-front.md new file mode 100644 index 0000000..3bcee0e --- /dev/null +++ b/.claude/commands/design-front.md @@ -0,0 +1,18 @@ +``` +@plan as @front +'프론트엔드설계가이드'를 준용하여 **프론트엔드설계서**를 작성해 주세요. +프롬프트에 '[백엔드시스템]'항목이 없으면 수행을 중단하고 안내 메시지를 표시합니다. +{안내메시지} +'[백엔드시스템]' 섹션에 아래 예와 같은 정보를 제공해 주십시오. +[백엔드시스템] +- 시스템: tripgen +- 마이크로서비스: user-service, location-service, trip-service, ai-service +- API문서 + - user service: http://localhost:8081/v3/api-docs + - location service: http://localhost:8082/v3/api-docs + - trip service: http://localhost:8083/v3/api-docs + - ai service: http://localhost:8084/v3/api-docs +[요구사항] +- 각 화면에 Back 아이콘 버튼과 화면 타이틀 표시 +- 하단 네비게이션 바 아이콘화: 홈, 새여행, 주변장소검색, 여행보기 +``` diff --git a/.claude/commands/design-help.md b/.claude/commands/design-help.md new file mode 100644 index 0000000..de14736 --- /dev/null +++ b/.claude/commands/design-help.md @@ -0,0 +1,73 @@ +# 설계 작업 순서 + +## 1단계: UI/UX 설계 +`/design-uiux` +- UI/UX설계가이드를 준용하여 작성 + +## 2단계: 프로토타입 작성 +`/design-prototype` +- 프로토타입작성가이드를 준용하여 작성 + +## 3단계: 프로토타입 테스트 +`/design-test-prototype` +- 프로토타입을 테스트합니다 + +## 4단계: 프로토타입 오류 수정 (필요시) +`/design-fix-prototype` +- 오류 내용을 제공하여 수정합니다 + +## 5단계: 프로토타입 개선 (필요시) +`/design-improve-prototype` +- 개선 내용을 제공하여 개선합니다 + +## 6단계: 유저스토리 업데이트 +`/design-improve-userstory` +- 프로토타입 기준으로 유저스토리를 업데이트합니다 + +## 7단계: UI/UX 설계서 업데이트 +`/design-update-uiux` +- 프로토타입과 유저스토리 기준으로 UI/UX설계서를 수정합니다 + +## 8단계: 클라우드 아키텍처 패턴 선정 +`/design-pattern` +- 클라우드아키텍처패턴선정가이드를 준용하여 작성 + +## 9단계: 논리아키텍처 설계 +`/design-logical` +- 논리아키텍처 설계 가이드를 준용하여 설계 + +## 10단계: 외부 시퀀스 설계 +`/design-seq-outer` +- 외부시퀀스설계가이드를 준용하여 설계 + +## 11단계: 내부 시퀀스 설계 +`/design-seq-inner` +- 내부시퀀스설계 가이드를 준용하여 설계 + +## 12단계: API 설계 +`/design-api` +- API설계가이드를 준용하여 설계 + +## 13단계: 클래스 설계 +`/design-class` +- 클래스설계가이드를 준용하여 설계 +- 패키지 그룹과 아키텍처 패턴 정보 필요 + +## 14단계: 데이터 설계 +`/design-data` +- 데이터설계가이드를 준용하여 설계 + +## 15단계: High Level 아키텍처 정의 +`/design-high-level` +- HighLevel아키텍처정의가이드를 준용하여 작성 +- CLOUD 제공자 정보 필요 (Azure, AWS, Google) + +## 16단계: 물리 아키텍처 설계 +`/design-physical` +- 물리아키텍처설계가이드를 준용하여 설계 +- CLOUD 제공자 정보 필요 + +## 17단계: 프론트엔드 설계 +`/design-front` +- 프론트엔드설계가이드를 준용하여 작성 +- 백엔드 시스템 정보 필요 diff --git a/.claude/commands/design-high-level.md b/.claude/commands/design-high-level.md new file mode 100644 index 0000000..772924e --- /dev/null +++ b/.claude/commands/design-high-level.md @@ -0,0 +1,8 @@ +``` +@architecture +'HighLevel아키텍처정의가이드'를 준용하여 High Level 아키텍처 정의서를 작성해 주세요. +'CLOUD' 정보가 없으면 수행을 중단하고 안내메시지를 표시하세요. +{안내메시지} +아래 예와 같이 CLOUD 제공자를 Azure, AWS, Google과 같이 제공하세요. +- CLOUD: Azure +``` diff --git a/.claude/commands/design-improve-prototype.md b/.claude/commands/design-improve-prototype.md new file mode 100644 index 0000000..d0b946b --- /dev/null +++ b/.claude/commands/design-improve-prototype.md @@ -0,0 +1,7 @@ +``` +@improve as @front +'[개선내용]'섹션에 있는 내용을 개선해 주세요. +프롬프트에 '[개선내용]'항목이 없으면 수행을 중단하고 안내 메시지 표시 +{안내메시지} +'[개선내용]'섹션 하위에 개선할 내용을 제공 +``` diff --git a/.claude/commands/design-improve-userstory.md b/.claude/commands/design-improve-userstory.md new file mode 100644 index 0000000..17433b1 --- /dev/null +++ b/.claude/commands/design-improve-userstory.md @@ -0,0 +1,4 @@ +``` +@analyze as @front 프로토타입을 웹브라우저에서 분석한 후, +@document as @scribe 수정된 프로토타입에 따라 유저스토리를 업데이트 해주십시오. +``` diff --git a/.claude/commands/design-logical.md b/.claude/commands/design-logical.md new file mode 100644 index 0000000..d47ecc3 --- /dev/null +++ b/.claude/commands/design-logical.md @@ -0,0 +1,6 @@ +``` +@architecture +논리 아키텍처를 설계해 주세요: +- '공통설계원칙'과 '논리아키텍처 설계 가이드'를 준용하여 설계 + +``` diff --git a/.claude/commands/design-pattern.md b/.claude/commands/design-pattern.md new file mode 100644 index 0000000..7450f94 --- /dev/null +++ b/.claude/commands/design-pattern.md @@ -0,0 +1,5 @@ +``` +@design-pattern +클라우드 아키텍처 패턴 적용 방안을 작성해 주세요: +- '클라우드아키텍처패턴선정가이드'를 준용하여 작성 +``` diff --git a/.claude/commands/design-physical.md b/.claude/commands/design-physical.md new file mode 100644 index 0000000..14bbd97 --- /dev/null +++ b/.claude/commands/design-physical.md @@ -0,0 +1,8 @@ +``` +@architecture +'물리아키텍처설계가이드'를 준용하여 물리아키텍처를 설계해 주세요. +'CLOUD' 정보가 없으면 수행을 중단하고 안내메시지를 표시하세요. +{안내메시지} +아래 예와 같이 CLOUD 제공자를 Azure, AWS, Google과 같이 제공하세요. +- CLOUD: Azure +``` diff --git a/.claude/commands/design-prototype.md b/.claude/commands/design-prototype.md new file mode 100644 index 0000000..83718ad --- /dev/null +++ b/.claude/commands/design-prototype.md @@ -0,0 +1,5 @@ +``` +@prototype +프로토타입을 작성해 주세요: +- '프로토타입작성가이드'를 준용하여 작성 +``` diff --git a/.claude/commands/design-seq-inner.md b/.claude/commands/design-seq-inner.md new file mode 100644 index 0000000..4bfa2eb --- /dev/null +++ b/.claude/commands/design-seq-inner.md @@ -0,0 +1,6 @@ +``` +@architecture +내부 시퀀스 설계를 해 주세요: +- '공통설계원칙'과 '내부시퀀스설계 가이드'를 준용하여 설계 + +``` diff --git a/.claude/commands/design-seq-outer.md b/.claude/commands/design-seq-outer.md new file mode 100644 index 0000000..b0fab17 --- /dev/null +++ b/.claude/commands/design-seq-outer.md @@ -0,0 +1,6 @@ +``` +@architecture +외부 시퀀스 설계를 해 주세요: +- '공통설계원칙'과 '외부시퀀스설계가이드'를 준용하여 설계 + +``` diff --git a/.claude/commands/design-test-prototype.md b/.claude/commands/design-test-prototype.md new file mode 100644 index 0000000..0cfd241 --- /dev/null +++ b/.claude/commands/design-test-prototype.md @@ -0,0 +1,4 @@ +``` +@test-front +프로토타입을 테스트 해 주세요. +``` diff --git a/.claude/commands/design-uiux.md b/.claude/commands/design-uiux.md new file mode 100644 index 0000000..fee30ec --- /dev/null +++ b/.claude/commands/design-uiux.md @@ -0,0 +1,5 @@ +``` +@uiux +UI/UX 설계를 해주세요: +- 'UI/UX설계가이드'를 준용하여 작성 +``` diff --git a/.claude/commands/design-update-uiux.md b/.claude/commands/design-update-uiux.md new file mode 100644 index 0000000..6cd711d --- /dev/null +++ b/.claude/commands/design-update-uiux.md @@ -0,0 +1,4 @@ +``` +@document @front +현재 프로토타입과 유저스토리를 기준으로 UI/UX설계서와 스타일가이드를 수정해 주세요. +``` diff --git a/.claude/commands/develop-db-guide.md b/.claude/commands/develop-db-guide.md new file mode 100644 index 0000000..f8a8a2e --- /dev/null +++ b/.claude/commands/develop-db-guide.md @@ -0,0 +1,4 @@ +``` +@backing-service +"데이터베이스설치계획서가이드"에 따라 데이터베이스 설치계획서를 작성해 주십시오. +``` diff --git a/.claude/commands/develop-db-install.md b/.claude/commands/develop-db-install.md new file mode 100644 index 0000000..8cb2094 --- /dev/null +++ b/.claude/commands/develop-db-install.md @@ -0,0 +1,12 @@ +``` +@backing-service +[요구사항] +'데이터베이스설치가이드'에 따라 설치해 주세요. +'[설치정보]'섹션이 없으면 수행을 중단하고 안내 메시지를 표시하세요. +{안내메시지} +'[설치정보]'섹션 하위에 아래 예와 같이 설치에 필요한 정보를 추가해 주세요. +- 설치대상환경: 개발환경 +- AKS Resource Group: rg-digitalgarage-01 +- AKS Name: aks-digitalgarage-01 +- Namespace: tripgen-dev +``` diff --git a/.claude/commands/develop-db-remove.md b/.claude/commands/develop-db-remove.md new file mode 100644 index 0000000..525fd53 --- /dev/null +++ b/.claude/commands/develop-db-remove.md @@ -0,0 +1,12 @@ +``` +@backing-service +[요구사항] +- "데이터베이스설치결과서"를 보고 관련된 모든 리소스를 삭제 +- "캐시설치결과서"를 보고 관련된 모든 리소스를 삭제 +- 현재 OS에 맞게 수행 +- 서브 에이젼트를 병렬로 수행하여 삭제 +- 결과파일은 생성할 필요 없고 화면에만 결과 표시 +[참고자료] +- 데이터베이스설치결과서 +- 캐시설치결과서 +``` diff --git a/.claude/commands/develop-dev-backend.md b/.claude/commands/develop-dev-backend.md new file mode 100644 index 0000000..ec641fd --- /dev/null +++ b/.claude/commands/develop-dev-backend.md @@ -0,0 +1,12 @@ +``` +@dev-backend +"백엔드개발가이드"에 따라 개발해 주세요. +프롬프트에 '[개발정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +{안내메시지} +[개발정보] +- 개발 아키텍처패턴 + - auth: Layered + - bill-inquiry: Clean + - product-change: Layered + - kos-mock: Layered +``` diff --git a/.claude/commands/develop-dev-front.md b/.claude/commands/develop-dev-front.md new file mode 100644 index 0000000..c2db89d --- /dev/null +++ b/.claude/commands/develop-dev-front.md @@ -0,0 +1,15 @@ +``` +@dev-front +"프론트엔드개발가이드"에 따라 개발해 주세요. +프롬프트에 '[개발정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +{안내메시지} +'[개발정보]'섹션 하위에 아래 예와 같이 개발에 필요한 정보를 제시해 주세요. +[개발정보] +- 개발프레임워크: Typescript + React 18 +- UI프레임워크: MUI v5 +- 상태관리: Redux Toolkit +- 라우팅: React Router v6 +- API통신: Axios +- 스타일링: MUI + styled-components +- 빌드도구: Vite +``` diff --git a/.claude/commands/develop-fix-backend.md b/.claude/commands/develop-fix-backend.md new file mode 100644 index 0000000..5b4ccb5 --- /dev/null +++ b/.claude/commands/develop-fix-backend.md @@ -0,0 +1,7 @@ +``` +@fix as @back +개발된 각 서비스와 common 모듈을 컴파일하고 에러를 해결해 주세요. +- common 모듈 우선 수행 +- 각 서비스별로 서브 에이젠트를 병렬로 수행 +- 컴파일이 모두 성공할때까지 계속 수행 +``` diff --git a/.claude/commands/develop-help.md b/.claude/commands/develop-help.md new file mode 100644 index 0000000..cd9fd59 --- /dev/null +++ b/.claude/commands/develop-help.md @@ -0,0 +1,47 @@ +# 개발 작업 순서 + +## 1단계: 데이터베이스 설치계획서 작성 +`/develop-db-guide` +- 데이터베이스설치계획서가이드에 따라 작성 + +## 2단계: 데이터베이스 설치 +`/develop-db-install` +- 데이터베이스설치가이드에 따라 설치 +- 설치 대상 환경, AKS 정보, Namespace 필요 + +## 3단계: Message Queue 설치계획서 작성 (필요시) +`/develop-mq-guide` +- MQ설치게획서가이드에 따라 작성 + +## 4단계: Message Queue 설치 (필요시) +`/develop-mq-install` +- MQ설치가이드에 따라 설치 +- 설치 대상 환경, Resource Group, Namespace 필요 + +## 5단계: 백엔드 개발 +`/develop-dev-backend` +- 백엔드개발가이드에 따라 개발 +- 개발 아키텍처 패턴 정보 필요 + +## 6단계: 백엔드 오류 해결 +`/develop-fix-backend` +- common 모듈 우선 수행 후 각 서비스 병렬 처리 + +## 7단계: 서비스 실행파일 작성 +`/develop-make-run-profile` +- 서비스실행파일작성가이드에 따라 작성 +- API Key 정보 필요 (Claude, OpenAI, 기타 필요한 API) + +## 8단계: 백엔드 테스트 +`/develop-test-backend` +- 백엔드테스트가이드에 따라 테스트 +- 테스트 대상 서비스와 API Key 정보 필요 + +## 9단계: 프론트엔드 개발 +`/develop-dev-front` +- 프론트엔드개발가이드에 따라 개발 +- 개발 프레임워크, UI 프레임워크 등 기술 스택 정보 필요 + +## 기타: 리소스 제거 (필요시) +- `/develop-db-remove`: 데이터베이스 리소스 삭제 +- `/develop-mq-remove`: Message Queue 리소스 삭제 diff --git a/.claude/commands/develop-make-run-profile.md b/.claude/commands/develop-make-run-profile.md new file mode 100644 index 0000000..49d0201 --- /dev/null +++ b/.claude/commands/develop-make-run-profile.md @@ -0,0 +1,13 @@ +``` +@test-backend +'서비스실행파일작성가이드'에 따라 테스트를 해 주세요. +프롬프트에 '[작성정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +DB나 Redis의 접근 정보는 지정할 필요 없습니다. 특별히 없으면 '[작성정보]'섹션에 '없음'이라고 하세요. +{안내메시지} +[작성정보] +- API Key + - Claude: sk-ant-ap... + - OpenAI: sk-proj-An4Q... + - Open Weather Map: 1aa5b... + - Kakao API Key: 5cdc24.... +``` diff --git a/.claude/commands/develop-mq-guide.md b/.claude/commands/develop-mq-guide.md new file mode 100644 index 0000000..c184c9b --- /dev/null +++ b/.claude/commands/develop-mq-guide.md @@ -0,0 +1,4 @@ +``` +@backing-service +"MQ설치게획서가이드"에 따라 Message Queue 설치계획서를 작성해 주세요. +``` diff --git a/.claude/commands/develop-mq-install.md b/.claude/commands/develop-mq-install.md new file mode 100644 index 0000000..fddb749 --- /dev/null +++ b/.claude/commands/develop-mq-install.md @@ -0,0 +1,11 @@ +``` +@backing-service +[요구사항] +'MQ설치가이드'에 따라 설치해 주세요. +'[설치정보]'섹션이 없으면 수행을 중단하고 안내 메시지를 표시하세요. +{안내메시지} +'[설치정보]'섹션 하위에 아래 예와 같이 설치에 필요한 정보를 추가해 주세요. +- 설치대상환경: 개발환경 +- Resource Group: rg-digitalgarage-01 +- Namespace: tripgen-dev +``` diff --git a/.claude/commands/develop-mq-remove.md b/.claude/commands/develop-mq-remove.md new file mode 100644 index 0000000..fa04eaf --- /dev/null +++ b/.claude/commands/develop-mq-remove.md @@ -0,0 +1,10 @@ +``` +@backing-service +[요구사항] +- "MQ설치결과서"를 보고 관련된 모든 리소스를 삭제 +- 현재 OS에 맞게 수행 +- 서브 에이젼트를 병렬로 수행하여 삭제 +- 결과파일은 생성할 필요 없고 화면에만 결과 표시 +[참고자료] +- MQ설치결과서 +``` diff --git a/.claude/commands/develop-test-backend.md b/.claude/commands/develop-test-backend.md new file mode 100644 index 0000000..0e78d83 --- /dev/null +++ b/.claude/commands/develop-test-backend.md @@ -0,0 +1,15 @@ +``` +@test-backend +'백엔드테스트가이드'에 따라 테스트를 해 주세요. +프롬프트에 '[테스트정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +테스트 대상 서비스를 지정안하면 모든 서비스를 테스트 합니다. +{안내메시지} +'[테스트정보]'섹션 하위에 아래 예와 같이 테스트에 필요한 정보를 제시해 주세요. +테스트 대상 서비스를 콤마로 구분하여 입력할 수 있으며 전체를 테스트 할 때는 '전체'라고 입력하세요. +- 서비스: user-service +- API Key + - Claude: sk-ant-ap... + - OpenAI: sk-proj-An4Q... + - Open Weather Map: 1aa5b... + - Kakao API Key: 5cdc24.... +``` diff --git a/.claude/commands/think-help.md b/.claude/commands/think-help.md new file mode 100644 index 0000000..ada9a0c --- /dev/null +++ b/.claude/commands/think-help.md @@ -0,0 +1,10 @@ +# 기획 작업 순서 + +## 1단계: 서비스 기획 +`/think-planning` +- AI활용 서비스 기획 가이드를 참고하여 서비스를 기획합니다 + +## 2단계: 유저스토리 작성 +`/think-userstory` +- 유저스토리작성방법을 준용하여 작성합니다 +- 마이크로서비스로 나누어 작성합니다 diff --git a/.claude/commands/think-planning.md b/.claude/commands/think-planning.md new file mode 100644 index 0000000..c40eaec --- /dev/null +++ b/.claude/commands/think-planning.md @@ -0,0 +1,7 @@ +아래 내용을 터미널에 표시만 하고 수행을 하지는 않습니다. +``` +아래 가이드를 참고하여 서비스 기획을 수행합니다. + +https://github.com/cna-bootcamp/aiguide/blob/main/AI%ED%99%9C%EC%9A%A9%20%EC%84%9C%EB%B9%84%EC%8A%A4%20%EA%B8%B0%ED%9A%8D%20%EA%B0%80%EC%9D%B4%EB%93%9C.md + +``` diff --git a/.claude/commands/think-userstory.md b/.claude/commands/think-userstory.md new file mode 100644 index 0000000..b5d5750 --- /dev/null +++ b/.claude/commands/think-userstory.md @@ -0,0 +1,21 @@ +``` +@document +유저스토리를 작성하세요. +프롬프트에 '[요구사항]'섹션이 없으면 수행을 중단하고 안내 메시지를 표시합니다. +{안내메시지} +'[요구사항]' 섹션에 아래 예와 같은 정보를 제공해 주십시오. +[요구사항] +Case 1) 이벤트스토밍을 피그마로 수행한 경우는 피그마 채널ID를 제공 +예) 피그마 채널ID 'abcde'에 접속하여 분석 +Case 2) 다른 방법으로 이벤트스토밍을 한 경우는 요구사항을 정리한 파일 경로를 제공 +예) 요구사항문서 'design/requirement.md'를 읽어 분석 + +프롬프트에 '[요구사항]'섹션이 있으면 아래와 같이 수행합니다. +1. 요구사항 분석 +- 피그마 채널ID가 제공된 경우 figma MCP를 이용하여 해당 채널에 접속하여 분석 +- 요구사항문서 경로가 제공된 경우 해당 문서를 읽어 요구사항을 분석 +2. 유저스토리 작성 +- '유저스토리작성방법'과 '유저스토리예제'를 참고하여 유저스토리를 작성 +- 결과파일은 'design/userstory.md'에 생성 + +``` diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 0000000..6f1d4aa --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,12 @@ +{ + "permissions": { + "allow": [ + "Bash(curl -s https://raw.githubusercontent.com/cna-bootcamp/clauding-guide/refs/heads/main/guides/prompt/04.develop-prompt.md -o claude/develop-prompt.md)", + "Bash(test:*)", + "Bash(mkdir:*)", + "Bash(xargs:*)" + ], + "deny": [], + "ask": [] + } +} diff --git a/CLAUDE.md b/CLAUDE.md index a70c6e4..18df105 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -26,6 +26,12 @@ Backend Developer - 성별/나이: 남자/38세 - 주요경력: 백엔드 개발 12년, 마이크로서비스 아키텍처 설계 전문 +Backend Developer +- 책임: API 설계 및 구현, 데이터베이스 설계, 회의록 처리 로직 개발 +- 이름/별명: 이동욱/동욱 +- 성별/나이: 남자/30대 후반 +- 주요경력: 백엔드 개발 11년, 우아한형제들(배달의민족) 4년 4개월, 인프랩 CTO 및 기술 강의·블로그 운영 4년 6개월 + Frontend Developer - 책임: 회의록 작성/편집 UI 개발, 실시간 협업 인터페이스 구현 - 이름/별명: 최유진/유진 @@ -37,6 +43,31 @@ QA Engineer - 이름/별명: 정도현/도현 - 성별/나이: 남자/36세 - 주요경력: QA 엔지니어링 10년, AI 서비스 품질 검증 전문가 + +서비스 기획자 +- 책임 : 서비스 및 UI/UX 기획 +- 이름/별명 : 이미준/도그냥 +- 성별/나이 : 여자/35세 +- 주요 경력: + - 롯데에서 3년간 서비스 기획자로 근무 + - 카카오스타일에서 5년간 서비스 기획 및 교육 업무 담당 + - 생성형AI 활용 교육 프로그램 다수 진행 + - 서비스 기획 관련 강의 및 컨설팅 경험 보유 + +DevOps +- 책임: 백엔드/프론트엔드 CI/CD 구축(kubernetes, jenkins, ArgoCD) +- 이름/별명: 송주영/주영 +- 성별/나이: 남자/40세 +- 주요경력: Cloud & Container 분야 연구 8년, CI/CD 구축 10년 + +콘텐츠 기획자 +- 책임: 콘텐츠 기획 +- 이름/별명: 백현정/현정 +- 성별/나이: 여자/46세 +- 주요경력: + - 과거 싸이월드, 네이트 등에서 IT 서비스 기획자로 활동 + - 현재는 스마트글라스 TFT에서 디지털 콘텐츠 기획 및 프로토타이핑 담당 + ``` [팀 행동원칙] diff --git a/claude/design-prompt.md b/claude/design-prompt.md new file mode 100644 index 0000000..ea4ce28 --- /dev/null +++ b/claude/design-prompt.md @@ -0,0 +1,220 @@ +# 설계 프롬프트 +아래 순서대로 설계합니다. + +## UI/UX 설계 +command: "/design-uiux" +prompt: +``` +@uiux +UI/UX 설계를 해주세요: +- 'UI/UX설계가이드'를 준용하여 작성 +``` + +--- + +# 프로토타입 작성 +command: "/design-prototype" +prompt: +**1.작성** +``` +@prototype +프로토타입을 작성해 주세요: +- '프로토타입작성가이드'를 준용하여 작성 +``` + +--- + +**2.검증** +command: "/design-test-prototype" +prompt: +``` +@test-front +프로토타입을 테스트 해 주세요. +``` + +--- + +**3.오류수정** +command: "/design-fix-prototype" +prompt: +``` +@fix as @front +'[오류내용]'섹션에 제공된 오류를 해결해 주세요. +프롬프트에 '[오류내용]'섹션이 없으면 수행 중단하고 안내 메시지 표시 +{안내메시지} +'[오류내용]'섹션 하위에 오류 내용을 제공 +``` + +--- + +**4.개선** +command: "/design-improve-prototype" +prompt: +``` +@improve as @front +'[개선내용]'섹션에 있는 내용을 개선해 주세요. +프롬프트에 '[개선내용]'항목이 없으면 수행을 중단하고 안내 메시지 표시 +{안내메시지} +'[개선내용]'섹션 하위에 개선할 내용을 제공 +``` + +--- + +**5.유저스토리 품질 높이기** +command: "/design-improve-userstory" +prompt: +``` +@analyze as @front 프로토타입을 웹브라우저에서 분석한 후, +@document as @scribe 수정된 프로토타입에 따라 유저스토리를 업데이트 해주십시오. +``` + +--- + +**6.설계서 다시 업데이트** +command: "/design-update-uiux" +prompt: +``` +@document @front +현재 프로토타입과 유저스토리를 기준으로 UI/UX설계서와 스타일가이드를 수정해 주세요. +``` + +--- + +## 클라우드 아키텍처 패턴 선정 +command: "/design-pattern" +prompt: +``` +@design-pattern +클라우드 아키텍처 패턴 적용 방안을 작성해 주세요: +- '클라우드아키텍처패턴선정가이드'를 준용하여 작성 +``` + +--- + +## 논리아키텍처 설계 +command: "/design-logical" +prompt: +``` +@architecture +논리 아키텍처를 설계해 주세요: +- '공통설계원칙'과 '논리아키텍처 설계 가이드'를 준용하여 설계 + +``` + +--- + +## 외부 시퀀스 설계 +command: "/design-seq-outer" +prompt: +``` +@architecture +외부 시퀀스 설계를 해 주세요: +- '공통설계원칙'과 '외부시퀀스설계가이드'를 준용하여 설계 + +``` + +--- + +## 내부 시퀀스 설계 +command: "/design-seq-inner" +prompt: +``` +@architecture +내부 시퀀스 설계를 해 주세요: +- '공통설계원칙'과 '내부시퀀스설계 가이드'를 준용하여 설계 + +``` + +--- + +## API 설계 +command: "/design-api" +prompt: +``` +@architecture +API를 설계해 주세요: +- '공통설계원칙'과 'API설계가이드'를 준용하여 설계 + +``` + +--- + +## 클래스 설계 +command: "/design-class" +prompt: +``` +@architecture +'공통설계원칙'과 '클래스설계가이드'를 준용하여 클래스를 설계해 주세요. +프롬프트에 '[클래스설계 정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시합니다. +{안내메시지} +'[클래스설계 정보]' 섹션에 아래 예와 같은 정보를 제공해 주십시오. +[클래스설계 정보] +- 패키지 그룹: com.unicorn.tripgen +- 설계 아키텍처 패턴 + - User: Layered + - Trip: Clean + - Location: Layered + - AI: Layered +``` + +--- + +## 데이터 설계 +command: "/design-data" +prompt: +``` +@architecture +데이터 설계를 해주세요: +- '공통설계원칙'과 '데이터설계가이드'를 준용하여 설계 +``` + +--- + +## High Level 아키텍처 정의서 작성 +command: "/design-high-level" +prompt: +``` +@architecture +'HighLevel아키텍처정의가이드'를 준용하여 High Level 아키텍처 정의서를 작성해 주세요. +'CLOUD' 정보가 없으면 수행을 중단하고 안내메시지를 표시하세요. +{안내메시지} +아래 예와 같이 CLOUD 제공자를 Azure, AWS, Google과 같이 제공하세요. +- CLOUD: Azure +``` + +--- + +## 물리 아키텍처 설계 +command: "/design-physical" +prompt: +``` +@architecture +'물리아키텍처설계가이드'를 준용하여 물리아키텍처를 설계해 주세요. +'CLOUD' 정보가 없으면 수행을 중단하고 안내메시지를 표시하세요. +{안내메시지} +아래 예와 같이 CLOUD 제공자를 Azure, AWS, Google과 같이 제공하세요. +- CLOUD: Azure +``` + +## 프론트엔드 설계 +command: "/design-front" +prompt: +``` +@plan as @front +'프론트엔드설계가이드'를 준용하여 **프론트엔드설계서**를 작성해 주세요. +프롬프트에 '[백엔드시스템]'항목이 없으면 수행을 중단하고 안내 메시지를 표시합니다. +{안내메시지} +'[백엔드시스템]' 섹션에 아래 예와 같은 정보를 제공해 주십시오. +[백엔드시스템] +- 시스템: tripgen +- 마이크로서비스: user-service, location-service, trip-service, ai-service +- API문서 + - user service: http://localhost:8081/v3/api-docs + - location service: http://localhost:8082/v3/api-docs + - trip service: http://localhost:8083/v3/api-docs + - ai service: http://localhost:8084/v3/api-docs +[요구사항] +- 각 화면에 Back 아이콘 버튼과 화면 타이틀 표시 +- 하단 네비게이션 바 아이콘화: 홈, 새여행, 주변장소검색, 여행보기 +``` + diff --git a/claude/develop-prompt.md b/claude/develop-prompt.md new file mode 100644 index 0000000..57c5a06 --- /dev/null +++ b/claude/develop-prompt.md @@ -0,0 +1,180 @@ +# 개발 프롬프트 + +## 데이터베이스 설치계획서 작성 요청 +command: "/develop-db-guide" +prompt: +``` +@backing-service +"데이터베이스설치계획서가이드"에 따라 데이터베이스 설치계획서를 작성해 주십시오. +``` + +--- + +## 데이터베이스 설치 수행 요청 +command: "/develop-db-install" +prompt: +``` +@backing-service +[요구사항] +'데이터베이스설치가이드'에 따라 설치해 주세요. +'[설치정보]'섹션이 없으면 수행을 중단하고 안내 메시지를 표시하세요. +{안내메시지} +'[설치정보]'섹션 하위에 아래 예와 같이 설치에 필요한 정보를 추가해 주세요. +- 설치대상환경: 개발환경 +- AKS Resource Group: rg-digitalgarage-01 +- AKS Name: aks-digitalgarage-01 +- Namespace: tripgen-dev +``` + +--- + +## 데이터베이스 설치 제거 요청 (필요시) +command: "/develop-db-remove" +prompt: +``` +@backing-service +[요구사항] +- "데이터베이스설치결과서"를 보고 관련된 모든 리소스를 삭제 +- "캐시설치결과서"를 보고 관련된 모든 리소스를 삭제 +- 현재 OS에 맞게 수행 +- 서브 에이젼트를 병렬로 수행하여 삭제 +- 결과파일은 생성할 필요 없고 화면에만 결과 표시 +[참고자료] +- 데이터베이스설치결과서 +- 캐시설치결과서 +``` + +--- + +## Message Queue 설치 계획서 작성 요청 +command: "/develop-mq-guide" +prompt: +``` +@backing-service +"MQ설치게획서가이드"에 따라 Message Queue 설치계획서를 작성해 주세요. +``` + +--- + +## Message Queue 설치 수행 요청(필요시) +command: "/develop-mq-install" +prompt: +``` +@backing-service +[요구사항] +'MQ설치가이드'에 따라 설치해 주세요. +'[설치정보]'섹션이 없으면 수행을 중단하고 안내 메시지를 표시하세요. +{안내메시지} +'[설치정보]'섹션 하위에 아래 예와 같이 설치에 필요한 정보를 추가해 주세요. +- 설치대상환경: 개발환경 +- Resource Group: rg-digitalgarage-01 +- Namespace: tripgen-dev +``` + +--- + +## Message Queue 설치 제거 요청 +command: "/develop-mq-remove" +prompt: +``` +@backing-service +[요구사항] +- "MQ설치결과서"를 보고 관련된 모든 리소스를 삭제 +- 현재 OS에 맞게 수행 +- 서브 에이젼트를 병렬로 수행하여 삭제 +- 결과파일은 생성할 필요 없고 화면에만 결과 표시 +[참고자료] +- MQ설치결과서 +``` + +--- + +## 백엔드 개발 요청 +command: "/develop-dev-backend" +prompt: +``` +@dev-backend +"백엔드개발가이드"에 따라 개발해 주세요. +프롬프트에 '[개발정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +{안내메시지} +[개발정보] +- 개발 아키텍처패턴 + - auth: Layered + - bill-inquiry: Clean + - product-change: Layered + - kos-mock: Layered +``` + +--- + +## 백엔드 오류 해결 요청 +command: "/develop-fix-backend" +prompt: +``` +@fix as @back +개발된 각 서비스와 common 모듈을 컴파일하고 에러를 해결해 주세요. +- common 모듈 우선 수행 +- 각 서비스별로 서브 에이젠트를 병렬로 수행 +- 컴파일이 모두 성공할때까지 계속 수행 +``` + +--- + +## 서비스 실행파일 작성 요청 +command: "/develop-make-run-profile" +prompt: +``` +@test-backend +'서비스실행파일작성가이드'에 따라 테스트를 해 주세요. +프롬프트에 '[작성정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +DB나 Redis의 접근 정보는 지정할 필요 없습니다. 특별히 없으면 '[작성정보]'섹션에 '없음'이라고 하세요. +{안내메시지} +[작성정보] +- API Key + - Claude: sk-ant-ap... + - OpenAI: sk-proj-An4Q... + - Open Weather Map: 1aa5b... + - Kakao API Key: 5cdc24.... +``` + +--- + +## 백엔드 테스트 요청 +command: "/develop-test-backend" +prompt: +``` +@test-backend +'백엔드테스트가이드'에 따라 테스트를 해 주세요. +프롬프트에 '[테스트정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +테스트 대상 서비스를 지정안하면 모든 서비스를 테스트 합니다. +{안내메시지} +'[테스트정보]'섹션 하위에 아래 예와 같이 테스트에 필요한 정보를 제시해 주세요. +테스트 대상 서비스를 콤마로 구분하여 입력할 수 있으며 전체를 테스트 할 때는 '전체'라고 입력하세요. +- 서비스: user-service +- API Key + - Claude: sk-ant-ap... + - OpenAI: sk-proj-An4Q... + - Open Weather Map: 1aa5b... + - Kakao API Key: 5cdc24.... +``` + +--- + +## 프론트엔드 개발 요청 +command: "/develop-dev-front" +prompt: +``` +@dev-front +"프론트엔드개발가이드"에 따라 개발해 주세요. +프롬프트에 '[개발정보]'항목이 없으면 수행을 중단하고 안내 메시지를 표시해 주세요. +{안내메시지} +'[개발정보]'섹션 하위에 아래 예와 같이 개발에 필요한 정보를 제시해 주세요. +[개발정보] +- 개발프레임워크: Typescript + React 18 +- UI프레임워크: MUI v5 +- 상태관리: Redux Toolkit +- 라우팅: React Router v6 +- API통신: Axios +- 스타일링: MUI + styled-components +- 빌드도구: Vite +``` \ No newline at end of file diff --git a/claude/think-prompt.md b/claude/think-prompt.md new file mode 100644 index 0000000..208728f --- /dev/null +++ b/claude/think-prompt.md @@ -0,0 +1,41 @@ +# 서비스 기획 프롬프트 + +## 서비스 기획 +command: "/think-planning" +prompt: +아래 내용을 터미널에 표시만 하고 수행을 하지는 않습니다. +``` +아래 가이드를 참고하여 서비스 기획을 수행합니다. + +https://github.com/cna-bootcamp/aiguide/blob/main/AI%ED%99%9C%EC%9A%A9%20%EC%84%9C%EB%B9%84%EC%8A%A4%20%EA%B8%B0%ED%9A%8D%20%EA%B0%80%EC%9D%B4%EB%93%9C.md + +``` + +--- + +## 유저스토리 작성 +command: "/think-userstory" +prompt: + +``` +@document +유저스토리를 작성하세요. +프롬프트에 '[요구사항]'섹션이 없으면 수행을 중단하고 안내 메시지를 표시합니다. +{안내메시지} +'[요구사항]' 섹션에 아래 예와 같은 정보를 제공해 주십시오. +[요구사항] +Case 1) 이벤트스토밍을 피그마로 수행한 경우는 피그마 채널ID를 제공 +예) 피그마 채널ID 'abcde'에 접속하여 분석 +Case 2) 다른 방법으로 이벤트스토밍을 한 경우는 요구사항을 정리한 파일 경로를 제공 +예) 요구사항문서 'design/requirement.md'를 읽어 분석 + +프롬프트에 '[요구사항]'섹션이 있으면 아래와 같이 수행합니다. +1. 요구사항 분석 +- 피그마 채널ID가 제공된 경우 figma MCP를 이용하여 해당 채널에 접속하여 분석 +- 요구사항문서 경로가 제공된 경우 해당 문서를 읽어 요구사항을 분석 +2. 유저스토리 작성 +- '유저스토리작성방법'과 '유저스토리예제'를 참고하여 유저스토리를 작성 +- 결과파일은 'design/userstory.md'에 생성 + +``` +