jun-claude-code 0.2.5 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jun-claude-code",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "description": "Claude Code configuration template - copy .claude settings to your project",
   "main": "dist/index.js",
   "bin": "dist/cli.js",

package/templates/global/agents/context-collector.md

@@ -28,19 +28,29 @@ color: blue
 요청을 분석하여 코드 탐색 전략을 결정합니다.
 
 - 요청의 핵심 키워드와 도메인 영역을 식별
-- 탐색 대상: Skill/Agent 문서 → 소스 코드 순서로 진행
+- 탐색 대상: context 문서 → Skill/Agent 문서 → 소스 코드 순서로 진행
 - 탐색 범위를 판단하여 효율적으로 수집
 
-### Step 2: Skill 및 Agent 탐색
+### Step 2: .claude/context/ 사전 확인
+
+프로젝트 맥락을 먼저 파악합니다.
+
+```
+- .claude/context/ 하위 INDEX.md들을 읽어 프로젝트 전체 맥락 파악
+- 요청과 관련된 상세 문서(codebase/, business/, architecture/)가 있으면 확인
+- 이미 문서화된 내용은 소스 코드 탐색 범위에서 제외하여 효율화
+```
+
+### Step 3: Skill 및 Agent 탐색
 
 ```
 - .claude/skills/ 에서 작업에 필요한 Skill 확인
 - .claude/agents/ 에서 관련 Agent 확인
 ```
 
-### Step 3: 소스 코드 DEEP 탐색
+### Step 4: 소스 코드 DEEP 탐색
 
-실제 소스 코드를 직접 탐색하여 패턴과 구현 방식을 파악합니다.
+context 문서에서 파악한 맥락을 기반으로 더 정확하게 탐색합니다.
 
 ```
 - 유사한 기존 구현 찾기 (Grep, Glob 활용)
@@ -51,7 +61,7 @@ color: blue
 - import/export 관계 추적
 ```
 
-### Step 4: Context 요약 출력
+### Step 5: Context 요약 출력
 
 수집한 모든 정보를 output_format에 맞춰 정리합니다.
 
@@ -68,6 +78,10 @@ color: blue
 - **탐색 범위**: (어떤 영역을 탐색했는지)
 - **판단 근거**: (왜 이 범위를 탐색했는지)
 
+## 0. 프로젝트 맥락 (context 문서 기반)
+- **참조한 문서**: (확인한 .claude/context/ 문서 목록)
+- **핵심 맥락**: (프로젝트 배경, 관련 도메인/모듈 정보)
+
 ## 1. 소스 코드 탐색 결과
 | 파일 | 확인 내용 | 핵심 발견 |
 |------|----------|----------|
@@ -97,7 +111,7 @@ color: blue
 
 ## 제약사항
 
-- `.claude/context/` 문서는 탐색하지 않습니다. 프로젝트 배경 정보가 필요하면 project-context-collector Agent를 안내합니다.
-- 실제 소스 코드와 `.claude/skills/`, `.claude/agents/` 문서만 탐색합니다.
+- `.claude/context/` 문서를 사전 참조하여 프로젝트 맥락을 파악합니다.
+- 상세한 프로젝트 배경 정보가 필요하면 project-context-collector Agent를 추가로 안내합니다.
 
 </constraints>

package/templates/global/hooks/_dedup.sh

