jun-claude-code 0.0.12 → 0.0.13

package/README.md

@@ -6,7 +6,7 @@ Claude Code 설정 템플릿 CLI. 미리 정의된 Agents, Skills, Hooks, Workfl
 
 ### Agents (`templates/global/agents/`)
 
-작업별 전문 Subagent 15종. Main Agent의 Context Window를 절약하면서 각 작업을 위임합니다.
+작업별 전문 Subagent 13종. Main Agent의 Context Window를 절약하면서 각 작업을 위임합니다.
 
 | Agent | 역할 |
 |-------|------|
@@ -23,8 +23,6 @@ Claude Code 설정 템플릿 CLI. 미리 정의된 Agents, Skills, Hooks, Workfl
 | `director` | 작업 총괄 디렉터 |
 | `context-collector` | Context 수집 |
 | `context-manager` | Context 문서 관리 |
-| `context-generator` | Context 자동 생성 |
-| `project-task-manager` | GitHub Project 태스크 관리 |
 
 ### Skills (`templates/global/skills/`)
 
@@ -36,7 +34,6 @@ Claude Code 설정 템플릿 CLI. 미리 정의된 Agents, Skills, Hooks, Workfl
 | `React` | React 개발 (TanStack Router, React Hook Form, Tailwind) |
 | `Documentation` | .claude 문서 작성 가이드 |
 | `Director` | 디렉터 Agent 운영 스킬 |
-| `ContextGeneration` | Context 자동 생성 스킬 |
 
 ### Hooks (`templates/global/hooks/`)
 
@@ -44,7 +41,21 @@ Claude Code 설정 템플릿 CLI. 미리 정의된 Agents, Skills, Hooks, Workfl
 |------|------|
 | `workflow-enforced.sh` | 워크플로우 순서 강제 프로토콜 |
 | `skill-forced.sh` | Skill/Agent 평가 프로토콜 |
-| `task-loader.sh` | GitHub Project 태스크 조회 |
+
+### Project Agents (`templates/project/agents/`)
+
+프로젝트 `.claude/`에 설치되는 프로젝트별 Agent.
+
+| Agent | 역할 |
+|-------|------|
+| `project-task-manager` | GitHub Project 태스크 관리 |
+| `context-generator` | Context 자동 생성 |
+
+### Project Skills (`templates/project/skills/`)
+
+| Skill | 설명 |
+|-------|------|
+| `ContextGeneration` | Context 자동 생성 스킬 |
 
 ### Workflow
 
@@ -116,11 +127,17 @@ jun-claude-code init-context
 .github/workflows/
 └── context-gen.yml                # Context 생성 GitHub Actions 워크플로우
 
