{{프로젝트 이름}}

"{{한 줄 슬로건}}"

{{한 줄 소개 — 이 앱이 누구의 어떤 문제를 푸는지}}

---

📖 소개

{{해결하려는 문제와 사용자가 얻는 경험을 2~3줄로.}}

Killer Features

• 🔔 {{기능 1}} — {{한 줄 설명}}
• 📱 {{기능 2}} — {{한 줄 설명}}
• 📍 {{기능 3}} — {{한 줄 설명}}

🛠️ 기술 스택

🏢 iOS 팀 조직도

🥇 1기 · {{YYYY.MM.DD}} – {{YYYY.MM.DD}}	🥈 2기 · 진행 중

기수별 팀원 구성(사진·역할·GitHub)은 Wiki › Team에서, 신규 기능·운영 기록은 Wiki › Release History에서 확인하세요.

📚 개발 문서

아키텍처·코딩 컨벤션·빌드 방법 등 상세 가이드는 docs/claude/ 에 있습니다. 팀 규모가 커지면 Wiki 로 이관하고 아래 표의 링크만 바꾸세요.

주제	문서
🏗️ 아키텍처	architecture.md
📐 절대 규칙 & 코딩 컨벤션	CLAUDE.md · coding-style.md
⚠️ 에러 처리	architecture.md › 에러 처리
🌐 네트워크 & DTO 디코딩	network-router.md · response-dto-decoding.md
🎨 디자인 시스템	design-system.md
🧱 모듈 구조 (Tuist)	build-and-modules.md
⚙️ 빌드 & 실행	AppName/MAKEFILE_GUIDE.md
🔀 Git 워크플로우	git-workflow.md
🔍 PR 리뷰	pr-review.md
🍎 Apple 프레임워크 · 스킬팩	apple-frameworks/INDEX.md
🛰️ OpenAPI 스캐폴딩	SWAGGER_AUTOMATION_GUIDE.md

신규 합류자는 빌드 & 실행 → 아키텍처 → 절대 규칙 순서로 시작하세요.

🔑 시크릿 설정

• Secrets.xcconfig(BASE_URL, KAKAO_KEY 등)와 GoogleService-Info.plist는 팀 내부 채널에서 수령합니다.
• 실제 키·설정 파일은 원격 저장소에 커밋하지 않습니다.
• 상세 절차: AppName/Secrets/README.md

cd AppName
make bootstrap                                       # mise + tuist 설치 (최초 1회)
cp Secrets/Secrets.xcconfig.template Secrets/Secrets.xcconfig
make open                                            # generate + Xcode 열기

---

Made with ❤️ by {{팀 이름}}