Initial commit: 프로젝트 초기 구성

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.claude/skills/gitea-workflow.md

@@ -0,0 +1,163 @@
+# Gitea 워크플로우 (Gitea Workflow)
+
+이 프로젝트의 Gitea 리포지토리 관리 워크플로우입니다.
+
+## Gitea 서버 정보
+
+- **URL**: http://gitea.yakenator.io
+- **조직**: yakenator
+- **사용자**: yakenator
+- **비밀번호**: asdfg23we
+
+## 새 리포지토리 생성
+
+### 1. Gitea CLI (tea) 사용
+```bash
+# tea 설치 (macOS)
+brew install tea
+
+# 로그인
+tea login add --url http://gitea.yakenator.io --user yakenator --password asdfg23we
+
+# 리포지토리 생성
+tea repo create --name {repo-name} --org yakenator --private=false
+```
+
+### 2. API 사용
+```bash
+# 리포지토리 생성
+curl -X POST "http://gitea.yakenator.io/api/v1/orgs/yakenator/repos" \
+  -H "Content-Type: application/json" \
+  -u "yakenator:asdfg23we" \
+  -d '{
+    "name": "{repo-name}",
+    "description": "서비스 설명",
+    "private": false,
+    "auto_init": false
+  }'
+```
+
+### 3. 웹 UI 사용
+1. http://gitea.yakenator.io 접속
+2. yakenator / asdfg23we 로 로그인
+3. yakenator 조직 선택
+4. "New Repository" 클릭
+5. 리포지토리 정보 입력 후 생성
+
+## 새 프로젝트 초기화 및 푸시
+
+### 전체 워크플로우
+```bash
+# 1. 프로젝트 디렉토리 생성
+mkdir ./repos/{new-service}
+cd ./repos/{new-service}
+
+# 2. Git 초기화
+git init
+
+# 3. 파일 생성 (Dockerfile, requirements.txt, worker.py 등)
+
+# 4. 첫 커밋
+git add -A
+git commit -m "Initial commit: {service-name} 서비스 초기 구성
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+
+# 5. Gitea에 리포지토리 생성 (API)
+curl -X POST "http://gitea.yakenator.io/api/v1/orgs/yakenator/repos" \
+  -H "Content-Type: application/json" \
+  -u "yakenator:asdfg23we" \
+  -d '{"name": "{new-service}", "private": false}'
+
+# 6. Remote 추가 및 푸시
+git remote add origin http://yakenator:asdfg23we@gitea.yakenator.io/yakenator/{new-service}.git
+git branch -M main
+git push -u origin main
+```
+
+## 기존 리포지토리 클론
+
+```bash
+# HTTP 클론 (인증 포함)
+git clone http://yakenator:asdfg23we@gitea.yakenator.io/yakenator/{repo-name}.git
+
+# 또는 클론 후 credential 설정
+git clone http://gitea.yakenator.io/yakenator/{repo-name}.git
+cd {repo-name}
+git config credential.helper store
+```
+
+## 리포지토리 URL 패턴
+
+```
+http://gitea.yakenator.io/yakenator/{repo-name}.git
+```
+
+### 현재 등록된 리포지토리
+| 서비스 | URL |
+|--------|-----|
+| news-commons | http://gitea.yakenator.io/yakenator/news-commons.git |
+| news-article-generator | http://gitea.yakenator.io/yakenator/news-article-generator.git |
+| news-article-translator | http://gitea.yakenator.io/yakenator/news-article-translator.git |
+| news-biocode-service | http://gitea.yakenator.io/yakenator/news-biocode-service.git |
+| news-google-search | http://gitea.yakenator.io/yakenator/news-google-search.git |
+| news-image-generator | http://gitea.yakenator.io/yakenator/news-image-generator.git |
+| news-rss-collector | http://gitea.yakenator.io/yakenator/news-rss-collector.git |
+| news-tts-generator | http://gitea.yakenator.io/yakenator/news-tts-generator.git |
+| news-wikipedia-enrichment | http://gitea.yakenator.io/yakenator/news-wikipedia-enrichment.git |
+| news-user-service | http://gitea.yakenator.io/yakenator/news-user-service.git |
+| mcp_biocode | http://gitea.yakenator.io/yakenator/mcp_biocode.git |
+| base-auth | http://gitea.yakenator.io/yakenator/base-auth.git |
+| base-image | http://gitea.yakenator.io/yakenator/base-image.git |
+
+## 커밋 및 푸시
+
+```bash
+# 변경사항 확인
+git status
+
+# 스테이징 및 커밋
+git add -A
+git commit -m "$(cat <<'EOF'
+feat: 기능 설명
+
+- 변경사항 1
+- 변경사항 2
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+EOF
+)"
+
+# 푸시
+git push
+```
+
+## 브랜치 전략
+
+```bash
+# 기본 브랜치: main
+# 기능 브랜치: feature/{기능명}
+# 버그 수정: fix/{버그설명}
+
+# 브랜치 생성 및 전환
+git checkout -b feature/new-feature
+
+# 작업 후 푸시
+git push -u origin feature/new-feature
+
+# PR 생성 (웹 UI 또는 API)
+```
+
+## 주의사항
+
+- 모든 서비스는 `yakenator` 조직 아래에 생성
+- 리포지토리 이름은 `news-{서비스명}` 패턴 사용
+- 민감 정보(.env, credentials)는 절대 커밋하지 않음
+- .gitignore에 다음 항목 포함:
+  ```
+  .env
+  __pycache__/
+  *.pyc
+  node_modules/
+  .DS_Store
+  ```