-.claude/context/
-├── codebase/
-│   └── INDEX.md                   # 코드베이스 모듈 참조 목록
-└── business/
-    └── INDEX.md                   # 비즈니스 도메인 참조 목록
+.claude/
+├── agents/
+│   └── context-generator.md       # Context 자동 생성 Agent
+├── skills/
+│   └── ContextGeneration/
+│       └── SKILL.md               # Context 자동 생성 Skill
+└── context/
+    ├── codebase/
+    │   └── INDEX.md               # 코드베이스 모듈 참조 목록
+    └── business/
+        └── INDEX.md               # 비즈니스 도메인 참조 목록
 ```
 
 > `CLAUDE_CODE_OAUTH_TOKEN`를 GitHub repository secrets에 추가해야 합니다.
@@ -131,12 +148,13 @@ jun-claude-code init-context
 templates/
 ├── global/                # ~/.claude/에 설치되는 전역 설정
 │   ├── CLAUDE.md          # 작업 가이드 (워크플로우, Context 절약 원칙)
-│   ├── agents/            # Subagent 정의 (15종)
+│   ├── agents/            # Subagent 정의 (13종)
 │   ├── skills/            # 스킬 가이드 (코딩, Git, BE, FE 등)
 │   ├── hooks/             # 자동 실행 스크립트 (워크플로우 강제, 스킬 평가)
 │   └── settings.json      # Claude Code 전역 설정
 └── project/               # 프로젝트 .claude/에 설치되는 프로젝트별 설정
-    ├── agents/            # project-task-manager Agent
+    ├── agents/            # project-task-manager, context-generator Agent
+    ├── skills/            # ContextGeneration Skill
     ├── hooks/             # task-loader Hook
     ├── workflows/         # context-gen Workflow
     └── project.env.example

package/dist/cli.js

@@ -33,10 +33,15 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
 const copy_1 = require("./copy");
 const init_context_1 = require("./init-context");
+const validate_1 = require("./validate");
 const program = new commander_1.Command();
 program
     .name('jun-claude-code')
@@ -96,4 +101,21 @@ program
         process.exit(1);
     }
 });
+program
+    .command('validate')
+    .description('Validate template directory structure')
+    .action(async () => {
+    try {
+        await (0, validate_1.validateTemplates)();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(chalk_1.default.red('Validation failed:'), error.message);
+        }
+        else {
+            console.error(chalk_1.default.red('Validation failed'));
+        }
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/init-context.js

@@ -63,7 +63,29 @@ async function initContext() {
         fs.copyFileSync(templateSrc, workflowDest);
         console.log(chalk_1.default.green('  ✓ Created .github/workflows/context-gen.yml'));
     }
-    // 2. .claude/context/codebase/ 디렉토리 + stub INDEX.md
+    // 2. context-generator Agent 복사
+    const agentSrc = path.join(getTemplatesDir(), 'agents', 'context-generator.md');
+    const agentDest = path.join(cwd, '.claude', 'agents', 'context-generator.md');
+    fs.mkdirSync(path.dirname(agentDest), { recursive: true });
+    if (fs.existsSync(agentDest)) {
+        console.log(chalk_1.default.yellow('  ⚠ .claude/agents/context-generator.md already exists, skipping'));
+    }
+    else {
+        fs.copyFileSync(agentSrc, agentDest);
+        console.log(chalk_1.default.green('  ✓ Created .claude/agents/context-generator.md'));
+    }
+    // 3. ContextGeneration Skill 복사
+    const skillSrc = path.join(getTemplatesDir(), 'skills', 'ContextGeneration', 'SKILL.md');
+    const skillDest = path.join(cwd, '.claude', 'skills', 'ContextGeneration', 'SKILL.md');
+    fs.mkdirSync(path.dirname(skillDest), { recursive: true });
+    if (fs.existsSync(skillDest)) {
+        console.log(chalk_1.default.yellow('  ⚠ .claude/skills/ContextGeneration/SKILL.md already exists, skipping'));
+    }
+    else {
+        fs.copyFileSync(skillSrc, skillDest);
+        console.log(chalk_1.default.green('  ✓ Created .claude/skills/ContextGeneration/SKILL.md'));
+    }
+    // 4. .claude/context/codebase/ 디렉토리 + stub INDEX.md
     const codebaseDirPath = path.join(cwd, '.claude', 'context', 'codebase');
     const codebaseIndex = path.join(codebaseDirPath, 'INDEX.md');
     fs.mkdirSync(codebaseDirPath, { recursive: true });
@@ -85,7 +107,7 @@ description: 코드베이스 모듈 참조 목록
 `);
         console.log(chalk_1.default.green('  ✓ Created .claude/context/codebase/INDEX.md'));
     }
-    // 3. .claude/context/business/ 디렉토리 + stub INDEX.md
+    // 5. .claude/context/business/ 디렉토리 + stub INDEX.md
     const businessDirPath = path.join(cwd, '.claude', 'context', 'business');
     const businessIndex = path.join(businessDirPath, 'INDEX.md');
     fs.mkdirSync(businessDirPath, { recursive: true });
