JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2351
  • Score
    100M100P100Q92006F
  • License MIT

Claude Code configuration template - copy .claude settings to your project

Package Exports

  • jun-claude-code
  • jun-claude-code/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (jun-claude-code) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

jun-claude-code

Claude Code 설정 템플릿 CLI입니다. 미리 정의된 .claude 설정을 ~/.claude로 복사하여 새 프로젝트에서 빠르게 Claude Code 환경을 구축할 수 있습니다.

설치

# npx로 바로 실행
npx jun-claude-code

# 또는 전역 설치
npm install -g jun-claude-code

사용법

# 기본 실행 (기존 파일이 있으면 덮어쓰기 확인)
jun-claude-code

# 미리보기 (실제 복사 없이 복사될 파일 목록 확인)
jun-claude-code --dry-run

# 강제 덮어쓰기 (확인 없이 모든 파일 복사)
jun-claude-code --force

포함된 설정

Agents (.claude/agents/)

Agent 설명
explore 빠른 코드베이스 탐색
task-planner 작업 계획 수립
code-writer 코드 작성
code-reviewer 셀프 코드 리뷰
git-manager Git 작업 (커밋, PR)
impact-analyzer 사이드이펙트 분석
qa-tester 테스트/빌드 검증
architect 아키텍처 설계
designer UI/UX 스타일링
context-collector Context 수집
context-manager Context 문서 관리

Skills (.claude/skills/)

Skill 설명
Coding 공통 코딩 원칙 (SRP, 응집도, 가독성)
Git Git 커밋/PR 규칙
Backend 백엔드 개발 원칙 (레이어, TypeORM)

Hooks (.claude/hooks/)

  • 워크플로우 순서 강제 프로토콜
  • Skill/Agent 평가 프로토콜

커스터마이징

설치 후 ~/.claude/ 디렉토리에서 필요에 맞게 수정하세요.

~/.claude/
├── CLAUDE.md          # 작업 가이드
├── agents/            # Agent 정의 수정/추가
├── skills/            # Skill 가이드 수정/추가
├── hooks/             # 자동 실행 스크립트
└── context/           # 프로젝트별 Context (직접 추가)

프로젝트별 설정

프로젝트 루트에 .claude/ 폴더를 만들어 프로젝트별 설정을 추가할 수 있습니다.

your-project/
├── .claude/
│   ├── context/       # 프로젝트 아키텍처, 도메인 지식
│   └── skills/        # 프로젝트 전용 스킬
└── CLAUDE.md          # 프로젝트 설명

GitHub Project 연동

init-project 커맨드로 GitHub Project 태스크 관리를 프로젝트에 연동할 수 있습니다.

# 프로젝트 루트에서 실행
jun-claude-code init-project

실행하면 다음을 인터랙티브로 설정합니다:

  1. GitHub Owner (org 또는 user)
  2. Project Number
  3. Repository (owner/repo 형식)

설정 완료 후 프로젝트에 생성되는 파일:

your-project/
├── .claude/
│   ├── project.env                    # GitHub Project 설정 (GITHUB_PROJECT_OWNER 등)
│   ├── settings.json                  # StartSession hook (세션 시작 시 태스크 표시)
│   ├── hooks/
│   │   └── task-loader.sh             # 태스크 조회 스크립트
│   └── agents/
│       └── project-task-manager.md    # 태스크 관리 Agent

수동 설정

init-project 대신 직접 .claude/project.env를 생성할 수도 있습니다:

# .claude/project.env
GITHUB_PROJECT_OWNER=your-org
GITHUB_PROJECT_NUMBER=1
GITHUB_PROJECT_REPO=your-org/your-repo

필요 권한

GitHub Project 접근에 read:project 스코프가 필요합니다:

gh auth refresh -s read:project,project

핵심 원칙

이 템플릿의 핵심 원칙:

  1. Context 절약: Main Agent의 Context Window 보존을 위해 Subagent에 작업 위임
  2. 워크플로우 준수: Planning → Validation → Implementation → Review
  3. Git 작업 위임: 모든 Git 작업은 git-manager Agent 사용

License

MIT