project-initializer

새 프로젝트를 프레임워크에 맞게 초기화하고 최신 버전과 모범 사례를 적용합니다. 초기화 완료 후 rule-manager 워크플로우를 참조하여 기본 규칙을 자동 생성합니다. 프로젝트 생성, 프로젝트 초기화, 새 프로젝트, project init, scaffold, boilerplate, 프로젝트 시작, 프로젝트 만들기 요청 시 활성화.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "project-initializer" with this command: npx skills add khw1031/ai-library/khw1031-ai-library-project-initializer

Project Initializer

새 프로젝트를 프레임워크에 맞게 초기화합니다. WebSearch로 최신 정보를 조사하고, 사용자에게 모호한 부분을 질문하며, 완료 후 기본 규칙을 자동 생성합니다.

핵심 원칙

  1. Web Search First - 설치/설정 전 반드시 최신 버전 검색
  2. 모호하면 물어본다 - 선택지 제시 후 사용자 결정 대기
  3. 사용자 확인 필수 - Phase 3에서 전체 기술 스택 확인
  4. 규칙 자동 설정 - Phase 5에서 rule-manager 워크플로우로 기본 규칙 생성

다중 전문가 관점

다음 전문가 관점에서 초기화를 수행합니다:

전문가관점
Architect프로젝트 구조, 모듈 설계, 확장성
DevOps Engineer빌드 도구, CI/CD, 환경 설정
DX Specialist개발자 경험, 린팅, 포맷팅, 스크립트

5-Phase 워크플로우

Phase 1        Phase 2        Phase 3        Phase 4        Phase 5
Discovery  →   Research   →   Decision   →   Execution  →   Finalize
요구사항 파악   최신 정보 수집  기술 스택 확정  프로젝트 생성   검증 + 규칙

Phase 1: Discovery (요구사항 파악)

사용자에게 다음을 확인합니다. 이미 알고 있는 항목은 건너뜁니다.

항목질문기본값
프로젝트 종류"웹앱, API, CLI, 라이브러리 중 어떤 걸 만드시나요?"-
프레임워크"어떤 프레임워크를 사용하시나요?"목적 기반 추천
프로젝트 이름"프로젝트 이름은 무엇인가요?"-
생성 경로"어디에 프로젝트를 생성할까요?"현재 디렉토리
특별 요구사항"추가로 필요한 기능이 있나요?" (DB, 인증 등)없음

프레임워크 미정 시 추천:

목적추천 프레임워크
웹앱 (풀스택)Next.js, Nuxt
웹앱 (SPA)Vite + React/Vue
API 서버NestJS, FastAPI, Go
CLI 도구Commander.js, Click, Cobra
라이브러리tsup, setuptools, cargo

상세 프레임워크 정보: references/framework-profiles.md


Phase 2: Research (최신 정보 수집)

반드시 WebSearch로 다음 항목을 검색합니다:

검색 항목쿼리 패턴목적
프레임워크 최신 버전{framework} latest stable version {year}최신 안정 버전 확인
런타임 LTS{runtime} LTS version {year}호환 런타임 버전 확인
CLI/scaffold 도구{framework} create project CLI {year}공식 생성 도구 확인
권장 프로젝트 구조{framework} recommended project structure모범 사례 구조 확인

검색 결과 기록 형식:

## 검색 결과 요약
- 프레임워크: {name} v{version} (출처: {source})
- 런타임: {runtime} v{version} (LTS)
- CLI 도구: {tool} v{version}
- 권장 구조: {brief description}

상세 검색 전략: references/web-search-strategy.md


Phase 3: Decision (기술 스택 확정)

검색 결과를 바탕으로 기술 스택을 제안하고 사용자 확인을 받습니다.

공통 결정 항목:

항목선택지 예시기본값
패키지 매니저npm, pnpm, yarn, bun / pip, uv, poetry생태계 권장값
언어 설정TypeScript, JavaScript / Python 버전TypeScript
린팅 도구Biome, ESLint, Ruff, golangci-lint프레임워크 기본
포맷터Biome, Prettier, Black, gofmt린터 통합
테스트 프레임워크Vitest, Jest, pytest, go test프레임워크 기본
Git hookshusky, lefthook, pre-commit선택적

확인 형식:

## 기술 스택 확인

| 항목 | 선택 |
|------|------|
| 프레임워크 | {framework} v{version} |
| 런타임 | {runtime} v{version} |
| 패키지 매니저 | {pm} |
| 언어 | {lang} |
| 린팅 | {linter} |
| 포맷팅 | {formatter} |
| 테스트 | {test_framework} |
| 추가 기능 | {features} |

