@su-record/vibe 0.4.4 → 0.4.6

package/.claude/agents/simplifier.md

@@ -8,7 +8,7 @@ PostToolUse Hook에서 `Write`, `Edit` 작업 후 자동 실행됩니다.
 
 ## Rules Reference
 
-**검증 기준 (`.agent/rules/`):**
+**검증 기준 (`.vibe/rules/`):**
 
 ### 필수 규칙
 - `core/development-philosophy.md` - 수술적 정밀도

package/.claude/commands/vibe.analyze.md

@@ -117,7 +117,7 @@ argument-hint: "기능명" or --code or --deps or --arch (optional)
 
 #### 6. 개발 규칙 확인
 
-`.agent/rules/`에서 관련 규칙 로드:
+`.vibe/rules/`에서 관련 규칙 로드:
 - `core/quick-start.md` - 5가지 핵심 원칙
 - `standards/complexity-metrics.md` - 복잡도 기준
 - `quality/checklist.md` - 품질 체크리스트

package/.claude/commands/vibe.run.md

@@ -16,7 +16,7 @@ SPEC을 기반으로 구현합니다 (Implementation Agent).
 
 ## Rules Reference
 
-**반드시 `.agent/rules/` 규칙을 따릅니다:**
+**반드시 `.vibe/rules/` 규칙을 따릅니다:**
 - `core/development-philosophy.md` - 수술적 정밀도, 요청 범위만 수정
 - `core/quick-start.md` - 한국어, DRY, SRP, YAGNI
 - `standards/complexity-metrics.md` - 함수 ≤20줄, 중첩 ≤3단계

package/.claude/commands/vibe.spec.md

@@ -15,7 +15,7 @@ SPEC 문서를 작성합니다 (Specification Agent).
 
 ## Rules Reference
 
-**반드시 `.agent/rules/` 규칙을 따릅니다:**
+**반드시 `.vibe/rules/` 규칙을 따릅니다:**
 - `core/development-philosophy.md` - 수술적 정밀도, 단순함
 - `core/quick-start.md` - 한국어 우선, DRY, SRP
 - `core/communication-guide.md` - 커뮤니케이션 원칙
@@ -142,7 +142,7 @@ SPEC 문서를 작성합니다 (Specification Agent).
 
 ### 5. 품질 검증
 
-`.agent/rules/quality/checklist.md` 기준 자체 평가 (0-100점)
+`.vibe/rules/quality/checklist.md` 기준 자체 평가 (0-100점)
 
 ## Output
 

package/.claude/commands/vibe.verify.md

@@ -15,7 +15,7 @@ argument-hint: "feature name"
 
 ## Rules Reference
 
-**반드시 `.agent/rules/` 규칙을 따릅니다:**
+**반드시 `.vibe/rules/` 규칙을 따릅니다:**
 - `quality/checklist.md` - 코드 품질 체크리스트 (필수)
 - `standards/complexity-metrics.md` - 복잡도 기준
 - `standards/anti-patterns.md` - 안티패턴 검출

package/.claude/settings.local.json

@@ -40,7 +40,9 @@
       "Bash(npm version:*)",
       "Bash(npx @su-record/vibe@latest update)",
       "Bash(gh release:*)",
-      "Bash(npx @su-record/vibe@latest init:*)"
+      "Bash(npx @su-record/vibe@latest init:*)",
+      "Bash(vibe version:*)",
+      "Bash(vibe update:*)"
     ],
     "deny": [],
     "ask": []

package/README.md

@@ -15,7 +15,7 @@ SPEC 문서 하나로 AI가 바로 구현하는 2-step 워크플로우.
 - **Claude Code 전용**: 네이티브 슬래시 커맨드 + MCP 통합
 - **2-Step 워크플로우**: SPEC → RUN → VERIFY (PLAN/TASKS 불필요)
 - **PTCF 구조**: Persona, Task, Context, Format - Gemini 프롬프트 최적화
-- **코딩 규칙 내장**: `.agent/rules/` - 품질 기준, 복잡도 제한, 안티패턴
+- **코딩 규칙 내장**: `.vibe/rules/` - 품질 기준, 복잡도 제한, 안티패턴
 - **자동 품질 검증**: code-simplifier 서브에이전트
 - **36개 MCP 도구**: @su-record/hi-ai 통합
 
@@ -64,7 +64,7 @@ cd my-project
 │  /vibe.run "기능명"                                 │
 │  ↓ SPEC 읽고 바로 구현                              │
 │  ↓ Phase별 순차 실행                                │
