Claude Code 자율 개발 프로젝트 템플릿. 새 프로젝트를 이 템플릿에서 생성하면 워크플로우가 자동으로 복사됩니다.
GitHub에서 이 레포의 "Use this template" 버튼 클릭 → 레포명 입력 → 생성
레포에서 Claude Code 터미널을 열고:
/install-github-app
→ CLAUDE_CODE_OAUTH_TOKEN 자동 등록
수동 등록 필요:
| Secret | 등록 위치 | 값 |
|---|---|---|
GLOBAL_SETTINGS_TOKEN |
레포 Settings → Secrets → Actions | GitHub PAT (repo 스코프) |
PAPERCLIP_API_KEY |
레포 Settings → Secrets → Actions | Paperclip Board API 키 |
# 프로젝트 설정
## 프로젝트 정보
- 이름: [프로젝트명]
- 스택: [Next.js / React / Node.js 등]
- 패키지 매니저: pnpm
## 명령어
- `pnpm dev` — 개발 서버
- `pnpm build` — 빌드
- `pnpm test` — 테스트
## 프로젝트 고유 규칙
- [프로젝트 특화 규칙 작성]이슈 또는 PR에 댓글:
@claude 로그인 기능 구현해줘
Paperclip 대시보드에서 이슈 생성:
제목: [레포명:브랜치] 작업 내용
설명: 상세 요구사항
예시:
[my-project:dev] 사용자 인증 API 구현
[my-project] README 업데이트
이슈 등록 (todo)
↓ 30분 내 자동 감지
in_progress + 🚀 코멘트
↓
Claude 코드 수정 → 브랜치 push
↓
in_review + 📝 보고서 코멘트
(변경 파일, 커밋 내용 확인)
↓
"승인" 코멘트
↓ 30분 내 자동 감지
PR 자동 생성 + 머지
↓
done + 🎉 PR 머지 완료 코멘트
| 파일 | 트리거 | 역할 |
|---|---|---|
claude.yml |
@claude 댓글 |
Claude Code 즉시 실행 |
claude-code-review.yml |
PR 생성/업데이트 | 자동 코드 리뷰 |
claude-dispatch.yml |
수동 UI / Paperclip dispatch | 태스크 기반 실행 + 승인 후 PR 머지 |
ci-quality-gate.yml |
src/, package.json 변경 시 |
TypeScript · ESLint · 테스트 · 커버리지 80% |
dependabot.yml |
매주 월요일 KST 09:00 | npm · Actions 의존성 자동 업데이트 |
이 프로젝트의 CLAUDE.md는 프로젝트 특화 규칙만 담습니다.
공통 규칙은 my-claude-global 레포에서 관리되며, Actions 실행 시 자동으로 로드됩니다.
우선순위:
1순위: ~/.claude/CLAUDE.md (전역, my-claude-global)
2순위: [프로젝트]/CLAUDE.md (프로젝트 특화, 이 파일)
- dev: 모든 코드 수정은 dev 브랜치에 반영
- main: 전체 점검 통과 후에만 dev → main 머지
- Paperclip 이슈에
[레포:dev]로 지정하면 dev 브랜치 대상으로 실행
project-template/
├── CLAUDE.md # 프로젝트 설정 (수정 필요)
├── README.md # 이 파일
├── .github/
│ ├── dependabot.yml # 의존성 자동 업데이트
│ └── workflows/
│ ├── claude.yml # @claude 댓글 트리거
│ ├── claude-code-review.yml # PR 자동 리뷰
│ ├── claude-dispatch.yml # Paperclip dispatch + 승인 PR
│ └── ci-quality-gate.yml # CI 품질 게이트