@@ -111,7 +133,7 @@ description: 비즈니스 도메인 참조 목록
 `);
         console.log(chalk_1.default.green('  ✓ Created .claude/context/business/INDEX.md'));
     }
-    // 4. 안내 메시지
+    // 6. 안내 메시지
     console.log(chalk_1.default.bold('\n✅ Context auto-generation setup complete!\n'));
     console.log(chalk_1.default.cyan('Next steps:'));
     console.log(chalk_1.default.cyan('  1. Add CLAUDE_CODE_OAUTH_TOKEN to your repository secrets'));

package/dist/validate.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Validate template directory structure
+ */
+export declare function validateTemplates(): Promise<void>;

package/dist/validate.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTemplates = validateTemplates;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Get the templates directory path (from package installation)
+ */
+function getTemplatesDir() {
+    return path.resolve(__dirname, '..', 'templates');
+}
+/**
+ * Validate that all required items exist in a template directory
+ */
+function validateTemplate(rule) {
+    const missing = [];
+    const baseDir = path.join(getTemplatesDir(), rule.dir);
+    for (const item of rule.required) {
+        const itemPath = path.join(baseDir, item);
+        if (!fs.existsSync(itemPath)) {
+            missing.push(item);
+        }
+    }
+    return missing;
+}
+/**
+ * Validate template directory structure
+ */
+async function validateTemplates() {
+    const templatesDir = getTemplatesDir();
+    console.log(chalk_1.default.cyan('\nValidating template directory structure...\n'));
+    if (!fs.existsSync(templatesDir)) {
+        console.error(chalk_1.default.red('Error:'), 'templates/ directory not found');
+        process.exit(1);
+    }
+    const rules = [
+        {
+            name: 'Global',
+            dir: 'global',
+            required: ['CLAUDE.md', 'settings.json', 'agents', 'skills'],
+        },
+        {
+            name: 'Project',
+            dir: 'project',
+            required: ['workflows'],
+        },
+    ];
+    let hasErrors = false;
+    for (const rule of rules) {
+        const missing = validateTemplate(rule);
+        if (missing.length === 0) {
+            console.log(chalk_1.default.green(`  [PASS] ${rule.name} template (templates/${rule.dir}/)`));
+        }
+        else {
+            hasErrors = true;
+            console.log(chalk_1.default.red(`  [FAIL] ${rule.name} template (templates/${rule.dir}/)`));
+            for (const item of missing) {
+                console.log(chalk_1.default.yellow(`    - missing: ${item}`));
+            }
+        }
+    }
+    console.log();
+    if (hasErrors) {
+        console.error(chalk_1.default.red('Validation failed: some required items are missing.'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.green('All templates are valid.'));
+}

package/package.json

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

package/templates/global/CLAUDE.md

@@ -2,12 +2,12 @@
 
 이 파일은 Claude Code의 작업 워크플로우와 규칙을 정의합니다.
 
-## Context 절약 원칙 (최우선 - 반드시 준수)
+## Context 절약 원칙 (최우선)
 
 Main Agent의 Context Window는 제한적입니다.
-**Subagent가 할 수 있는 작업은 반드시 Subagent에 위임하세요!**
+**Subagent가 할 수 있는 작업은 Subagent에 위임하세요.**
 
-### 필수 위임 작업 (Main Agent 직접 수행 금지)
+### 필수 위임 작업 (Subagent 전담)
 
 | 작업 | Agent | 이유 |
 |------|-------|------|
@@ -18,40 +18,45 @@ Main Agent의 Context Window는 제한적입니다.
 | 영향 분석 | `impact-analyzer` | 분석 결과만 받음 |
 | 코드 리뷰 | `code-reviewer` | 리뷰 결과만 받음 |
 | 테스트/빌드 검증 | `qa-tester` | 검증 결과만 받음 |
-| 단순 수정 (lint/build 오류, 오타, 설정값) | `simple-code-writer` | Main이 직접 수정하지 않음 |
+| 단순 수정 (lint/build 오류, 오타, 설정값) | `simple-code-writer` | Main Context 보존 |
 | 여러 파일 코드 작성 | `code-writer` | 구현 결과만 받음 |
 | Git 작업 | `git-manager` | 커밋/PR 결과만 받음 |
 | Context 문서 정리 | `context-manager` | 파일 분리, 토큰 최적화 |
 
-### 절대 금지 (Main Agent에서 직접 수행 금지)
+<delegation_rules>
 
-- Main Agent에서 직접 Glob/Grep으로 여러 파일 탐색
-- Main Agent에서 직접 여러 파일 Read (2개 이상)
-- Main Agent에서 복잡한 분석/계획 수행
-- Main Agent에서 3개 이상 파일 수정
-- **Main Agent에서 직접 Git 명령어 실행 (git add, commit, push 등)**
-- **Main Agent에서 직접 코드 수정 (Edit/Write로 코드 파일 수정)**
+### Subagent 전용 작업
 
-### Main Agent 허용 작업 (이것만 직접 수행)
+| 작업 | 전담 Agent |
+|------|-----------|
+| 파일 탐색 (Glob/Grep) | explore Agent가 전담 |
+| 2개 이상 파일 읽기 | explore/context-collector가 전담 |
+| 복잡한 분석/계획 | task-planner에 위임 |
+| 파일 수정 | code-writer가 전담 |
+| Git 명령어 실행 (git add, commit, push 등) | git-manager에 위임 |
+| 코드 수정 (Edit/Write) | code-writer/simple-code-writer에 위임 |
+
+### Main Agent 전담 작업
 
 - 사용자와 대화/질문 응답
 - Task 흐름 관리 (TaskCreate, TaskUpdate, TaskList)
 - Subagent 호출 및 결과 전달
-- 단순 명령 실행 (Bash) - **단, Git 명령어 제외**
+- 단순 명령 실행 (Bash) - **Git/코드수정은 Subagent 전담**
+
+</delegation_rules>
 
-### Main Agent 코드 수정 금지
+### 코드 수정 위임 규칙
 
-Main Agent는 **절대 코드를 직접 수정하지 않습니다.**
-모든 코드 수정은 Subagent에 위임하세요.
+모든 코드 수정은 Subagent가 전담합니다.
 
 | 수정 유형 | Agent | 모델 |
 |----------|-------|------|
 | lint/build 오류 수정, 오타, 설정값 변경 등 단순 수정 | `simple-code-writer` | haiku |
 | 로직 작성, 기능 구현, 리팩토링 (파일 수 무관) | `code-writer` | opus |
 
-### Git 작업은 반드시 Subagent 사용
+### Git 작업은 Subagent 전담
 
-**모든 Git 작업은 `git-manager` Agent에 위임하세요!**
+**모든 Git 작업은 `git-manager` Agent에 위임하세요.**
 
 ```
 Task(subagent_type="git-manager", prompt="현재 변경사항을 커밋해줘")