@@ -22,7 +22,9 @@ _hook_dedup_check() {
   if [ "$self_dir" = "$global_dir" ]; then
     # project-level 동일 hook이 존재하면 → global은 skip
     local project_hook
-    project_hook="$(pwd)/.claude/hooks/$hook_name"
+    local project_root
+    project_root="$(git rev-parse --show-toplevel 2>/dev/null)"
+    project_hook="${project_root:-.}/.claude/hooks/$hook_name"
     if [ -f "$project_hook" ]; then
       return 1  # global yields to project → skip
     fi

package/templates/global/hooks/skill-forced-subagent.sh

@@ -7,7 +7,8 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
 GLOBAL_CLAUDE_DIR="$HOME/.claude"
-PROJECT_CLAUDE_DIR="$(pwd)/.claude"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
+PROJECT_CLAUDE_DIR="${PROJECT_ROOT:-.}/.claude"
 
 # Dedup: project 우선, global은 project 버전 존재 시 양보
 if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then

package/templates/global/hooks/skill-forced.sh

@@ -7,7 +7,8 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
 GLOBAL_CLAUDE_DIR="$HOME/.claude"
-PROJECT_CLAUDE_DIR="$(pwd)/.claude"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
+PROJECT_CLAUDE_DIR="${PROJECT_ROOT:-.}/.claude"
 
 # Dedup: project 우선, global은 project 버전 존재 시 양보
 if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then

package/templates/global/hooks/workflow-enforced.sh

@@ -7,7 +7,8 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
 GLOBAL_CLAUDE_DIR="$HOME/.claude"
-PROJECT_CLAUDE_DIR="$(pwd)/.claude"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
+PROJECT_CLAUDE_DIR="${PROJECT_ROOT:-.}/.claude"
 
 # Dedup: project 우선, global은 project 버전 존재 시 양보
 if [ -f "$SCRIPT_DIR/_dedup.sh" ]; then
@@ -41,9 +42,11 @@ Plan 파일의 Context 섹션에 위 내용을 명시하여 작업 목적이 희
 ### Step 1.2: Context 수집
 
 - [ ] EnterPlanMode 진입 (복잡한 작업인 경우)
-- [ ] 관련 Context 문서 확인 (.claude/context/)
+- [ ] **병렬 Context 수집 (정확도 향상)**:
+  - `project-context-collector` → .claude/context/ 문서에서 프로젝트 배경 수집
+  - `context-collector` → 소스 코드 + .claude/context/ 에서 패턴/구현 방식 수집
+  - 두 Agent를 병렬로 호출하여 작업 속도와 정확도를 높인다
 - [ ] 필요한 Skill 활성화 (.claude/skills/)
-- [ ] 기존 코드 탐색 (Explore Agent 또는 직접 탐색)
 
 ### Step 1.3: TaskList 생성
 

package/templates/project/agents/context-generator.md

@@ -8,7 +8,7 @@ color: green
 
 # Context Generator Agent
 
-PR의 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/business 문서를 자동 생성하고 업데이트합니다.
+PR의 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/business/architecture 문서를 자동 생성하고 업데이트합니다.
 
 ## 실행 조건
 
@@ -17,7 +17,14 @@ PR의 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/busine
 
 ## 프로세스
 
-### 1. Diff 수집
+### 1. PR 정보 분석
+
+PR title/body에서 변경의 의도와 기대효과를 파악합니다.
+- PR 제목에서 핵심 변경 의도 추출
+- PR 본문에서 배경, 기대효과, 관련 이슈 파악
+- 이후 단계에서 context 문서 작성 시 반영
+
+### 2. Diff 수집
 
 ```bash
 git diff HEAD~1 --name-only
@@ -25,34 +32,52 @@ git diff HEAD~1 --name-only
 
 변경된 파일 목록을 수집합니다.
 
-### 2. 모듈 매핑
+### 3. 모듈 매핑
 
-변경된 파일을 모듈 단위로 그룹화합니다.
+변경된 파일을 모듈/토픽 단위로 그룹화합니다.
 - `src/cli.ts` → `cli` 모듈
 - `src/copy.ts` → `copy-logic` 모듈
 - `.claude/agents/*.md` → `agents` 모듈
+- `Dockerfile` → `deployment` 토픽
+- `.github/workflows/*.yml` → `ci-cd` 토픽
 
-### 3. 기존 Context 확인
+### 4. 기존 Context 확인
 
-`.claude/context/codebase/`와 `.claude/context/business/`에서 기존 문서를 확인합니다.
+`.claude/context/codebase/`, `.claude/context/business/`, `.claude/context/architecture/`에서 기존 문서를 확인합니다.
 - 기존 문서가 있으면 → 업데이트
 - 기존 문서가 없으면 → 새로 생성
 
-### 4. Codebase Context 생성
+### 5. Codebase Context 생성
 
 [ContextGeneration Skill](../../skills/ContextGeneration/SKILL.md)의 Codebase 규칙에 따라:
-- 모듈별 `.md` 파일 생성/업데이트
+- PR 의도를 반영하여 모듈별 `.md` 파일 생성/업데이트
 - 파일 경로와 함수명만 참조 (원본 코드 포함 금지)
 - `codebase/INDEX.md` 업데이트
 
-### 5. Business Context 생성
+### 6. Business Context 생성
 
 [ContextGeneration Skill](../../skills/ContextGeneration/SKILL.md)의 Business 규칙에 따라:
 - 기술 용어를 비즈니스 관점으로 변환
+- PR 기대효과를 "사용자 관점"에 반영
 - 도메인별 `.md` 파일 생성/업데이트
 - `business/INDEX.md` 업데이트
 
-### 6. 반영
+### 7. Architecture Context 생성
+
+인프라/아키텍처 변경이 있는 경우에만 생성합니다.
+
+**생성 조건**:
+- `Dockerfile`, `docker-compose.yml` → `deployment.md`
+- `.github/workflows/*.yml` → `ci-cd.md`
+- 폴더 구조 대규모 변경 → `layer-structure.md`
+- DB migration, schema 파일 → `database-schema.md`
+- nginx, terraform, k8s 설정 → 해당 토픽
+
+[ContextGeneration Skill](../../skills/ContextGeneration/SKILL.md)의 Architecture 규칙에 따라:
+- 토픽별 `.md` 파일 생성/업데이트
+- `architecture/INDEX.md` 업데이트
+
+### 8. 반영
 
 - 생성된 context 문서는 `{브랜치명}-generated-context` 브랜치에 push됩니다.
 - 원본 PR 브랜치로 별도 PR이 생성되어 선택적으로 머지할 수 있습니다.

package/templates/project/skills/ContextGeneration/SKILL.md

@@ -13,12 +13,15 @@ PR 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/business
 
 ```
 .claude/context/
-├── codebase/
-│   ├── INDEX.md          # 모듈 목록 + 경로
-│   └── <module-name>.md  # 모듈별 구현 참조
-└── business/
-    ├── INDEX.md          # 프로젝트 개요 + 도메인 목록
-    └── <domain-area>.md  # 비즈니스 레벨 요약
+├── codebase/        # 모듈별 구현 참조
+│   ├── INDEX.md
+│   └── <module-name>.md
+├── business/        # 비즈니스 레벨 요약
+│   ├── INDEX.md
+│   └── <domain-area>.md
+└── architecture/    # 인프라 + 코드 아키텍처
+    ├── INDEX.md
+    └── <topic>.md
 ```
 
 <rules>
@@ -106,6 +109,62 @@ keywords: [비즈니스, 키워드]
   - `mergeSettingsJson()` -> "기존 설정을 보존하면서 새 설정 적용"
   - `copyClaudeFiles()` -> "템플릿 설정을 사용자 환경에 배포"
 
+## Architecture Context 규칙
+
+### 파일명
+- **kebab-case** 사용 (예: `deployment.md`, `database-schema.md`, `layer-structure.md`)
+- 아키텍처 토픽 단위로 분리
+
+### 분류
+
+| 분류 | 대상 | 파일명 예시 |
+|------|------|-----------|
+| 인프라 | 서버 배포, CI/CD, 클라우드 구성, 모니터링 | `deployment.md`, `ci-cd.md` |
+| 코드 아키텍처 | 레이어 구조, 디자인 패턴, 모듈 관계 | `layer-structure.md`, `module-dependencies.md` |
+| 데이터 | DB 스키마, 캐시 전략, 마이그레이션 | `database-schema.md`, `cache-strategy.md` |
+
+### 필수 섹션
+
+```markdown
+---
+name: <토픽명>
+description: <한 줄 설명>
+keywords: [관련, 키워드]
+---
+
+# <토픽명>
+
+<2-3문장 개요>
+
+## 구성 요소
+
+| 요소 | 역할 | 설정 파일/경로 |
+|------|------|--------------|
+| ... | ... | ... |
+
+## 다이어그램 (선택)
+
+<텍스트 기반 다이어그램>
+
+## 관련 Context
+
+- [<모듈명>](../codebase/<module>.md)
+- [<도메인명>](../business/<domain>.md)
+```
+
+## PR 내용 활용 규칙
+
+Context 생성 시 PR 정보를 다음과 같이 활용합니다:
+
+| PR 정보 | 활용 방법 |
+|---------|----------|
+| PR 제목 | 변경의 핵심 의도 파악 |
+| PR 본문 | 기대효과, 배경, 관련 이슈 파악 |
+| Diff | 실제 코드 변경 내용 분석 |
+
+- PR 의도를 반영하여 context 문서의 "개요"와 "핵심 흐름"을 작성한다
+- PR 본문의 기대효과를 Business Context의 "사용자 관점"에 반영한다
+
 </rules>
 
 ## INDEX.md 작성 규칙
@@ -148,6 +207,23 @@ description: 비즈니스 도메인 참조 목록
 | 설정 관리 | 사용자 설정 배포 및 관리 | [configuration-management.md](./configuration-management.md) |
 ```
 
+### architecture/INDEX.md
+
+```markdown
+---
+name: Architecture Index
+description: 인프라/코드 아키텍처 참조 목록
+---
+
+# Architecture Context Index
+
+## 토픽 목록
+
+| 토픽 | 분류 | 설명 | 문서 |
+|------|------|------|------|
+| 배포 구성 | 인프라 | 서버 배포 방식 | [deployment.md](./deployment.md) |
+```
+
 ## 증분 업데이트 원칙
 
 <checklist>

package/templates/project/workflows/context-gen.yml

@@ -42,6 +42,11 @@ jobs:
           show_full_output: true
           claude_args: '--model opus --allowedTools "Bash(git:*),Bash(ls:*),Bash(mkdir:*),Read,Write,Edit,Glob,Grep"'
           prompt: |
+            # PR 정보
+            **제목**: ${{ github.event.pull_request.title }}
+            **본문**:
+            ${{ github.event.pull_request.body }}
+
             # 에이전트 정의
             ${{ steps.read-skills.outputs.agent_def }}
 
@@ -49,13 +54,15 @@ jobs:
             ${{ steps.read-skills.outputs.skill_guide }}
 
             # 작업 지시
-            PR diff를 분석하고 .claude/context/ 아래에 컨텍스트 문서를 생성/업데이트하세요.
+            PR 정보와 diff를 분석하고 .claude/context/ 아래에 컨텍스트 문서를 생성/업데이트하세요.
 
             단계:
-            1. `git diff HEAD~1 --name-only`을 실행하여 변경된 파일 목록 가져오기
-            2. 변경된 각 모듈에 대해 .claude/context/codebase/<module>.md 생성 또는 업데이트
-            3. 영향을 받는 각 비즈니스 도메인에 대해 .claude/context/business/<domain>.md 생성 또는 업데이트
-            4. 두 디렉토리의 INDEX.md 파일 업데이트
+            1. PR 제목과 본문에서 변경 의도와 기대효과를 파악
+            2. `git diff HEAD~1 --name-only`로 변경된 파일 목록 가져오기
+            3. 변경된 코드의 기능 단위별로 .claude/context/codebase/<module>.md 생성/업데이트
+            4. 영향받는 비즈니스 도메인에 대해 .claude/context/business/<domain>.md 생성/업데이트
+            5. 인프라/아키텍처 변경이 있으면 .claude/context/architecture/<topic>.md 생성/업데이트
+            6. 각 디렉토리의 INDEX.md 파일 업데이트
 
             중요사항:
             - 컨텍스트 문서에 소스 코드를 포함하지 말고, 파일 경로와 함수 이름만 포함하세요