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로 초기화', content: ( <>

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

이 명령은 팀 워크플로우 규칙, Git hooks, Claude 설정 파일을 자동으로 구성합니다.

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

템플릿 공통 파일 구조

모든 프로젝트 템플릿에 포함되는 공통 파일입니다.

.claude/
rules/ — 팀 규칙 (code-style, git-workflow, naming, testing, team-policy)
skills/ — Claude 스킬 (create-mr, fix-issue, init-project, sync-team-workflow)
settings.json — Claude 권한 설정
.githooks/
commit-msg — Conventional Commits 검증 훅
post-checkout — 체크아웃 후 자동 실행
.editorconfig — 에디터 공통 설정
.gitignore — Git 제외 패턴
CLAUDE.md — 프로젝트 설명서
workflow-version.json — 워크플로우 버전 추적
{/* 템플릿별 추가 파일 */}

템플릿별 추가 파일

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 레지스트리
.prettierrc — 코드 포매터
팀 워크플로우가 업데이트되면 세션 시작 시 알림이 표시됩니다. /sync-team-workflow를 실행하여 최신 규칙을 동기화하세요. {/* 프로젝트 구조 권장안 */}

권장 프로젝트 구조

Spring Boot (Maven/Gradle)

React + TypeScript

); }