import { Alert } from '../components/common/Alert'; import { CodeBlock } from '../components/common/CodeBlock'; import { StepGuide } from '../components/common/StepGuide'; export default function StartingProject() { return (

프로젝트 시작하기

팀 템플릿을 사용해 새 프로젝트를 빠르게 시작하는 방법을 안내합니다. 템플릿에서 클론하면 팀 워크플로우가 자동으로 적용됩니다.

{/* 템플릿 비교 */}

프로젝트 템플릿

Gitea gc 조직에서 프로젝트 유형에 맞는 템플릿을 선택합니다.

템플릿 기술 스택 포함 내용
template-java-maven Java + Spring Boot + Maven .sdkmanrc,{' '} .mvn/settings.xml,{' '} Claude 규칙/스킬, Git hooks
template-java-gradle Java + Spring Boot + Gradle .sdkmanrc,{' '} gradle.properties.example,{' '} Claude 규칙/스킬, Git hooks
template-react-ts React + TypeScript + Vite .node-version,{' '} .npmrc,{' '} .prettierrc,{' '} Claude 규칙/스킬, Git hooks
template-common 공통 워크플로우 팀 규칙, Claude 스킬, Git hooks, 버전 관리 (프로젝트 템플릿이 아닌 규칙 원본)
모든 프로젝트 템플릿에는 .claude/ 디렉토리(규칙, 스킬, 설정),{' '} .githooks/(commit-msg, post-checkout),{' '} .editorconfig,{' '} CLAUDE.md가 공통으로 포함되어 있습니다. {/* 새 프로젝트 생성 */}

새 프로젝트 생성

Gitea → gc 조직 → 새 저장소를 클릭합니다. "템플릿에서 생성"에서 프로젝트 유형에 맞는 템플릿(template-java-maven,{' '} template-java-gradle,{' '} template-react-ts)을 선택하고 프로젝트 이름을 입력합니다.

), }, { title: '로컬에 클론', content: ( ), }, { title: 'Claude Code로 초기화 (Claude Code 사용 시)', content: ( <>

Claude Code를 사용한다면 세션에서 프로젝트 초기화 스킬을 실행합니다.

/init-project가 수행하는 작업:

  • Git hooks 경로 설정 (.githooks/를 로컬 hooks로 연결)
  • 워크플로우 버전 검증 및 동기화
  • CLAUDE.md 프로젝트 컨텍스트 확인

Claude Code를 사용하지 않는 경우에도 Git hooks는 클론 시 포함되어 있으며,{' '} git config core.hooksPath .githooks로 수동 설정할 수 있습니다.

), }, { title: 'develop 브랜치 생성', content: ( ), }, { title: '첫 feature 브랜치 시작', content: ( ), }, ]} /> {/* 템플릿 공통 파일 구조 */}

템플릿 공통 파일 구조

모든 프로젝트 템플릿에 포함되는 공통 파일입니다. 이 파일들은 Git에 커밋되어 팀 전체가 공유합니다.

.claude/
rules/ — 팀 코딩 규칙 (code-style, git-workflow, naming, testing, team-policy)
skills/ — 팀 Claude 스킬 (create-mr, fix-issue, init-project, sync-team-workflow)
settings.json — 팀 Claude 권한 정책 (Git에 커밋됨)
settings.local.json — 개인 확장 설정 (.gitignore에 포함, 각자 자유)
.githooks/
commit-msg — Conventional Commits 검증 훅
post-checkout — 체크아웃 후 자동 실행
.editorconfig — 에디터 공통 설정
.gitignore — Git 제외 패턴
CLAUDE.md — 프로젝트 설명서
workflow-version.json — 워크플로우 버전 추적

settings.json vs settings.local.json

  • .claude/settings.json — 팀 정책 (Git에 커밋). 팀 전체에 적용되는 권한과 규칙.
  • .claude/settings.local.json — 개인 확장 (.gitignore). 팀 정책 위에 개인 설정 추가. 없어도 무방.
{/* 템플릿별 추가 파일 */}

템플릿별 추가 파일

template-java-maven

.sdkmanrc — JDK 버전
.mvn/settings.xml — Maven 설정

template-java-gradle

.sdkmanrc — JDK 버전
gradle.properties.example — Gradle 설정 예시

template-react-ts

.node-version — Node.js 버전
.npmrc — npm 레지스트리 (URL만)
.prettierrc — 코드 포매터
팀 워크플로우가 업데이트되면 Claude Code 세션 시작 시 알림이 표시됩니다. /sync-team-workflow를 실행하여 최신 규칙을 동기화하세요. {/* 프로젝트 구조 권장안 */}

권장 프로젝트 구조

Spring Boot (Maven/Gradle)

React + TypeScript

); }