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가 공통으로 포함되어 있습니다.
template-java-maven,{' '}
template-java-gradle,{' '}
template-react-ts)을 선택하고 프로젝트 이름을 입력합니다.
),
},
{
title: '로컬에 클론',
content: (
Claude Code를 사용한다면 세션에서 프로젝트 초기화 스킬을 실행합니다.
/init-project가 수행하는 작업:
.githooks/를 로컬 hooks로 연결)
Claude Code를 사용하지 않는 경우에도 Git hooks는 클론 시 포함되어 있으며,{' '}
git config core.hooksPath .githooks로
수동 설정할 수 있습니다.
모든 프로젝트 템플릿에 포함되는 공통 파일입니다. 이 파일들은 Git에 커밋되어 팀 전체가 공유합니다.
.claude/settings.json — 팀 정책 (Git에 커밋). 팀 전체에 적용되는 권한과 규칙..claude/settings.local.json — 개인 확장 (.gitignore). 팀 정책 위에 개인 설정 추가. 없어도 무방..sdkmanrc — JDK 버전.mvn/settings.xml — Maven 설정.sdkmanrc — JDK 버전gradle.properties.example — Gradle 설정 예시.node-version — Node.js 버전.npmrc — npm 레지스트리 (URL만).prettierrc — 코드 포매터/sync-team-workflow를 실행하여 최신 규칙을 동기화하세요.