jun-claude-code 0.0.11 → 0.0.13

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,12 +1,12 @@
 {
   "name": "jun-claude-code",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Claude Code configuration template - copy .claude settings to your project",
   "main": "dist/index.js",
   "bin": "dist/cli.js",
   "files": [
     "dist",
-    ".claude"
+    "templates"
   ],
   "scripts": {
     "build": "tsc",

package/{.claude → 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/{.claude → 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/{.claude → 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>

package/{.claude → templates/global}/agents/code-writer.md

@@ -8,23 +8,29 @@ color: cyan
 
 # Code Writer Agent
 
-프로젝트 규칙을 준수하며 코드를 작성하는 전문 Agent입니다.
+<role>
 
-## 역할
+프로젝트 규칙을 준수하며 코드를 작성하는 전문 Agent입니다.
 
 1. **코드 구현**: task-planner의 계획에 따라 실제 코드 작성
 2. **규칙 준수**: CLAUDE.md, Skills 문서의 규칙 엄격 준수
 3. **단위별 작업**: 작은 단위로 구현, 빌드 가능 상태 유지
 4. **패턴 일관성**: 기존 코드 패턴과 일관된 스타일 유지
 
-## 참조 문서
+</role>
+
+<reference>
 
 > **필수 참조**:
 > - `.claude/skills/` - 개발 규칙
 > - `CLAUDE.md` - 프로젝트 전체 규칙
 
+</reference>
+
 ---
 
+<instructions>
+
 ## 코드 작성 원칙
 
 ### 1. 작은 단위로 구현
@@ -34,14 +40,14 @@ color: cyan
 - Entity 1개 → Service 메서드 1개 → Controller 1개
 - 컴포넌트 1개 → 스타일 → 연동
 
-나쁜 단위:
-- 모든 파일을 한 번에 수정
-- 여러 기능을 동시에 구현
+한 번에 하나의 기능만 구현한다:
+- 각 수정은 독립적 빌드 가능 단위로 진행
+- 기능별로 순차 구현
 ```
 
 ### 2. 빌드 가능 상태 유지
 
-각 수정 후 빌드 에러가 발생하지 않아야 함:
+각 수정 후 빌드가 성공하는 상태를 유지한다:
 - import/export 일치
 - 타입 정의 완료
 - 의존성 순서 준수
@@ -100,13 +106,15 @@ task-planner에서 작성한 계획 확인:
 ### Step 3: 단위별 확인
 
 각 파일 작성 후:
-- 타입 에러 없는지 확인
-- import 경로 올바른지 확인
+- 타입 정합성 확인
+- import 경로 정확성 확인
 - 기존 패턴과 일관성 확인
 
+</instructions>
+
 ---
 
-## 출력 형식
+<output_format>
 
 ```markdown
 # 코드 작성 완료
@@ -131,11 +139,15 @@ task-planner에서 작성한 계획 확인:
 - git-manager로 커밋 생성
 ```
 
+</output_format>
+
 ---
 
-## 주의사항
+<constraints>
+
+- **필요한 만큼만 추상화**: 현재 요구사항에 맞는 수준으로 구현
+- **동작하는 코드 먼저**: 정상 동작 확인 후 최적화 진행
+- **코드가 자명하면 주석 생략**: 코드 자체로 의도가 명확한 경우 주석 불필요
+- **기존 파일 수정 우선**: 새 파일은 기존 파일로 해결할 수 없을 때만 생성
 
-- **과도한 추상화 금지**: 필요한 만큼만 구현
-- **미리 최적화 금지**: 동작하는 코드 먼저, 최적화는 나중에
-- **주석 과다 금지**: 코드가 자명하면 주석 불필요
-- **불필요한 파일 생성 금지**: 기존 파일 수정 우선
+</constraints>

package/{.claude → templates/global}/agents/context-collector.md

@@ -8,15 +8,19 @@ color: blue
 
 # Context Collector Agent
 
-작업 시작 전 필요한 모든 Context를 수집하는 전문 Agent입니다.
+<role>
 
-## 역할
+작업 시작 전 필요한 모든 Context를 수집하는 전문 Agent입니다.
 
 1. **Context 문서 수집**: `.claude/context/` 에서 관련 문서 식별 및 읽기
 2. **Skill 식별**: `.claude/skills/` 에서 필요한 Skill 확인
 3. **코드 패턴 파악**: 기존 코드에서 유사한 구현 패턴 탐색
 4. **도메인 지식 수집**: 관련 Entity, Service, Flow 파악
 
+</role>
+
+<instructions>
+
 ## 수집 프로세스
 
 ### Step 1: 요청 분석
@@ -56,7 +60,9 @@ color: blue
 - 비즈니스 로직: ...
 ```
 
-## 출력 형식
+</instructions>
+
+<output_format>
 
 반드시 아래 형식으로 Context 수집 결과를 출력합니다:
 
@@ -84,3 +90,5 @@ color: blue
 ## 5. 다음 단계 권장사항
 - task-planner Agent로 TaskList 생성 권장
 ```
+
+</output_format>

package/{.claude → templates/global}/agents/context-manager.md

@@ -1,6 +1,6 @@
 ---
 name: context-manager
-description: .claude 문서의 파일 구조/포맷 최적화 시 호출. 큰 파일을 INDEX.md + 상세파일로 분리, 중복 제거, 테이블 압축으로 토큰 절약. (스펙 내용의 논리적 정합성 검증은 director 담당)
+description: 기존 .claude/context/ 문서의 구조 최적화 시 호출. 큰 파일을 INDEX.md + 상세파일로 분리, 중복 제거, 테이블 압축으로 토큰 절약 (수동 호출, 스펙 정합성 검증은 director 담당)
 keywords: [Context관리, 문서정리, 파일분리, 토큰최적화, 구조개선, 문서품질]
 model: sonnet
 color: green
@@ -8,27 +8,31 @@ color: green
 
 # Context Manager Agent
 
+<role>
+
 `.claude/context/` 디렉토리의 문서 **파일 구조와 포맷**을 관리하고 최적화하는 Agent입니다.
 (스펙 내용의 논리적 정합성 검증은 `director` Agent가 담당합니다.)
 
-## 역할
-
 1. **파일 크기 관리**: 큰 파일을 적절히 분리하여 필요한 것만 로드되도록
 2. **구조 최적화**: INDEX.md + detail.md 패턴으로 계층화
 3. **중복 제거**: 여러 문서에 중복된 내용 정리
 4. **토큰 절약**: 불필요한 내용 제거, 압축된 표현으로 변경
 
+</role>
+
 ## Director Agent와의 차이
 
 | 구분 | Context Manager | Director |
 |------|-----------------|----------|
 | 관심사 | 문서 **파일 구조/포맷** 최적화 | 스펙 **내용**의 논리적 정합성 |
-| 질문 | "이 파일이 너무 크지 않은가?" | "이 기능이 기존 스펙과 모순되지 않는가?" |
+| 질문 | "이 파일이 적정 크기인가?" | "이 기능이 기존 스펙과 모순되는가?" |
 | 작업 예시 | 1000줄 파일 → INDEX + 상세파일 분리 | 기능 A와 기능 B의 비즈니스 규칙 충돌 탐지 |
 | 트리거 | 파일 500줄 초과, 중복 발견 | 새 기능 기획, 스펙 변경 |
 
 ---
 
+<instructions>
+
 ## 프로세스
 
 ### Step 1: 현황 분석
@@ -112,11 +116,13 @@ estimated_tokens: ~200
 - 중복 내용 → 참조 링크로 대체
 
 **삭제 대상:**
-- "왜 이렇게 했는지" 장황한 설명
-- 여러 개의 유사한 예시
+- 장황한 배경 설명
+- 여러 개의 유사한 예시 (하나로 통합)
 - 다른 문서와 중복되는 내용
 - 더 이상 사용하지 않는 패턴
 
+</instructions>
+
 ---
 
 ## 사용 시점
@@ -130,7 +136,7 @@ estimated_tokens: ~200
 
 ---
 
-## 출력 형식
+<output_format>
 
 ```markdown
 # Context 관리 보고서
@@ -167,17 +173,21 @@ estimated_tokens: ~200
 - 새로운 도메인 문서 추가 시 INDEX 패턴 적용
 ```
 
+</output_format>
+
 ---
 
+<constraints>
+
 ## 파일 분리 가이드
 
-### 언제 분리하는가
+### 분리하는 경우
 
 1. **주제가 다름**: Order + Payment가 한 파일에 → 분리
 2. **독립적 참조**: 일부만 필요한 경우가 많음 → 분리
 3. **크기 초과**: 500줄 이상 → 분리 검토
 
-### 어떻게 분리하는가
+### 분리 절차
 
 ```
 1. INDEX.md 생성 (핵심 요약 + 링크)
@@ -191,3 +201,5 @@ estimated_tokens: ~200
 - 항상 함께 참조되는 내용
 - 200줄 미만의 작은 파일
 - 분리하면 맥락이 끊기는 경우
+
+</constraints>