jun-claude-code 0.0.11 → 0.0.13

package/{.claude → templates/global}/skills/React/react-hook-form.md

@@ -26,6 +26,8 @@ src/features/auth/
     └── useLoginMutation.ts  # TRPC mutation 훅
 ```
 
+<rules>
+
 ## 필수 준수 사항
 
 | 규칙 | 올바른 예 | 잘못된 예 |
@@ -35,6 +37,8 @@ src/features/auth/
 | 에러 표시 | `formState.errors` 사용 | 커스텀 에러 상태 |
 | 로딩 상태 | `mutation.isPending` 사용 | 별도 loading 상태 |
 
+</rules>
+
 ## 스키마 정의 패턴
 
 ```typescript
@@ -199,24 +203,28 @@ const formValues = watch()
 {watchedEmail && <p>입력된 이메일: {watchedEmail}</p>}
 ```
 
+<checklist>
+
 ## 체크리스트
 
 ### 스키마 설정
-- [ ] 스키마를 별도 파일(*FormSchema.ts)로 분리
-- [ ] z.infer로 타입 추론
-- [ ] 에러 메시지 한글화
+- [ ] 스키마를 별도 파일(*FormSchema.ts)로 분리했는가?
+- [ ] z.infer로 타입 추론을 사용하는가?
+- [ ] 에러 메시지를 한글화했는가?
 
 ### 폼 구현
-- [ ] zodResolver 사용
-- [ ] defaultValues 설정
-- [ ] register로 필드 등록
+- [ ] zodResolver를 사용하는가?
+- [ ] defaultValues를 설정했는가?
+- [ ] register로 필드를 등록했는가?
 
 ### 에러 처리
-- [ ] formState.errors로 에러 표시
-- [ ] 서버 에러는 setError로 처리
-- [ ] 필드별 에러 메시지 표시
+- [ ] formState.errors로 에러를 표시하는가?
+- [ ] 서버 에러는 setError로 처리하는가?
+- [ ] 필드별 에러 메시지를 표시하는가?
 
 ### TRPC 연동
-- [ ] useMutation 사용
-- [ ] isPending으로 로딩 상태 표시
-- [ ] onSuccess/onError 핸들러 구현
+- [ ] useMutation을 사용하는가?
+- [ ] isPending으로 로딩 상태를 표시하는가?
+- [ ] onSuccess/onError 핸들러를 구현했는가?
+
+</checklist>

package/{.claude → templates/global}/skills/React/tailwind-styled.md

@@ -7,11 +7,13 @@ estimated_tokens: ~350
 
 # tailwind-styled-components 스킬
 
+<rules>
+
 ## 핵심 원칙
 
 **DOM depth를 최소화하라.**
-- 불필요한 wrapper div 제거
-- 스타일만을 위한 중첩 요소 금지
+- 불필요한 wrapper div를 제거
+- 단일 수준 구조를 유지 (스타일 전용 중첩 대신)
 - 하나의 Styled Component가 하나의 DOM 요소
 
 ## 필수 준수 사항
@@ -23,8 +25,13 @@ estimated_tokens: ~350
 | `<Wrapper><Inner><Content>...</Content></Inner></Wrapper>` | `<Container>...</Container>` |
 | `<div><div className="...">...</div></div>` | `<StyledDiv>...</StyledDiv>` |
 
+</rules>
+
+<examples>
+
 ### 예제: 불필요한 중첩 제거
 
+<example type="bad">
 ```typescript
 // ❌ Bad - 불필요한 DOM depth
 const Card = () => (
@@ -38,7 +45,10 @@ const Card = () => (
     </div>
   </div>
 );
-
+```
+</example>
+<example type="good">
+```typescript
 // ✅ Good - 최소한의 DOM depth
 const CardContainer = tw.div`
   p-4
@@ -56,9 +66,11 @@ const Card = () => (
   </CardContainer>
 );
 ```
+</example>
 
 ### 예제: Tailwind 디자인 변환
 
+<example type="bad">
 ```typescript
 // 원본 Tailwind (depth: 3)
 <div className="p-5">
@@ -68,7 +80,10 @@ const Card = () => (
     </div>
   </div>
 </div>
-
+```
+</example>
+<example type="good">
+```typescript
 // ✅ 변환 후 (depth: 1)
 const StepContent = tw.div`
   p-5
@@ -83,6 +98,9 @@ const StepContent = tw.div`
   <Title>Title</Title>
 </StepContent>
 ```
+</example>
+
+</examples>
 
 ## Styled Component 네이밍
 
@@ -152,14 +170,18 @@ const Input = tw.input`
 `;
 ```
 
+<checklist>
+
 ## 체크리스트
 
 ### DOM 구조
-- [ ] 스타일만을 위한 wrapper div가 있는가? → 제거
-- [ ] 중첩된 div를 하나로 합칠 수 있는가? → 합치기
-- [ ] depth가 3 이상인가? → 리팩토링 고려
+- [ ] 스타일 전용 wrapper div가 있는가? (있다면 제거)
+- [ ] 중첩된 div를 하나로 합칠 수 있는가? (합치기)
+- [ ] depth가 3 이상인가? (리팩토링 고려)
 
 ### Styled Component
 - [ ] 의미 있는 이름인가?
 - [ ] transient props($prefix)를 사용하는가?
 - [ ] 재사용 가능한 컴포넌트인가?
+
+</checklist>

package/{.claude → templates/global}/skills/React/tanstack-router.md

@@ -32,6 +32,8 @@ src/routes/
     └── register.tsx     # /auth/register
 ```
 
+<rules>
+
 ## 필수 준수 사항
 
 | 규칙 | 올바른 예 | 잘못된 예 |
@@ -41,6 +43,10 @@ src/routes/
 | 루트 라우트 | `__root.tsx` (더블 언더스코어) | `root.tsx` |
 | 네비게이션 훅 | `Route.useNavigate()` | `useNavigate()` 직접 import |
 
+</rules>
+
+<instructions>
+
 ## 라우트 정의 패턴
 
 ### 기본 라우트
@@ -166,19 +172,25 @@ export const Route = createFileRoute('/_admin')({
 })
 ```
 
+</instructions>
+
+<checklist>
+
 ## 체크리스트
 
 ### 라우트 설정 시
-- [ ] 동적 파라미터에 `$` 프리픽스 사용
-- [ ] 레이아웃 라우트에 `_` 프리픽스 사용
-- [ ] 루트 레이아웃은 `__root.tsx`
+- [ ] 동적 파라미터에 `$` 프리픽스를 사용하는가?
+- [ ] 레이아웃 라우트에 `_` 프리픽스를 사용하는가?
+- [ ] 루트 레이아웃은 `__root.tsx`인가?
 
 ### 네비게이션
-- [ ] `Route.useNavigate()` 사용
-- [ ] 타입 안전한 params 전달
-- [ ] 동적 파라미터는 params 객체로 전달
+- [ ] `Route.useNavigate()`를 사용하는가?
+- [ ] 타입 안전한 params를 전달하는가?
+- [ ] 동적 파라미터는 params 객체로 전달하는가?
 
 ### 인증
-- [ ] beforeLoad에서 인증 체크
-- [ ] redirect로 리다이렉트 처리
-- [ ] 원래 경로 저장 (redirect search param)
+- [ ] beforeLoad에서 인증을 체크하는가?
+- [ ] redirect로 리다이렉트를 처리하는가?
+- [ ] 원래 경로를 저장하는가? (redirect search param)
+
+</checklist>

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

@@ -0,0 +1,66 @@
+---
+name: context-generator
+description: GitHub Action에서 PR diff 기반으로 .claude/context/ 문서를 자동 생성/업데이트 (CI 전용)
+keywords: [context, PR, diff, codebase, business, 문서생성]
+model: sonnet
+color: green
+---
+
+# Context Generator Agent
+
+PR의 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/business 문서를 자동 생성하고 업데이트합니다.
+
+## 실행 조건
+
+- GitHub Action에서 PR 이벤트로 트리거
+- `anthropics/claude-code-action@v1`을 통해 실행
+
+## 프로세스
+
+### 1. Diff 수집
+
+```bash
+git diff HEAD~1 --name-only
+```
+
+변경된 파일 목록을 수집합니다.
+
+### 2. 모듈 매핑
+
+변경된 파일을 모듈 단위로 그룹화합니다.
+- `src/cli.ts` → `cli` 모듈
+- `src/copy.ts` → `copy-logic` 모듈
+- `.claude/agents/*.md` → `agents` 모듈
+
+### 3. 기존 Context 확인
+
+`.claude/context/codebase/`와 `.claude/context/business/`에서 기존 문서를 확인합니다.
+- 기존 문서가 있으면 → 업데이트
+- 기존 문서가 없으면 → 새로 생성
+
+### 4. Codebase Context 생성
+
+[ContextGeneration Skill](../../skills/ContextGeneration/SKILL.md)의 Codebase 규칙에 따라:
+- 모듈별 `.md` 파일 생성/업데이트
+- 파일 경로와 함수명만 참조 (원본 코드 포함 금지)
+- `codebase/INDEX.md` 업데이트
+
+### 5. Business Context 생성
+
+[ContextGeneration Skill](../../skills/ContextGeneration/SKILL.md)의 Business 규칙에 따라:
+- 기술 용어를 비즈니스 관점으로 변환
+- 도메인별 `.md` 파일 생성/업데이트
+- `business/INDEX.md` 업데이트
+
+### 6. 커밋
+
+```bash
+git add .claude/context/
+git commit -m "docs: update context for PR changes"
+```
+
+## 제약사항
+
+- `.claude/context/**` 경로 변경은 무시 (무한루프 방지)
+- 변경된 파일과 관련된 context만 업데이트 (전체 재생성 금지)
+- 원본 소스 코드를 context 문서에 포함하지 않음

package/{.claude → templates/project}/agents/project-task-manager.md

@@ -10,13 +10,15 @@ color: green
 
 GitHub Project 태스크를 관리하는 Agent입니다.
 
-## 역할
+<role>
 
 1. **태스크 조회**: 프로젝트 보드의 태스크 목록 조회
 2. **태스크 생성**: 새 이슈 생성 및 프로젝트에 추가
 3. **상태 변경**: 태스크 상태 업데이트 (Backlog/In progress/Done)
 4. **태스크 검색**: 키워드/상태별 필터링
 
+</role>
+
 ## 프로젝트 설정
 
 이 Agent는 `.claude/project.env` 파일에서 프로젝트 정보를 읽습니다.
@@ -52,16 +54,20 @@ source .claude/project.env
 - "이슈 #123을 프로젝트에 추가해줘"
 ```
 
-### 부적합한 경우
+<constraints>
 
-```
-- 코드 작업 (code-writer 사용)
-- PR 생성/관리 (git-manager 사용)
-- 코드 리뷰 (code-reviewer 사용)
-```
+### 다른 Agent 전담 영역
+
+- 코드 작업은 code-writer가 전담한다
+- PR 생성/관리는 git-manager가 전담한다
+- 코드 리뷰는 code-reviewer가 전담한다
+
+</constraints>
 
 ---
 
+<instructions>
+
 ## 명령어 패턴
 
 ### 태스크 목록 조회
@@ -110,8 +116,12 @@ gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> --field-id <FIELD_
 gh issue close <issue-number> --repo "$GITHUB_PROJECT_REPO"
 ```
 
+</instructions>
+
 ---
 
+<output_format>
+
 ## 출력 형식
 
 ```markdown
@@ -134,6 +144,8 @@ gh issue close <issue-number> --repo "$GITHUB_PROJECT_REPO"
 - #49 S3 URL 대신 CDN URL로 응답하도록 수정
 ```
 
+</output_format>
+
 ---
 
 ## 권한 요구사항

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

@@ -0,0 +1,160 @@
+---
+name: ContextGeneration
+description: PR 변경 내용을 분석하여 .claude/context/ 문서를 자동 생성하는 규칙
+keywords: [context, codebase, business, PR, 자동생성, 문서화]
+estimated_tokens: ~800
+---
+
+# Context 자동 생성 규칙
+
+PR 변경 내용을 분석하여 `.claude/context/` 하위에 codebase/business 문서를 자동 생성합니다.
+
+## Context 디렉토리 구조
+
+```
+.claude/context/
+├── codebase/
+│   ├── INDEX.md          # 모듈 목록 + 경로
+│   └── <module-name>.md  # 모듈별 구현 참조
+└── business/
+    ├── INDEX.md          # 프로젝트 개요 + 도메인 목록
+    └── <domain-area>.md  # 비즈니스 레벨 요약
+```
+
+<rules>
+
+## Codebase Context 규칙
+
+### 파일명
+- **kebab-case** 사용 (예: `cli.md`, `copy-logic.md`, `auth-middleware.md`)
+- 모듈/기능 단위로 분리
+
+### 필수 섹션
+
+```markdown
+---
+name: <모듈명>
+description: <한 줄 설명>
+keywords: [관련, 키워드]
+---
+
+# <모듈명>
+
+<2-3문장 개요>
+
+## 파일 구조
+
+| 파일 | 역할 | 핵심 함수/클래스 |
+|------|------|-----------------|
+| src/example.ts | 메인 로직 | mainFunction(), HelperClass |
+
+## 핵심 흐름
+
+1. <진입점> → <처리> → <결과>
+2. ...
+
+## 관련 Business Context
+
+- [<도메인명>](../business/<domain>.md)
+```
+
+### 참조 원칙
+
+- 파일 경로와 함수/클래스명만 참조한다
+- 파일 참조 형식: `| src/copy.ts | 파일 복사 메인 로직 | mergeSettingsJson() |`
+- 원본 소스 코드 대신 경로와 함수 시그니처로 표현한다
+
+## Business Context 규칙
+
+### 파일명
+- **비즈니스 도메인 기준**으로 명명한다 (예: `configuration-management.md`, `user-authentication.md`)
+- 비즈니스 용어를 사용한다 (예: `settings-json-merge.md` -> `configuration-management.md`)
+
+### 필수 섹션
+
+```markdown
+---
+name: <도메인명>
+description: <비즈니스 관점 한 줄 설명>
+keywords: [비즈니스, 키워드]
+---
+
+# <도메인명>
+
+## 목적
+
+<이 기능이 사용자에게 제공하는 가치>
+
+## 핵심 기능
+
+| 기능 | 설명 | 사용자 관점 |
+|------|------|------------|
+| 설정 복사 | 템플릿 설정을 사용자 환경에 적용 | 초기 설정 자동화 |
+
+## 사용자 흐름
+
+1. 사용자가 <동작> → <결과>
+2. ...
+
+## 관련 Codebase Context
+
+- [<모듈명>](../codebase/<module>.md)
+```
+
+### 변환 규칙
+- Codebase의 기술 용어를 비즈니스 관점으로 변환한다
+  - `mergeSettingsJson()` -> "기존 설정을 보존하면서 새 설정 적용"
+  - `copyClaudeFiles()` -> "템플릿 설정을 사용자 환경에 배포"
+
+</rules>
+
+## INDEX.md 작성 규칙
+
+### codebase/INDEX.md
+
+```markdown
+---
+name: Codebase Index
+description: 코드베이스 모듈 참조 목록
+---
+
+# Codebase Context Index
+
+## 모듈 목록
+
+| 모듈 | 설명 | 문서 |
+|------|------|------|
+| CLI | 커맨드라인 인터페이스 | [cli.md](./cli.md) |
+```
+
+### business/INDEX.md
+
+```markdown
+---
+name: Business Index
+description: 비즈니스 도메인 참조 목록
+---
+
+# Business Context Index
+
+## 프로젝트 개요
+
+<프로젝트가 해결하는 문제와 대상 사용자 1-2문장>
+
+## 도메인 목록
+
+| 도메인 | 설명 | 문서 |
+|--------|------|------|
+| 설정 관리 | 사용자 설정 배포 및 관리 | [configuration-management.md](./configuration-management.md) |
+```
+
+## 증분 업데이트 원칙
+
+<checklist>
+
+- PR에서 변경된 파일과 관련된 context 문서만 업데이트한다
+- 기존 문서의 변경되지 않은 부분은 그대로 유지한다
+- 새 모듈이 추가되면 INDEX.md에 행을 추가한다
+- 모듈이 삭제되면 INDEX.md에서 해당 행을 제거하고 문서 파일을 삭제한다
+
+</checklist>

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

@@ -0,0 +1,75 @@
+name: Context Auto-Generation
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths-ignore:
+      - '.claude/context/**'
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  generate-context:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+          fetch-depth: 0
+
+      - name: Read skill files
+        id: read-skills
+        run: |
+          {
+            echo "agent_def<<AGENT_EOF"
+            cat .claude/agents/context-generator.md
+            echo "AGENT_EOF"
+          } >> $GITHUB_OUTPUT
+          {
+            echo "skill_guide<<SKILL_EOF"
+            cat .claude/skills/ContextGeneration/SKILL.md
+            echo "SKILL_EOF"
+          } >> $GITHUB_OUTPUT
+
+      - name: Generate context documents
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          show_full_output: true
+          claude_args: '--allowedTools "Bash(git:*),Bash(ls:*),Bash(mkdir:*),Read,Write,Edit,Glob,Grep"'
+          prompt: |
+            # 에이전트 정의
+            ${{ steps.read-skills.outputs.agent_def }}
+
+            # 스킬 가이드
+            ${{ steps.read-skills.outputs.skill_guide }}
+
+            # 작업 지시
+            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 파일 업데이트
+
+            중요사항:
+            - 컨텍스트 문서에 소스 코드를 포함하지 말고, 파일 경로와 함수 이름만 포함하세요
+            - 실제로 변경된 파일에 대해서만 컨텍스트 업데이트
+            - 위 스킬 가이드에 명시된 정확한 형식 따르기
+            - 커밋하지 마세요. 파일 생성/수정만 하세요.
+
+      - name: Push context changes
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${{ github.repository }}.git"
+          git add .claude/context/
+          git diff --staged --quiet || git commit -m "docs: context 문서 자동 업데이트"
+          git push origin HEAD:refs/heads/${{ github.head_ref }}
+        env:
+          GITHUB_TOKEN: ${{ github.token }}