이 스택으로 프로젝트를 생성할까요?

사용자 확인 없이 Phase 4로 진행하지 않습니다.


Phase 4: Execution (프로젝트 생성)

승인받은 스택으로 프로젝트를 생성합니다. 다음 순서를 따릅니다:

Step 1: 환경 확인

# 런타임 버전 확인
{runtime} --version

# 패키지 매니저 확인 (없으면 설치)
{pm} --version

Step 2: 프로젝트 Scaffold

# 프레임워크 공식 CLI로 프로젝트 생성
{scaffold_command} {project_name}
cd {project_name}

Step 3: 추가 패키지 설치

Phase 3에서 확정된 추가 기능에 따라 패키지를 설치합니다.

# 런타임 의존성
{pm} add {runtime_deps}

# 개발 의존성
{pm} add -D {dev_deps}

Step 4: 설정 파일 구성

  • 린터/포맷터 설정 파일
  • 환경 변수 파일 (.env, .env.example)
  • 에디터 설정 (.editorconfig)

Step 5: Git 초기화

# scaffold에서 이미 생성된 경우 건너뜀
git init
git add .
git commit -m "Initial commit: {framework} project setup"

상세 Phase별 절차: references/phases.md


Phase 5: Finalize (검증 + 규칙 생성)

5-1. 빌드 검증

프로젝트가 정상 동작하는지 검증합니다:

# 1. 린트 검사
{pm} {lint_script}

# 2. 빌드 테스트
{pm} {build_script}

# 3. 테스트 실행
{pm} {test_script}

# 4. 개발 서버 실행 (빠르게 확인 후 종료)
{pm} {dev_script}

검증 실패 시 즉시 수정 후 재검증합니다.

5-2. 기본 규칙 자동 생성

rule-manager 워크플로우를 참조하여 프로젝트에 기본 규칙을 생성합니다.

대상 경로: 초기화된 프로젝트의 .claude/skills/

기본 규칙 카테고리:

카테고리규칙 내용user-invocable
코딩 컨벤션네이밍, 포맷팅, 파일 구조false
Git 컨벤션커밋 메시지, 브랜치 전략false
프로젝트 구조디렉토리 규칙, 모듈 구성false

상세 규칙 생성 가이드: references/rule-integration.md

5-3. 완료 보고

## 프로젝트 초기화 완료

### 프로젝트 정보
- **이름**: {project_name}
- **경로**: {project_path}
- **프레임워크**: {framework} v{version}
- **런타임**: {runtime} v{version}

### 설치된 패키지
| 패키지 | 버전 | 용도 |
|--------|------|------|
| ... | ... | ... |

### 사용 가능한 스크립트
| 명령어 | 설명 |
|--------|------|
| `{pm} dev` | 개발 서버 실행 |
| `{pm} build` | 프로덕션 빌드 |
| `{pm} test` | 테스트 실행 |
| `{pm} lint` | 린트 검사 |

### 생성된 규칙
| 규칙 | 경로 |
|------|------|
| ... | .claude/skills/... |

### 다음 단계 권장사항
1. {recommendation_1}
2. {recommendation_2}
3. {recommendation_3}

실행 체크리스트

[ ] Phase 1: 프로젝트 종류, 프레임워크, 이름, 경로 확인
[ ] Phase 2: 최신 버전 WebSearch 완료 (4개 항목)
[ ] Phase 2: 검색 결과 기록 완료
[ ] Phase 3: 기술 스택 제안 완료
[ ] Phase 3: 사용자 확인 완료
[ ] Phase 4: 환경 확인 완료
[ ] Phase 4: scaffold 실행 완료
[ ] Phase 4: 추가 패키지 설치 완료
[ ] Phase 4: 설정 파일 구성 완료
[ ] Phase 4: Git 초기화 완료
[ ] Phase 5: 빌드 검증 통과
[ ] Phase 5: 기본 규칙 자동 생성 완료

에러 처리

상황대응
scaffold 실패CLI 도구 버전 확인 → 재설치 → 재시도
패키지 충돌호환 버전 WebSearch → 버전 조정
빌드 실패에러 로그 분석 → 설정 수정 → 재검증
런타임 미설치설치 안내 → 사용자 확인 후 설치

상세 가이드

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

financial-insurance-guide

No summary provided by upstream source.

Repository SourceNeeds Review
General

financial-investment-guide

No summary provided by upstream source.

Repository SourceNeeds Review
General

financial-debt-management

No summary provided by upstream source.

Repository SourceNeeds Review