@@ -72,10 +77,14 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 | lint/build 오류, 오타, 설정값 등 단순 수정 | `simple-code-writer` Agent에 위임 |
 | 로직 작성, 기능 구현, 리팩토링 | `code-writer` Agent에 위임 |
 
+<workflow>
+
 ## 작업 워크플로우 (필수)
 
 모든 코드 작업은 아래 순서를 따릅니다:
 
+<phase name="계획">
+
 ### Phase 1: 계획 (Planning)
 
 ```
@@ -98,6 +107,10 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 4. 작성된 내용을 사용자에게 Confirm 받음 **필수**
 ```
 
+</phase>
+
+<phase name="검증">
+
 ### Phase 2: 검증 (Validation)
 
 ```
@@ -107,20 +120,28 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
    - Breaking Change 여부 확인
 ```
 
+</phase>
+
+<phase name="구현">
+
 ### Phase 3: 구현 (Implementation)
 
 ```
 5. 작은 단위로 코드 수정
    - 독립적으로 빌드 가능한 단위로 작업
    - 한 번에 하나의 기능/수정만 진행
-   - 빌드 에러가 발생하지 않는 상태 유지
+   - 빌드 가능 상태를 유지
 
 6. 단위별 커밋
-   - 수정한 파일만 git add (git add -A 금지)
+   - 수정한 파일만 개별 지정하여 git add
    - 명확한 커밋 메시지 작성
    - 커밋 단위: 하나의 논리적 변경
 ```
 
+</phase>
+
+<phase name="리뷰">
+
 ### Phase 4: 리뷰 (Review)
 
 ```
@@ -131,9 +152,11 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 8. Task 완료 검증
    - 원래 요청사항이 모두 충족되었는지 확인
    - 예상한 동작이 구현되었는지 확인
-   - 누락된 엣지케이스 없는지 점검
+   - 모든 엣지케이스가 처리되었는지 점검
 ```
 
+</phase>
+
 ### 워크플로우 요약
 
 ```
@@ -148,8 +171,12 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 └─────────────────────────────────────────────────────────────┘
 ```
 
+</workflow>
+
 ## 문서 참조
 
+<reference>
+
 ### Context (사실/배경) - "우리 프로젝트는 이렇다"
 
 프로젝트별로 `.claude/context/` 에 작성
@@ -163,6 +190,8 @@ Task(subagent_type="git-manager", prompt="PR을 생성해줘")
 | PR 리뷰 | `.claude/skills/Git/pr-review.md` |
 | PR 피드백 적용 | `.claude/skills/Git/pr-apply.md` |
 
+</reference>
+
 ---
 
 ## .claude 문서 작성 가이드

package/templates/global/agents/architect.md

@@ -8,21 +8,25 @@ color: red
 
 # Architect Agent
 
-시스템 아키텍처 설계와 복잡한 디버깅을 담당하는 전문 Agent입니다.
+<role>
 