-│  ↓ .agent/rules/ 규칙 준수                          │
+│  ↓ .vibe/rules/ 규칙 준수                          │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.verify "기능명"                              │
 │  ↓ Acceptance Criteria 검증                        │
@@ -117,7 +117,7 @@ project/
 ├── .claude/
 │   ├── commands/             # 슬래시 커맨드 (7개)
 │   └── agents/               # 서브에이전트 (simplifier)
-├── .agent/rules/             # 코딩 규칙
+├── .vibe/rules/             # 코딩 규칙
 │   ├── core/                 # 핵심 원칙 (수술적 정밀도, DRY, SRP)
 │   ├── quality/              # 품질 체크리스트
 │   ├── standards/            # 복잡도, 네이밍, 안티패턴
@@ -182,7 +182,7 @@ AI의 역할과 전문성 정의
 
 ---
 
-## Coding Rules (.agent/rules/)
+## Coding Rules (.vibe/rules/)
 
 ### 핵심 원칙
 

package/bin/vibe

@@ -11,6 +11,18 @@ const fs = require('fs');
 const args = process.argv.slice(2);
 const command = args[0];
 
+// 옵션 파싱
+const options = {
+  silent: args.includes('--silent') || args.includes('-s')
+};
+
+// 로그 함수 (silent 모드 지원)
+function log(message) {
+  if (!options.silent) {
+    console.log(message);
+  }
+}
+
 // 유틸리티 함수
 function ensureDir(dir) {
   if (!fs.existsSync(dir)) {
@@ -43,6 +55,94 @@ function copyDirRecursive(sourceDir, targetDir) {
   });
 }
 