-## 역할
+시스템 아키텍처 설계와 복잡한 디버깅을 담당하는 전문 Agent입니다.
 
 1. **아키텍처 설계**: 새로운 기능/모듈의 구조 설계
 2. **복잡한 디버깅**: 여러 레이어에 걸친 버그 추적
 3. **기술 부채 분석**: 리팩토링 대상 식별 및 계획
 4. **설계 검토**: 기존 설계의 문제점 분석 및 개선안 제시
 
-## 참조 문서
+</role>
+
+<reference>
 
 > **필수 참조**:
 > - `.claude/context/architecture/` - 시스템 아키텍처
 > - `.claude/context/` - 프로젝트 컨텍스트
 
+</reference>
+
 ---
 
 ## 사용 시점
@@ -38,16 +42,18 @@ color: red
 - DB 스키마 설계 검토
 ```
 
-### 부적합한 경우
+### 다른 Agent가 적합한 경우
 
 ```
-- 단순 CRUD 구현 (code-writer 사용)
-- UI 컴포넌트 설계 (designer 사용)
-- 일반적인 코드 탐색 (explore 사용)
+- 단순 CRUD 구현 → code-writer 사용
+- UI 컴포넌트 설계 → designer 사용
+- 일반적인 코드 탐색 → explore 사용
 ```
 
 ---
 
+<instructions>
+
 ## 분석 프로세스
 
 ### Step 1: 현재 아키텍처 파악
@@ -77,9 +83,11 @@ color: red
 4. 구현 로드맵 제시
 ```
 
+</instructions>
+
 ---
 
-## 출력 형식
+<output_format>
 
 ### 아키텍처 분석
 
@@ -153,11 +161,15 @@ color: red
 - ...
 ```
 
+</output_format>
+
 ---
 
-## 주의사항
+<constraints>
 
-- **과도한 설계 금지**: 현재 필요한 만큼만 설계
+- **현재 필요한 만큼만 설계**: 미래 요구사항 예측보다 현재 문제 해결에 집중
 - **기존 패턴 존중**: 프로젝트 컨벤션 따르기
-- **점진적 개선**: 빅뱅 리팩토링보다 점진적 개선
+- **점진적 개선**: 빅뱅 리팩토링보다 단계별 개선 우선
 - **근거 명시**: 모든 설계 결정에 이유 설명
+
+</constraints>

package/templates/global/agents/code-reviewer.md

@@ -8,24 +8,28 @@ color: yellow
 
 # Code Reviewer Agent
 
-작성된 코드가 프로젝트 규칙을 준수하는지 검토하는 전문 Agent입니다.
+<role>
 
-## 역할
+작성된 코드가 프로젝트 규칙을 준수하는지 검토하는 전문 Agent입니다.
 
 1. **규칙 준수 확인**: CLAUDE.md, 프로젝트 체크리스트 기준 검토
 2. **코드 품질 검사**: 가독성, 유지보수성, 일관성
 3. **Lint 실행**: lint 실행 및 결과 확인
 4. **개선 제안**: 발견된 문제에 대한 수정 방안 제시
 
+</role>
+
 ---
 
+<instructions>
+
 ## 검토 프로세스
 
 ### Step 1: 공통 체크리스트
 
 | 항목 | 확인 |
 |------|------|
-| 한 글자 변수명 금지 | ☐ |
+| 의미 있는 변수명 사용 | ☐ |
 | 함수형 메서드 사용 (map, filter, reduce) | ☐ |
 | 타입 안전성 (any 최소화) | ☐ |
 | 에러 핸들링 적절함 | ☐ |
@@ -45,6 +49,8 @@ npm run lint
 yarn lint
 ```
 
+</instructions>
+
 ---
 
 ## 문제 분류
@@ -59,7 +65,7 @@ yarn lint
 
 ---
 
-## 출력 형식
+<output_format>
 
 ```markdown
 # Code Review 결과
@@ -107,10 +113,14 @@ yarn lint
 - 이슈 없음: 최종 검증 진행
 ```
 
+</output_format>
+
 ---
 
-## 주의사항
+<constraints>
 
-- **과도한 지적 금지**: 실제 문제가 있는 부분만 지적
-- **대안 제시 필수**: 문제만 지적하지 말고 해결책도 제시
+- **실제 문제만 지적**: 코드에 실질적 영향이 있는 부분만 리뷰
+- **대안 제시 필수**: 문제 지적 시 해결책도 함께 제시
 - **컨텍스트 고려**: 프로젝트 상황에 맞게 유연하게 판단
+
+</constraints>