+// 협업자 자동 설치 설정
+function setupCollaboratorAutoInstall(projectRoot) {
+  const packageJsonPath = path.join(projectRoot, 'package.json');
+  const vibeDir = path.join(projectRoot, '.vibe');
+  const packageJson = require('../package.json');
+  const vibeVersion = packageJson.version;
+
+  // 1. Node.js 프로젝트: package.json에 devDependency + postinstall 추가
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+
+      let modified = false;
+
+      // devDependencies에 vibe 추가
+      if (!pkg.devDependencies) {
+        pkg.devDependencies = {};
+      }
+      if (!pkg.devDependencies['@su-record/vibe']) {
+        pkg.devDependencies['@su-record/vibe'] = `^${vibeVersion}`;
+        modified = true;
+      }
+
+      // scripts에 postinstall 추가
+      if (!pkg.scripts) {
+        pkg.scripts = {};
+      }
+      if (!pkg.scripts.postinstall) {
+        pkg.scripts.postinstall = 'vibe update --silent';
+        modified = true;
+      } else if (!pkg.scripts.postinstall.includes('vibe update')) {
+        // 기존 postinstall이 있으면 vibe update 추가
+        pkg.scripts.postinstall = `${pkg.scripts.postinstall} && vibe update --silent`;
+        modified = true;
+      }
+
+      if (modified) {
+        fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n');
+        log('   ✅ package.json에 협업자 자동 설치 설정 추가\n');
+      } else {
+        log('   ℹ️  package.json 협업 설정 이미 존재\n');
+      }
+    } catch (e) {
+      log('   ⚠️  package.json 수정 실패: ' + e.message + '\n');
+    }
+  }
+
+  // 2. 범용: .vibe/setup.sh 생성 (비-Node 프로젝트 또는 추가 지원)
+  const setupShPath = path.join(vibeDir, 'setup.sh');
+  if (!fs.existsSync(setupShPath)) {
+    const setupScript = `#!/bin/bash
+# Vibe 협업자 자동 설치 스크립트
+# 사용법: ./.vibe/setup.sh
+
+set -e
+
+echo "🔧 Vibe 설치 확인 중..."
+
+# npm/npx 확인
+if ! command -v npx &> /dev/null; then
+    echo "❌ Node.js/npm이 설치되어 있지 않습니다."
+    echo "   https://nodejs.org 에서 설치해주세요."
+    exit 1
+fi
+
+# vibe 설치 확인 및 업데이트
+if command -v vibe &> /dev/null; then
+    echo "✅ Vibe가 이미 설치되어 있습니다."
+    vibe update --silent
+    echo "✅ Vibe 업데이트 완료!"
+else
+    echo "📦 Vibe 설치 중..."
+    npm install -g @su-record/vibe
+    vibe update --silent
+    echo "✅ Vibe 설치 및 설정 완료!"
+fi
+
+echo ""
+echo "다음 명령어로 시작하세요:"
+echo "  /vibe.spec \\"기능명\\"    SPEC 작성"
+echo "  /vibe.run \\"기능명\\"     구현 실행"
+`;
+    fs.writeFileSync(setupShPath, setupScript);
+    fs.chmodSync(setupShPath, '755');
+    log('   ✅ 협업자 설치 스크립트 생성 (.vibe/setup.sh)\n');
+  }
+}
+
 // 프로젝트 초기화
 async function init(projectName) {
   try {
@@ -53,34 +153,34 @@ async function init(projectName) {
       projectRoot = path.join(process.cwd(), projectName);
 
       if (fs.existsSync(projectRoot)) {
-        console.log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
+        log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
         return;
       }
 
-      console.log(`📁 새 프로젝트 생성: ${projectName}/\n`);
+      log(`📁 새 프로젝트 생성: ${projectName}/\n`);
       fs.mkdirSync(projectRoot, { recursive: true });
       isNewProject = true;
     }
 
     const vibeDir = path.join(projectRoot, '.vibe');
     if (fs.existsSync(vibeDir)) {
-      console.log('❌ .vibe/ 폴더가 이미 존재합니다.');
+      log('❌ .vibe/ 폴더가 이미 존재합니다.');
       return;
     }
 
     // MCP 서버 등록 (Claude Code)
     const mcpPath = path.join(__dirname, '..', 'node_modules', '@su-record', 'hi-ai', 'dist', 'index.js');
 
-    console.log('🔧 Claude Code MCP 서버 등록 중...\n');
+    log('🔧 Claude Code MCP 서버 등록 중...\n');
     const { execSync } = require('child_process');
     try {
       execSync(`claude mcp add vibe node "${mcpPath}"`, { stdio: 'pipe' });
-      console.log('   ✅ MCP 서버 등록 완료\n');
+      log('   ✅ MCP 서버 등록 완료\n');
     } catch (e) {
       if (e.message.includes('already exists')) {
-        console.log('   ℹ️  MCP 서버 이미 등록됨\n');
+        log('   ℹ️  MCP 서버 이미 등록됨\n');
       } else {
-        console.log('   ⚠️  MCP 수동 등록 필요\n');
+        log('   ⚠️  MCP 수동 등록 필요\n');
       }
     }
 
@@ -98,7 +198,7 @@ async function init(projectName) {
 
     const sourceDir = path.join(__dirname, '../.claude/commands');
     copyDirContents(sourceDir, commandsDir);
-    console.log('   ✅ 슬래시 커맨드 설치 완료 (7개)\n');
+    log('   ✅ 슬래시 커맨드 설치 완료 (7개)\n');
 
     // 설정 파일 생성
     const templatePath = path.join(__dirname, '../templates/constitution-template.md');
@@ -126,28 +226,28 @@ async function init(projectName) {
         // vibe 섹션이 없으면 끝에 추가
         const mergedContent = existingContent.trim() + '\n\n---\n\n' + vibeContent;
         fs.writeFileSync(projectClaudeMd, mergedContent);
-        console.log('   ✅ CLAUDE.md에 vibe 섹션 추가\n');
+        log('   ✅ CLAUDE.md에 vibe 섹션 추가\n');
       } else {
-        console.log('   ℹ️  CLAUDE.md에 vibe 섹션 이미 존재\n');
+        log('   ℹ️  CLAUDE.md에 vibe 섹션 이미 존재\n');
       }
     } else {
       // 없으면 새로 생성
       fs.copyFileSync(vibeClaudeMd, projectClaudeMd);
-      console.log('   ✅ CLAUDE.md 생성\n');
+      log('   ✅ CLAUDE.md 생성\n');
     }
 
-    // .agent/rules/ 복사 (코딩 규칙)
-    const rulesSource = path.join(__dirname, '../.agent/rules');
-    const rulesTarget = path.join(projectRoot, '.agent/rules');
+    // .vibe/rules/ 복사 (코딩 규칙)
+    const rulesSource = path.join(__dirname, '../.vibe/rules');
+    const rulesTarget = path.join(vibeDir, 'rules');
     copyDirRecursive(rulesSource, rulesTarget);
-    console.log('   ✅ 코딩 규칙 설치 완료 (.agent/rules/)\n');
+    log('   ✅ 코딩 규칙 설치 완료 (.vibe/rules/)\n');
 
     // .claude/agents/ 복사 (서브에이전트)
     const agentsDir = path.join(claudeDir, 'agents');
     ensureDir(agentsDir);
     const agentsSourceDir = path.join(__dirname, '../.claude/agents');
     copyDirContents(agentsSourceDir, agentsDir);
-    console.log('   ✅ 서브에이전트 설치 완료 (.claude/agents/)\n');
+    log('   ✅ 서브에이전트 설치 완료 (.claude/agents/)\n');
 
     // .claude/settings.local.json 생성 (Hooks 설정)
     const settingsPath = path.join(claudeDir, 'settings.local.json');
@@ -155,14 +255,17 @@ async function init(projectName) {
       const hooksTemplate = path.join(__dirname, '../templates/hooks-template.json');
       if (fs.existsSync(hooksTemplate)) {
         fs.copyFileSync(hooksTemplate, settingsPath);
-        console.log('   ✅ Hooks 설정 설치 완료 (.claude/settings.local.json)\n');
+        log('   ✅ Hooks 설정 설치 완료 (.claude/settings.local.json)\n');
       }
     } else {
-      console.log('   ℹ️  Hooks 설정 이미 존재\n');
+      log('   ℹ️  Hooks 설정 이미 존재\n');
     }
 
+    // 협업자 자동 설치 설정
+    setupCollaboratorAutoInstall(projectRoot);
+
     // 완료 메시지
-    console.log(`
+    log(`
 ✅ vibe 초기화 완료!
 
 ${isNewProject ? `프로젝트 위치:
@@ -174,17 +277,19 @@ ${isNewProject ? `프로젝트 위치:
   ├── commands/                  # 슬래시 커맨드 (7개)
   ├── agents/                    # 서브에이전트 (simplifier)
   └── settings.local.json        # Hooks 설정 (자동 품질 검증)
-  .agent/rules/                  # 코딩 규칙
-  ├── core/                      # 핵심 원칙
-  ├── quality/                   # 품질 체크리스트
-  └── standards/                 # 코딩 표준
   .vibe/
   ├── config.json                # 프로젝트 설정
   ├── constitution.md            # 프로젝트 원칙
+  ├── setup.sh                   # 협업자 설치 스크립트
+  ├── rules/                     # 코딩 규칙
+  │   ├── core/                  # 핵심 원칙
+  │   ├── quality/               # 품질 체크리스트
+  │   └── languages/             # 언어별 규칙
   ├── specs/                     # SPEC 문서들
   └── features/                  # BDD Feature 파일들
 
 MCP 서버 (hi-ai): ✓
+협업자 자동 설치: ✓
 
 사용법:
   /vibe.spec "기능명"            SPEC 작성 (대화형)
@@ -232,6 +337,21 @@ Workflow:
   `);
 }
 
+// 디렉토리 삭제 (재귀)
+function removeDirRecursive(dirPath) {
+  if (!fs.existsSync(dirPath)) return;
+
+  fs.readdirSync(dirPath).forEach(item => {
+    const itemPath = path.join(dirPath, item);
+    if (fs.statSync(itemPath).isDirectory()) {
+      removeDirRecursive(itemPath);
+    } else {
+      fs.unlinkSync(itemPath);
+    }
+  });
+  fs.rmdirSync(dirPath);
+}
+
 // 프로젝트 업데이트
 async function update() {
   try {
@@ -244,27 +364,40 @@ async function update() {
       return;
     }
 
-    console.log('🔄 vibe 업데이트 중...\n');
+    log('🔄 vibe 업데이트 중...\n');
+
+    // 마이그레이션: .agent/rules/ → .vibe/rules/
+    const oldRulesDir = path.join(projectRoot, '.agent/rules');
+    const oldAgentDir = path.join(projectRoot, '.agent');
+    if (fs.existsSync(oldRulesDir)) {
+      log('   🔄 마이그레이션: .agent/rules/ → .vibe/rules/\n');
+      removeDirRecursive(oldRulesDir);
+      // .agent 폴더가 비어있으면 삭제
+      if (fs.existsSync(oldAgentDir) && fs.readdirSync(oldAgentDir).length === 0) {
+        fs.rmdirSync(oldAgentDir);
+      }
+      log('   ✅ 기존 .agent/rules/ 폴더 정리 완료\n');
+    }
 
     // .claude/commands 업데이트
     const commandsDir = path.join(claudeDir, 'commands');
     ensureDir(commandsDir);
     const sourceDir = path.join(__dirname, '../.claude/commands');
     copyDirContents(sourceDir, commandsDir);
-    console.log('   ✅ 슬래시 커맨드 업데이트 완료 (7개)\n');
+    log('   ✅ 슬래시 커맨드 업데이트 완료 (7개)\n');
 
-    // .agent/rules/ 업데이트
-    const rulesSource = path.join(__dirname, '../.agent/rules');
-    const rulesTarget = path.join(projectRoot, '.agent/rules');
+    // .vibe/rules/ 업데이트
+    const rulesSource = path.join(__dirname, '../.vibe/rules');
+    const rulesTarget = path.join(vibeDir, 'rules');
     copyDirRecursive(rulesSource, rulesTarget);
-    console.log('   ✅ 코딩 규칙 업데이트 완료 (.agent/rules/)\n');
+    log('   ✅ 코딩 규칙 업데이트 완료 (.vibe/rules/)\n');
 
     // .claude/agents/ 업데이트
     const agentsDir = path.join(claudeDir, 'agents');
     ensureDir(agentsDir);
     const agentsSourceDir = path.join(__dirname, '../.claude/agents');
     copyDirContents(agentsSourceDir, agentsDir);
-    console.log('   ✅ 서브에이전트 업데이트 완료 (.claude/agents/)\n');
+    log('   ✅ 서브에이전트 업데이트 완료 (.claude/agents/)\n');
 
     // settings.local.json에 hooks 병합
     const settingsPath = path.join(claudeDir, 'settings.local.json');
@@ -280,26 +413,37 @@ async function update() {
         if (!existingSettings.hooks) {
           existingSettings.hooks = vibeHooks.hooks;
           fs.writeFileSync(settingsPath, JSON.stringify(existingSettings, null, 2));
-          console.log('   ✅ Hooks 설정 추가 완료\n');
+          log('   ✅ Hooks 설정 추가 완료\n');
         } else {
-          console.log('   ℹ️  Hooks 설정 이미 존재\n');
+          log('   ℹ️  Hooks 설정 이미 존재\n');
         }
       } else {
         // 새로 생성
         fs.copyFileSync(hooksTemplate, settingsPath);
-        console.log('   ✅ Hooks 설정 생성 완료\n');
+        log('   ✅ Hooks 설정 생성 완료\n');
       }
     }
 
+    // MCP 서버 등록 확인
+    const mcpPath = path.join(__dirname, '..', 'node_modules', '@su-record', 'hi-ai', 'dist', 'index.js');
+    const { execSync } = require('child_process');
+    try {
+      execSync(`claude mcp add vibe node "${mcpPath}"`, { stdio: 'pipe' });
+      log('   ✅ MCP 서버 등록 완료\n');
+    } catch (e) {
+      // 이미 등록됨 - silent
+    }
+
     const packageJson = require('../package.json');
-    console.log(`
+    log(`
 ✅ vibe 업데이트 완료! (v${packageJson.version})
 
 업데이트된 항목:
   - 슬래시 커맨드 (7개)
-  - 코딩 규칙 (.agent/rules/)
+  - 코딩 규칙 (.vibe/rules/)
   - 서브에이전트 (.claude/agents/)
   - Hooks 설정
+  - MCP 서버
     `);
 
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework",
   "bin": {
     "vibe": "./bin/vibe"

package/templates/hooks-template.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "prompt",
-            "prompt": ".agent/rules/quality/checklist.md 기준으로 방금 수정한 코드를 검토해주세요. 문제가 있으면 간단히 알려주세요."
+            "prompt": ".vibe/rules/quality/checklist.md 기준으로 방금 수정한 코드를 검토해주세요. 문제가 있으면 간단히 알려주세요."
           }
         ]
       }

package/.agent/rules/core/communication-guide.md

@@ -1,104 +0,0 @@
-# 💬 커뮤니케이션 가이드
-
-## ⚠️ 최우선 규칙: 한국어로 응답
-
-**모든 대화, 설명, 주석은 한국어로 작성합니다.**
-
-- ✅ AI 응답: 한국어
-- ✅ 코드 주석: 한국어
-- ✅ 문서: 한국어
-- ✅ 에러 메시지: 한국어
-- ⚠️ 예외: 코드 자체 (함수명, 변수명 등)는 영어
-
-## 3.1 코드 제공 형식
-
-```markdown
-### 작업 범위
-
-"요청하신 대로 UserProfile 컴포넌트의 상태 관리 로직만 수정했습니다."
-
-### 변경 사항 요약
-
-주문 상태 업데이트 로직 개선 - Optimistic updates 적용
-
-### 코드
-
-[완전한 코드 블록]
-
-### 참고사항
-
-- 에러 발생 시 자동 롤백
-- 네트워크 재시도 3회
-```
-
-## 3.2 리뷰 응답 형식
-
-```markdown
-### 개선점
-
-1. memoization 누락 (성능)
-2. error boundary 미적용 (안정성)
-
-### 권장사항
-
-useMemo 적용 및 ErrorBoundary로 감싸기
-```
-
-## 3.3 에러 보고 형식
-
-```markdown
-### 문제
-
-[발생한 문제 명확히 설명]
-
-### 원인
-
-[분석된 원인]
-
-### 해결 방법
-
-[구체적인 해결 단계]
-
-### 예방책
-
-[향후 방지 방법]
-```
-
-## 3.4 변경사항 설명 원칙
-
-- **명확성**: 무엇을 왜 변경했는지 명확히
-- **간결성**: 핵심만 전달
-- **완전성**: 부작용과 주의사항 포함
-- **추적성**: 관련 이슈/요청 참조
-
-## 3.5 특수 명령어 실행
-
-- **"optimize"**: 성능 개선 (memoization, 번들 크기 등)
-- **"enhance accessibility"**: ARIA, 키보드 지원 등 추가
-- **"strengthen types"**: any 제거, 타입 안전성 향상
-- **"cleanup"**: 불필요한 코드 제거 (요청 시에만)
-- **"split"**: 컴포넌트/함수 분리 (요청 시에만)
-
-## 3.6 질문 형식
-
-### 명확성이 필요할 때
-
-```markdown
-다음 사항을 확인해주세요:
-
-1. [구체적인 질문 1]
-2. [구체적인 질문 2]
-
-이 정보가 있으면 더 정확한 구현이 가능합니다.
-```
-
-### 대안 제시
-
-```markdown
-요청하신 방법 외에 다음 대안도 가능합니다:
-
-**방법 A**: [설명] - 장점: [장점], 단점: [단점]
-**방법 B**: [설명] - 장점: [장점], 단점: [단점]
-
-어떤 방식을 선호하시나요?
-```

package/.agent/rules/core/development-philosophy.md

@@ -1,53 +0,0 @@
-# 🏛️ 개발 철학과 원칙 - "왜"에 대한 답
-
-## 1.1 🥇 최우선 순위: 수술적 정밀도
-
-> **⚠️ 이것은 모든 작업에 앞서는 TORY의 첫 번째 원칙입니다.**
->
-> **요청받지 않은 코드는 절대 수정/삭제하지 않습니다.**
-
-### 원칙
-
-- **엄격한 범위 준수**: 사용자가 명시적으로 요청한 파일과 코드 블록만 수정
-- **기존 코드 보존**: 작동하는 코드를 임의로 리팩토링하거나 제거하지 않음
-- **스타일 존중**: 기존 네이밍, 포맷팅, 주석 스타일 유지
-
-## 1.2 핵심 철학
-
-### 🎯 개발의 황금률
-
-- **한국어 우선**: 모든 커뮤니케이션은 명확한 한국어로
-- **단순함의 미학**: 코드가 적을수록 좋은 코드
-- **DRY 원칙**: 반복하지 말고 재사용
-- **단일 책임**: 하나의 함수는 하나의 목적만
-- **실용주의**: 완벽보다 실용, YAGNI 정신
-
-### 🎨 코드 품질 기준
-
-- **가독성**: 코드는 사람을 위한 것
-- **예측 가능성**: 코드에서 놀라움은 금물
-- **유지보수성**: 미래의 나를 배려
-- **테스트 가능성**: 검증 가능한 구조
-
-## 1.3 아키텍처 원칙
-
-### 🏗️ 설계의 지혜
-
-- **패턴의 적절한 적용**: Composite, Observer, Factory 등 필요에 따라 적용
-- **과도한 추상화 지양**: 3단계 이상의 wrapper 금지
-- **순환 의존성 방지**: File A → File B → File A ❌
-
-### ♿ 접근성은 선택이 아닌 필수
-
-- Semantic HTML을 기본으로
-- 키보드 내비게이션 지원
-- 스크린 리더 최적화
-- ARIA 속성 적극 활용
-
-## 핵심 가치
-
-1. **명확성**: 코드는 자기 설명적이어야 함
-2. **간결성**: 불필요한 복잡도 제거
-3. **일관성**: 일관된 패턴과 스타일 유지
-4. **확장성**: 미래의 변화를 고려한 설계
-5. **안전성**: 오류 처리와 엣지 케이스 고려