sleepcode 1.0.0

package/README.md

@@ -0,0 +1,178 @@
+# SleepCode
+
+**AI codes while you sleep** — Claude AI 야간 자동화 세팅 CLI
+
+잠자는 동안 AI가 코드를 작성하고, 빌드하고, 테스트하고, 커밋합니다.
+
+---
+
+## 설치
+
+```bash
+npm install -g sleepcode
+```
+
+또는 npx로 바로 실행:
+
+```bash
+npx sleepcode
+```
+
+---
+
+## 빠른 시작
+
+### 1. 프로젝트 루트에서 실행
+
+```bash
+cd my-project
+npx sleepcode
+```
+
+인터랙티브 모드로 프로젝트 타입, 이름, AI 역할 등을 설정합니다.
+
+### 2. 태스크 작성
+
+`.ai/tasks.md` 에 AI가 수행할 작업을 작성합니다:
+
+```markdown
+# 작업 목록
+
+- [ ] 로그인 화면 구현
+- [ ] 회원가입 API 연동
+- [ ] 홈 화면 UI 개선
+```
+
+### 3. 실행
+
+```bash
+# 1회 실행
+./.ai/ai_worker.sh
+
+# 무한 루프 (tmux 권장)
+tmux new -s ai './.ai/run_forever.sh'
+```
+
+### 4. 아침에 확인
+
+```bash
+git log --oneline --since="12 hours ago"
+```
+
+---
+
+## 지원 프로젝트 타입
+
+| 타입 | 설명 |
+|------|------|
+| `spring-boot` | Spring Boot (Kotlin/Java) — Gradle 빌드/테스트 |
+| `react-native` | React Native (TypeScript) — tsc 타입체크 |
+| `nextjs` | Next.js (TypeScript) — npm build/test/lint |
+| `custom` | 직접 설정 — 빌드/테스트/린트 명령어 수동 입력 |
+
+---
+
+## CLI 옵션
+
+인터랙티브 모드 외에 CLI 인자로도 사용 가능합니다:
+
+```bash
+npx sleepcode --type react-native --name my-app --role "쇼핑몰 앱 개발"
+```
+
+| 옵션 | 설명 |
+|------|------|
+| `--type <type>` | 프로젝트 타입 (`spring-boot`, `react-native`, `nextjs`, `custom`) |
+| `--name <name>` | 프로젝트 이름 |
+| `--role <desc>` | AI 역할 설명 |
+| `--figma-key <key>` | Figma API Key (선택) |
+| `--interval <sec>` | 반복 간격 초 (기본: 30) |
+| `-f, --force` | 기존 `.ai/` 폴더 덮어쓰기 |
+| `-h, --help` | 도움말 |
+
+---
+
+## 생성되는 파일
+
+```
+.ai/
+  rules.md           # AI 역할 + 작업 규칙 (프롬프트)
+  tasks.md           # 작업 목록 (체크리스트)
+  docs/              # 참고 자료 (피그마 스크린샷, 기획서 등)
+  ai_worker.sh       # 1회 실행 스크립트
+  run_forever.sh     # 무한 루프 스크립트
+  log_filter.py      # 실시간 로그 필터
+  logs/              # 실행 로그 (자동 생성)
+  README.md          # 사용 가이드
+
+.claude/
+  settings.local.json  # Claude 권한 설정
+```
+
+---
+
+## 작동 원리
+
+```
+rules.md + tasks.md → 프롬프트 조합 → claude -p (비대화형) → 코드 작성 → git commit → 반복
+```
+
+1. `rules.md`(AI 역할/규칙)와 `tasks.md`(작업 목록)를 합쳐서 프롬프트로 전달
+2. Claude가 태스크를 하나씩 수행 (코드 작성 → 빌드/테스트 → 오류 수정)
+3. 태스크 완료 시 `[x]` 체크 + `git commit`
+4. 모든 태스크 완료되면 자동 종료 (또는 대기 후 반복)
+
+### 실시간 로그
+
+`stream-json` 출력을 `log_filter.py`가 파싱하여 핵심 메시지만 표시합니다:
+
+```
+[TEXT] 로그인 화면을 구현하겠습니다...
+[TOOL] Edit: src/screens/LoginScreen.tsx
+[TOOL] Bash: npx tsc --noEmit
+[TEXT] 타입 체크 통과, 커밋합니다.
+[TOOL] Bash: git commit -m "feat: 로그인 화면 구현"
+[DONE] 완료
+[COST] input: 50,000 / output: 12,000
+```
+
+---
+
+## tmux 관리
+
+| 동작 | 명령어 |
+|------|--------|
+| 세션 생성 + 실행 | `tmux new -s ai './.ai/run_forever.sh'` |
+| 백그라운드 전환 | `Ctrl+B` → `D` |
+| 세션 재접속 | `tmux attach -t ai` |
+| 실시간 로그 | `tail -f .ai/logs/worker_*.log` |
+| 종료 | `tmux attach -t ai` → `Ctrl+C` |
+| 세션 삭제 | `tmux kill-session -t ai` |
+
+---
+
+## 사전 준비
+
+1. [Claude CLI](https://docs.anthropic.com/en/docs/claude-code) 설치
+
+2. `--dangerously-skip-permissions` 최초 1회 동의:
+   ```bash
+   claude --dangerously-skip-permissions
+   # 동의 프롬프트 수락 후 Ctrl+C
+   ```
+
+---
+
+## 커스터마이징
+
+- **AI 역할/규칙 변경**: `.ai/rules.md` 수정
+- **작업 목록 변경**: `.ai/tasks.md` 수정
+- **참고 자료 추가**: `.ai/docs/`에 파일 추가 (스크린샷, 기획서 등)
+- **반복 간격 변경**: `.ai/run_forever.sh`의 `sleep` 값 수정
+- **Claude 권한 변경**: `.claude/settings.local.json` 수정
+
+---
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+
+const readline = require('readline');
+const fs = require('fs');
+const path = require('path');
+
+// ─── 색상 ───
+const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+};
+
+const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
+
+// ─── 프로젝트 타입 정의 ───
+const PROJECT_TYPES = {
+  'spring-boot': {
+    label: 'Spring Boot (Kotlin/Java)',
+    buildCmd: './gradlew build -x test --no-daemon',
+    testCmd: './gradlew test --no-daemon',
+    lintCmd: '',
+  },
+  'react-native': {
+    label: 'React Native (TypeScript)',
+    buildCmd: '',
+    testCmd: '',
+    lintCmd: 'npx tsc --noEmit',
+  },
+  nextjs: {
+    label: 'Next.js (TypeScript)',
+    buildCmd: 'npm run build',
+    testCmd: 'npm test',
+    lintCmd: 'npx next lint',
+  },
+  custom: {
+    label: 'Custom (직접 설정)',
+    buildCmd: '',
+    testCmd: '',
+    lintCmd: '',
+  },
+};
+
+// ─── CLI 인자 파싱 ───
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const parsed = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--type' && args[i + 1]) parsed.type = args[++i];
+    else if (args[i] === '--name' && args[i + 1]) parsed.name = args[++i];
+    else if (args[i] === '--role' && args[i + 1]) parsed.role = args[++i];
+    else if (args[i] === '--figma-key' && args[i + 1]) parsed.figmaKey = args[++i];
+    else if (args[i] === '--interval' && args[i + 1]) parsed.interval = args[++i];
+    else if (args[i] === '--force' || args[i] === '-f') parsed.force = true;
+    else if (args[i] === '--help' || args[i] === '-h') {
+      console.log(`
+사용법: sleepcode [옵션]
+
+옵션 없이 실행하면 인터랙티브 모드로 동작합니다.
+
+옵션:
+  --type <type>        프로젝트 타입 (spring-boot, react-native, nextjs, custom)
+  --name <name>        프로젝트 이름
+  --role <desc>        AI 역할 설명
+  --figma-key <key>    Figma API Key
+  --interval <sec>     반복 간격 (초, 기본 30)
+  -f, --force          기존 .ai/ 덮어쓰기
+  -h, --help           도움말
+`);
+      process.exit(0);
+    }
+  }
+  return parsed;
+}
+
+// ─── 유틸 ───
+function ask(rl, question, defaultVal) {
+  const suffix = defaultVal ? ` ${C.dim}(${defaultVal})${C.reset}` : '';
+  return new Promise((resolve) => {
+    rl.question(`${C.cyan}?${C.reset} ${question}${suffix}: `, (answer) => {
+      resolve(answer.trim() || defaultVal || '');
+    });
+  });
+}
+
+function select(rl, question, options) {
+  return new Promise((resolve) => {
+    console.log(`\n${C.cyan}?${C.reset} ${question}`);
+    options.forEach((opt, i) => {
+      console.log(`  ${C.bold}${i + 1})${C.reset} ${opt.label}`);
+    });
+    rl.question(`${C.cyan}>${C.reset} 번호 선택: `, (answer) => {
+      const idx = parseInt(answer, 10) - 1;
+      if (idx >= 0 && idx < options.length) {
+        resolve(options[idx]);
+      } else {
+        resolve(options[0]);
+      }
+    });
+  });
+}
+
+function writeFile(filePath, content) {
+  const dir = path.dirname(filePath);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(filePath, content);
+}
+
+function generateFiles(targetDir, { typeKey, projectName, role, buildCmd, testCmd, lintCmd, figmaKey, sleepInterval }) {
+  const aiDir = path.join(targetDir, '.ai');
+  const claudeDir = path.join(targetDir, '.claude');
+  fs.mkdirSync(path.join(aiDir, 'docs'), { recursive: true });
+  fs.mkdirSync(path.join(aiDir, 'logs'), { recursive: true });
+  fs.mkdirSync(claudeDir, { recursive: true });
+
+  // 공통 파일 복사
+  const commonFiles = ['ai_worker.sh', 'run_forever.sh', 'log_filter.py', 'README.md'];
+  for (const file of commonFiles) {
+    const src = path.join(TEMPLATES_DIR, 'common', file);
+    const dest = path.join(aiDir, file);
+    if (fs.existsSync(src)) {
+      let content = fs.readFileSync(src, 'utf-8');
+      content = content.replace(/\{\{SLEEP_INTERVAL\}\}/g, sleepInterval);
+      fs.writeFileSync(dest, content);
+    }
+  }
+
+  // 실행 권한
+  fs.chmodSync(path.join(aiDir, 'ai_worker.sh'), 0o755);
+  fs.chmodSync(path.join(aiDir, 'run_forever.sh'), 0o755);
+  fs.chmodSync(path.join(aiDir, 'log_filter.py'), 0o755);
+
+  // docs/.gitkeep
+  writeFile(path.join(aiDir, 'docs', '.gitkeep'), '');
+
+  // tasks.md
+  writeFile(
+    path.join(aiDir, 'tasks.md'),
+    `# 작업 목록
+
+아래 태스크를 순서대로 진행하세요. 완료한 항목은 \`[x]\`로 체크하세요.
+
+---
+
+- [ ] 여기에 첫 번째 작업을 적어주세요
+`
+  );
+
+  // rules.md
+  const rulesTemplate = path.join(TEMPLATES_DIR, 'rules', `${typeKey}.md`);
+  if (fs.existsSync(rulesTemplate)) {
+    let rules = fs.readFileSync(rulesTemplate, 'utf-8');
+    rules = rules.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
+    rules = rules.replace(/\{\{ROLE\}\}/g, role);
+    rules = rules.replace(/\{\{BUILD_CMD\}\}/g, buildCmd);
+    rules = rules.replace(/\{\{TEST_CMD\}\}/g, testCmd);
+    rules = rules.replace(/\{\{LINT_CMD\}\}/g, lintCmd);
+    rules = rules.replace(/\{\{FIGMA_API_KEY\}\}/g, figmaKey);
+
+    if (!figmaKey) {
+      rules = rules.replace(/\n## Figma[\s\S]*?(?=\n## |$)/, '');
+    }
+
+    writeFile(path.join(aiDir, 'rules.md'), rules);
+  }
+
+  // settings.local.json
+  const settingsTemplate = path.join(TEMPLATES_DIR, 'settings', `${typeKey}.json`);
+  if (fs.existsSync(settingsTemplate)) {
+    const content = fs.readFileSync(settingsTemplate, 'utf-8');
+    fs.writeFileSync(path.join(claudeDir, 'settings.local.json'), content);
+  }
+
+  // .gitignore
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  if (fs.existsSync(gitignorePath)) {
+    const gitignore = fs.readFileSync(gitignorePath, 'utf-8');
+    if (!gitignore.includes('.ai/logs/')) {
+      fs.appendFileSync(gitignorePath, '\n# AI worker logs\n.ai/logs/\n');
+    }
+  }
+}
+
+function printResult() {
+  console.log(`\n${C.bold}파일 생성 완료:${C.reset}\n`);
+  console.log(`  ${C.green}✓${C.reset} .ai/rules.md`);
+  console.log(`  ${C.green}✓${C.reset} .ai/tasks.md`);
+  console.log(`  ${C.green}✓${C.reset} .ai/ai_worker.sh`);
+  console.log(`  ${C.green}✓${C.reset} .ai/run_forever.sh`);
+  console.log(`  ${C.green}✓${C.reset} .ai/log_filter.py`);
+  console.log(`  ${C.green}✓${C.reset} .ai/README.md`);
+  console.log(`  ${C.green}✓${C.reset} .ai/docs/`);
+  console.log(`  ${C.green}✓${C.reset} .claude/settings.local.json`);
+
+  console.log(`
+${C.bold}${C.green}완료!${C.reset} 다음 단계:
+
+  ${C.bold}1.${C.reset} .ai/rules.md 를 프로젝트에 맞게 수정
+  ${C.bold}2.${C.reset} .ai/tasks.md 에 작업 목록 작성
+  ${C.bold}3.${C.reset} 실행:
+     ${C.dim}# 1회 실행${C.reset}
+     ./.ai/ai_worker.sh
+
+     ${C.dim}# 무한 루프 (tmux)${C.reset}
+     tmux new -s ai './.ai/run_forever.sh'
+`);
+}
+
+// ─── 메인 ───
+async function main() {
+  const targetDir = process.cwd();
+  const cliArgs = parseArgs();
+
+  console.log(`
+${C.bold}${C.magenta}  ╔══════════════════════════════════╗
+  ║   sleepcode                      ║
+  ║   AI codes while you sleep       ║
+  ╚══════════════════════════════════╝${C.reset}
+`);
+
+  // 비대화형 모드: --type 이 있으면 인터랙티브 스킵
+  if (cliArgs.type) {
+    const typeKey = cliArgs.type;
+    if (!PROJECT_TYPES[typeKey]) {
+      console.error(`${C.red}알 수 없는 타입: ${typeKey}${C.reset}`);
+      console.error(`사용 가능: ${Object.keys(PROJECT_TYPES).join(', ')}`);
+      process.exit(1);
+    }
+
+    if (fs.existsSync(path.join(targetDir, '.ai')) && !cliArgs.force) {
+      console.error(`${C.red}.ai/ 폴더가 이미 존재합니다. --force 로 덮어쓰세요.${C.reset}`);
+      process.exit(1);
+    }
+
+    const typeConfig = PROJECT_TYPES[typeKey];
+    const projectName = cliArgs.name || path.basename(targetDir);
+    const role = cliArgs.role || `${projectName} 서비스 개발`;
+    const figmaKey = cliArgs.figmaKey || '';
+    const sleepInterval = cliArgs.interval || '30';
+
+    console.log(`${C.dim}타입: ${typeConfig.label}${C.reset}`);
+    console.log(`${C.dim}이름: ${projectName}${C.reset}`);
+    console.log(`${C.dim}역할: ${role}${C.reset}`);
+
+    generateFiles(targetDir, {
+      typeKey,
+      projectName,
+      role,
+      buildCmd: typeConfig.buildCmd,
+      testCmd: typeConfig.testCmd,
+      lintCmd: typeConfig.lintCmd,
+      figmaKey,
+      sleepInterval,
+    });
+
+    printResult();
+    return;
+  }
+
+  // 인터랙티브 모드
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    if (fs.existsSync(path.join(targetDir, '.ai'))) {
+      console.log(`${C.yellow}⚠ .ai/ 폴더가 이미 존재합니다.${C.reset}`);
+      const overwrite = await ask(rl, '덮어쓸까요? (y/N)', 'N');
+      if (overwrite.toLowerCase() !== 'y') {
+        console.log('취소됨.');
+        rl.close();
+        return;
+      }
+    }
+
+    const typeOptions = Object.entries(PROJECT_TYPES).map(([key, val]) => ({
+      key,
+      label: val.label,
+    }));
+    const selectedType = await select(rl, '프로젝트 타입', typeOptions);
+    const typeKey = selectedType.key;
+    const typeConfig = PROJECT_TYPES[typeKey];
+
+    const projectName = await ask(rl, '프로젝트 이름', path.basename(targetDir));
+    const role = await ask(rl, 'AI 역할 설명', `${projectName} 서비스 개발`);
+
+    let buildCmd = typeConfig.buildCmd;
+    let testCmd = typeConfig.testCmd;
+    let lintCmd = typeConfig.lintCmd;
+
+    if (typeKey === 'custom') {
+      buildCmd = await ask(rl, '빌드 커맨드 (없으면 Enter)', '');
+      testCmd = await ask(rl, '테스트 커맨드 (없으면 Enter)', '');
+      lintCmd = await ask(rl, '린트 커맨드 (없으면 Enter)', '');
+    } else {
+      console.log(`${C.dim}  빌드: ${buildCmd || '(없음)'}${C.reset}`);
+      console.log(`${C.dim}  테스트: ${testCmd || '(없음)'}${C.reset}`);
+      console.log(`${C.dim}  린트: ${lintCmd || '(없음)'}${C.reset}`);
+    }
+
+    const figmaKey = await ask(rl, 'Figma API Key (없으면 Enter)', '');
+    const sleepInterval = await ask(rl, '반복 간격 (초)', '30');
+
+    rl.close();
+
+    generateFiles(targetDir, {
+      typeKey,
+      projectName,
+      role,
+      buildCmd,
+      testCmd,
+      lintCmd,
+      figmaKey,
+      sleepInterval,
+    });
+
+    printResult();
+  } catch (e) {
+    console.error(`${C.red}오류: ${e.message}${C.reset}`);
+    rl.close();
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "sleepcode",
+  "version": "1.0.0",
+  "description": "AI codes while you sleep — Claude AI 야간 자동화 세팅 CLI",
+  "bin": {
+    "sleepcode": "bin/index.js"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "automation",
+    "coding",
+    "nightshift",
+    "sleepcode"
+  ],
+  "license": "MIT"
+}

package/templates/common/README.md

@@ -0,0 +1,97 @@
+# SleepCode
+
+AI codes while you sleep — 밤새 개발 작업을 자동화하는 시스템입니다.
+
+---
+
+## 폴더 구조
+
+```
+.ai/
+  rules.md         # AI 역할 + 작업 규칙
+  tasks.md         # 오늘 진행할 작업 목록
+  docs/            # 개발 참고 자료 (피그마 스크린샷, 기획서 등)
+  ai_worker.sh     # 1회 실행 스크립트
+  run_forever.sh   # 무한 루프 감시자 스크립트
+  log_filter.py    # 로그 필터 (핵심 메시지만 추출)
+  logs/            # 실행 로그 (자동 생성)
+```
+
+---
+
+## 작동 원리
+
+1. `claude -p` 로 비대화형 모드 실행
+2. `rules.md` + `tasks.md` 를 합쳐서 프롬프트로 전달
+3. AI가 코드 작성 → 빌드/테스트 → 오류 수정 → git commit
+4. 대기 후 다시 반복
+
+---
+
+## 실행 방법
+
+### 1. 권한 부여
+
+```bash
+chmod +x .ai/*.sh
+```
+
+### 2. (최초 1회) --dangerously-skip-permissions 수락
+
+```bash
+claude --dangerously-skip-permissions
+```
+
+동의 프롬프트가 뜨면 수락 후 `Ctrl + C`로 나옵니다.
+
+### 3. tmux 세션 생성 + 실행
+
+```bash
+tmux new -s ai './.ai/run_forever.sh'
+```
+
+### 4. tmux 분리 (백그라운드 전환)
+
+```
+Ctrl + B → D
+```
+
+---
+
+## 수동 1회 실행
+
+```bash
+./.ai/ai_worker.sh
+```
+
+---
+
+## 관리 명령어
+
+| 동작 | 명령어 |
+|------|--------|
+| 세션 재접속 | `tmux attach -t ai` |
+| 실시간 로그 | `tail -f .ai/logs/worker_*.log` |
+| 종료 | `tmux attach -t ai` → `Ctrl + C` |
+| 세션 삭제 | `tmux kill-session -t ai` |
+
+---
+
+## 아침 확인
+
+```bash
+# 밤 동안의 커밋 확인
+git log --oneline --since="12 hours ago"
+
+# 로그 확인
+tail -100 .ai/logs/worker_*.log
+```
+
+---
+
+## 커스터마이징
+
+- **역할/규칙 변경**: `.ai/rules.md` 수정
+- **태스크 변경**: `.ai/tasks.md` 수정
+- **참고 자료 추가**: `.ai/docs/` 에 파일 추가
+- **반복 간격 변경**: `run_forever.sh` 의 `sleep` 값 수정

package/templates/common/ai_worker.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+# AI Worker - 1회 실행 스크립트
+# run_forever.sh (무한 루프) 대신 수동으로 1회만 돌릴 때 사용
+
+cd "$(dirname "$0")/.." || exit 1
+
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] AI 단일 실행 시작"
+
+RULES=$(cat .ai/rules.md)
+TASKS=$(cat .ai/tasks.md)
+
+PROMPT="${RULES}
+
+---
+
+${TASKS}"
+
+# stream-json + verbose: 토큰 단위 실시간 출력
+claude -p "$PROMPT" --dangerously-skip-permissions --output-format stream-json --verbose 2>&1 \
+  | python3 .ai/log_filter.py
+
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] AI 단일 실행 종료"

package/templates/common/log_filter.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""
+stream-json 출력에서 핵심 메시지만 추출하는 필터.
+Usage: claude ... --output-format stream-json | python3 .ai/log_filter.py
+"""
+import sys
+import json
+
+for line in sys.stdin:
+    line = line.strip()
+    if not line:
+        continue
+    try:
+        obj = json.loads(line)
+    except json.JSONDecodeError:
+        continue
+
+    msg_type = obj.get("type")
+
+    # assistant 메시지만 처리
+    if msg_type == "assistant":
+        message = obj.get("message", {})
+        contents = message.get("content", [])
+        for c in contents:
+            ctype = c.get("type")
+            if ctype == "text":
+                text = c.get("text", "").strip()
+                if text:
+                    print(f"[TEXT] {text}", flush=True)
+            elif ctype == "tool_use":
+                name = c.get("name", "?")
+                inp = c.get("input", {})
+                # 도구별 핵심 파라미터만 요약
+                if name in ("Read", "Write", "Edit"):
+                    param = inp.get("file_path", "")
+                    print(f"[TOOL] {name}: {param}", flush=True)
+                elif name == "Bash":
+                    cmd = inp.get("command", "")
+                    if len(cmd) > 120:
+                        cmd = cmd[:120] + "..."
+                    print(f"[TOOL] Bash: {cmd}", flush=True)
+                elif name == "Glob":
+                    print(f"[TOOL] Glob: {inp.get('pattern', '')}", flush=True)
+                elif name == "Grep":
+                    print(f"[TOOL] Grep: {inp.get('pattern', '')}", flush=True)
+                elif name == "TodoWrite":
+                    todos = inp.get("todos", [])
+                    active = [t for t in todos if t.get("status") == "in_progress"]
+                    if active:
+                        print(f"[TODO] {active[0].get('activeForm', '')}", flush=True)
+                else:
+                    print(f"[TOOL] {name}", flush=True)
+
+    # 최종 결과
+    elif msg_type == "result":
+        message = obj.get("message", "")
+        if isinstance(message, str) and message:
+            short = message[:200] + "..." if len(message) > 200 else message
+            print(f"[DONE] {short}", flush=True)
+        cost = obj.get("cost_usd")
+        duration = obj.get("duration_ms")
+        if cost is not None:
+            print(f"[COST] ${cost:.4f} | {(duration or 0) / 1000:.0f}s", flush=True)

package/templates/common/run_forever.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+
+# AI Night Worker - 감시자 스크립트
+# 사용법: tmux new -s ai './.ai/run_forever.sh'
+
+cd "$(dirname "$0")/.." || exit 1
+
+LOG_DIR=".ai/logs"
+mkdir -p "$LOG_DIR"
+LOG_FILE="$LOG_DIR/worker_$(date +%Y%m%d_%H%M%S).log"
+
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
+}
+
+log "=== AI Night Worker 시작 ==="
+log "로그 파일: $LOG_FILE"
+
+ITERATION=0
+
+while true; do
+  ITERATION=$((ITERATION + 1))
+  log "--- 반복 #${ITERATION} 시작 ---"
+
+  # 미완료 태스크가 있는지 확인
+  REMAINING=$(grep -c '\[ \]' .ai/tasks.md 2>/dev/null || echo "0")
+  log "남은 태스크: ${REMAINING}개"
+
+  if [ "$REMAINING" -eq 0 ]; then
+    log "=== 모든 태스크 완료. 종료합니다. ==="
+    exit 0
+  fi
+
+  # rules.md + tasks.md 를 합쳐서 프롬프트 구성
+  RULES=$(cat .ai/rules.md)
+  TASKS=$(cat .ai/tasks.md)
+
+  PROMPT="${RULES}
+
+---
+
+${TASKS}"
+
+  log "claude 실행 중..."
+  # stream-json → log_filter.py 로 핵심 메시지만 추출
+  claude -p "$PROMPT" --dangerously-skip-permissions --output-format stream-json --verbose 2>&1 \
+    | python3 .ai/log_filter.py \
+    | tee -a "$LOG_FILE"
+  EXIT_CODE=${PIPESTATUS[0]}
+  log "claude 종료 (exit code: $EXIT_CODE)"
+
+  # 미커밋 변경사항 체크
+  if [[ -n $(git status --porcelain) ]]; then
+    log "경고: 커밋되지 않은 변경사항 감지"
+  fi
+
+  log "--- 반복 #${ITERATION} 종료, {{SLEEP_INTERVAL}}초 대기 ---"
+  sleep {{SLEEP_INTERVAL}}
+done

package/templates/rules/custom.md

@@ -0,0 +1,69 @@
+# AI 작업 설정
+
+## 역할
+
+당신은 시니어 개발자입니다.
+
+목표: {{ROLE}}
+
+---
+
+## 기본 원칙
+
+- 절대로 사용자에게 질문하지 않는다.
+- 작업이 끝났다고 판단하지 않는다.
+- 항상 다음 작업을 스스로 찾는다.
+- 가능한 한 많은 기능을 구현하며 계속 진행한다.
+
+---
+
+## 참고 자료
+
+- `.ai/docs/` 디렉토리에 업로드된 파일 참고
+
+## Figma
+
+- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
+
+---
+
+## 작업 방식
+
+- 작은 단위로 작업하고 자주 확인한다.
+- 오류가 발생하면 자동으로 수정한다.
+
+---
+
+## 문제 해결
+
+- 오류가 발생하면 원인을 분석하고 직접 수정한다.
+- 누락된 파일이 있으면 생성한다.
+
+---
+
+## 코드 작성 규칙
+
+- 기존 프로젝트 구조와 패턴을 존중한다.
+- 중복 코드를 만들지 않는다.
+
+---
+
+## 태스크 완료 처리
+
+- `.ai/tasks.md` 파일에서 작업 목록을 확인한다.
+- 태스크를 **한 항목씩** 순서대로 진행한다.
+- 한 항목을 완료하면 반드시 아래 순서를 따른다:
+  1. 해당 항목의 `[ ]`를 `[x]`로 변경한다.
+  2. 관련 파일을 모두 `git add` 한다. (tasks.md 포함)
+  3. `git commit` 한다. (커밋 메시지에 태스크 내용을 포함)
+  4. 그 다음 항목으로 넘어간다.
+- 여러 항목을 한꺼번에 작업하지 않는다. 반드시 1항목 = 1커밋이다.
+
+---
+
+## Git 작업 규칙
+
+- tasks.md의 항목 1개 완료 = git commit 1개. 이 규칙을 반드시 지킨다.
+- 작업 중간에는 commit 하지 않는다.
+- 기능이 정상 동작한다고 판단되면 commit 한다.
+- commit message 는 변경 내용을 구체적으로 설명한다.

package/templates/rules/nextjs.md

@@ -0,0 +1,77 @@
+# AI 작업 설정
+
+## 역할
+
+당신은 Next.js + TypeScript 시니어 풀스택 개발자입니다.
+
+목표: {{ROLE}}
+
+---
+
+## 기본 원칙
+
+- 절대로 사용자에게 질문하지 않는다.
+- 작업이 끝났다고 판단하지 않는다.
+- 항상 다음 작업을 스스로 찾는다.
+- 가능한 한 많은 기능을 구현하며 계속 진행한다.
+
+---
+
+## 참고 자료
+
+- `.ai/docs/` 디렉토리에 업로드된 파일 참고 (피그마 스크린샷, 기획서, 참고 이미지 등)
+
+## Figma
+
+- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
+
+---
+
+## 작업 방식
+
+- 작은 단위로 작업하고 자주 확인한다.
+- 코드 작성 후 반드시 빌드를 시도한다: `{{BUILD_CMD}}`
+- 린트도 확인한다: `{{LINT_CMD}}`
+- 오류가 발생하면 자동으로 수정한다.
+- 수정 후 반드시 다시 빌드를 시도한다.
+
+---
+
+## 문제 해결
+
+- 타입 오류가 발생하면 원인을 분석하고 직접 수정한다.
+- 누락된 파일이나 컴포넌트가 있으면 생성한다.
+- import 경로가 잘못되었으면 수정한다.
+- 필요한 패키지가 없으면 `npm install`로 설치한다.
+
+---
+
+## 코드 작성 규칙
+
+- TypeScript strict 모드를 준수한다.
+- 기존 프로젝트 구조와 패턴을 존중한다.
+- 중복 코드를 만들지 않는다.
+- App Router 구조를 따른다.
+- Server Component / Client Component 를 적절히 구분한다.
+
+---
+
+## 태스크 완료 처리
+
+- `.ai/tasks.md` 파일에서 작업 목록을 확인한다.
+- 태스크를 **한 항목씩** 순서대로 진행한다.
+- 한 항목을 완료하면 반드시 아래 순서를 따른다:
+  1. 해당 항목의 `[ ]`를 `[x]`로 변경한다.
+  2. 관련 파일을 모두 `git add` 한다. (tasks.md 포함)
+  3. `git commit` 한다. (커밋 메시지에 태스크 내용을 포함)
+  4. 그 다음 항목으로 넘어간다.
+- 여러 항목을 한꺼번에 작업하지 않는다. 반드시 1항목 = 1커밋이다.
+
+---
+
+## Git 작업 규칙
+
+- tasks.md의 항목 1개 완료 = git commit 1개. 이 규칙을 반드시 지킨다.
+- 작업 중간에는 commit 하지 않는다.
+- 기능이 정상 동작한다고 판단되면 commit 한다.
+- commit message 는 변경 내용을 구체적으로 설명한다.

package/templates/rules/react-native.md

@@ -0,0 +1,76 @@
+# AI 작업 설정
+
+## 역할
+
+당신은 React Native + TypeScript 시니어 모바일 개발자입니다.
+
+목표: {{ROLE}}
+
+---
+
+## 기본 원칙
+
+- 절대로 사용자에게 질문하지 않는다.
+- 작업이 끝났다고 판단하지 않는다.
+- 항상 다음 작업을 스스로 찾는다.
+- 가능한 한 많은 기능을 구현하며 계속 진행한다.
+
+---
+
+## 참고 자료
+
+- `.ai/docs/` 디렉토리에 업로드된 파일 참고 (피그마 스크린샷, 기획서, 참고 이미지 등)
+
+## Figma
+
+- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
+
+---
+
+## 작업 방식
+
+- 작은 단위로 작업하고 자주 확인한다.
+- 코드 작성 후 반드시 타입 체크를 시도한다: `{{LINT_CMD}}`
+- 오류가 발생하면 자동으로 수정한다.
+- 수정 후 반드시 다시 타입 체크를 시도한다.
+
+---
+
+## 문제 해결
+
+- 타입 오류가 발생하면 원인을 분석하고 직접 수정한다.
+- 누락된 파일이나 컴포넌트가 있으면 생성한다.
+- import 경로가 잘못되었으면 수정한다.
+- 필요한 패키지가 없으면 `npm install`로 설치한다.
+
+---
+
+## 코드 작성 규칙
+
+- TypeScript strict 모드를 준수한다.
+- 기존 프로젝트 구조와 패턴을 존중한다.
+- 중복 코드를 만들지 않는다.
+- 기존 컴포넌트를 최대한 재사용한다.
+- 새 컴포넌트는 기존 디렉토리 구조에 맞게 배치한다.
+
+---
+
+## 태스크 완료 처리
+
+- `.ai/tasks.md` 파일에서 작업 목록을 확인한다.
+- 태스크를 **한 항목씩** 순서대로 진행한다.
+- 한 항목을 완료하면 반드시 아래 순서를 따른다:
+  1. 해당 항목의 `[ ]`를 `[x]`로 변경한다.
+  2. 관련 파일을 모두 `git add` 한다. (tasks.md 포함)
+  3. `git commit` 한다. (커밋 메시지에 태스크 내용을 포함)
+  4. 그 다음 항목으로 넘어간다.
+- 여러 항목을 한꺼번에 작업하지 않는다. 반드시 1항목 = 1커밋이다.
+
+---
+
+## Git 작업 규칙
+
+- tasks.md의 항목 1개 완료 = git commit 1개. 이 규칙을 반드시 지킨다.
+- 작업 중간에는 commit 하지 않는다.
+- 기능이 정상 동작한다고 판단되면 commit 한다.
+- commit message 는 변경 내용을 구체적으로 설명한다.

package/templates/rules/spring-boot.md

@@ -0,0 +1,78 @@
+# AI 작업 설정
+
+## 역할
+
+당신은 Spring Boot + Kotlin을 사용하는 시니어 백엔드 개발자입니다.
+
+목표: {{ROLE}}
+
+---
+
+## 기본 원칙
+
+- 절대로 사용자에게 질문하지 않는다.
+- 작업이 끝났다고 판단하지 않는다.
+- 항상 다음 작업을 스스로 찾는다.
+- 가능한 한 많은 기능을 구현하며 계속 진행한다.
+
+---
+
+## 참고 자료
+
+- `.ai/docs/` 디렉토리에 업로드된 파일 참고 (ERD, 화면설계, API 명세 등)
+
+## Figma
+
+- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
+
+---
+
+## 작업 방식
+
+- 작은 단위로 작업하고 자주 테스트한다.
+- 코드 작성 후 반드시 빌드를 시도한다: `{{BUILD_CMD}}`
+- 테스트 코드 작성 후 반드시 테스트를 실행한다: `{{TEST_CMD}}`
+- 오류가 발생하면 자동으로 수정한다.
+- 수정 후 반드시 다시 빌드/테스트를 시도한다.
+
+---
+
+## 문제 해결
+
+- 컴파일 오류가 발생하면 원인을 분석하고 직접 수정한다.
+- 누락된 파일이나 클래스가 있으면 생성한다.
+- 필요한 패키지 구조가 없으면 직접 만든다.
+- 테스트 실패 시 테스트 코드 또는 구현 코드를 수정한다.
+
+---
+
+## 코드 작성 규칙
+
+- Kotlin 코딩 컨벤션을 따른다.
+- 기존 프로젝트 구조와 패턴을 존중한다.
+- 중복 코드를 만들지 않는다.
+- REST API는 일관된 응답 형식을 유지한다.
+- Entity ↔ DTO 변환을 명확히 분리한다.
+- Service 계층에 비즈니스 로직을 집중한다.
+
+---
+
+## 태스크 완료 처리
+
+- `.ai/tasks.md` 파일에서 작업 목록을 확인한다.
+- 태스크를 **한 항목씩** 순서대로 진행한다.
+- 한 항목을 완료하면 반드시 아래 순서를 따른다:
+  1. 해당 항목의 `[ ]`를 `[x]`로 변경한다.
+  2. 관련 파일을 모두 `git add` 한다. (tasks.md 포함)
+  3. `git commit` 한다. (커밋 메시지에 태스크 내용을 포함)
+  4. 그 다음 항목으로 넘어간다.
+- 여러 항목을 한꺼번에 작업하지 않는다. 반드시 1항목 = 1커밋이다.
+
+---
+
+## Git 작업 규칙
+
+- tasks.md의 항목 1개 완료 = git commit 1개. 이 규칙을 반드시 지킨다.
+- 작업 중간에는 commit 하지 않는다.
+- 기능이 정상 동작한다고 판단되면 commit 한다.
+- commit message 는 변경 내용을 구체적으로 설명한다.

package/templates/settings/custom.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git status:*)",
+      "Bash(git log:*)",
+      "Bash(git diff:*)",
+      "Bash(git checkout:*)",
+      "Bash(git reset:*)",
+      "Bash(python3:*)",
+      "Bash(ls:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(cat:*)",
+      "Bash(chmod:*)"
+    ]
+  }
+}

package/templates/settings/nextjs.json

@@ -0,0 +1,30 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm install:*)",
+      "Bash(npm uninstall:*)",
+      "Bash(npm run:*)",
+      "Bash(npm start:*)",
+      "Bash(npm ls:*)",
+      "Bash(npm test:*)",
+      "Bash(npx tsc:*)",
+      "Bash(npx eslint:*)",
+      "Bash(npx next:*)",
+      "Bash(npx prisma:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git status:*)",
+      "Bash(git log:*)",
+      "Bash(git diff:*)",
+      "Bash(git checkout:*)",
+      "Bash(git reset:*)",
+      "Bash(node:*)",
+      "Bash(python3:*)",
+      "Bash(ls:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(cat:*)",
+      "Bash(chmod:*)"
+    ]
+  }
+}

package/templates/settings/react-native.json

@@ -0,0 +1,30 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm install:*)",
+      "Bash(npm uninstall:*)",
+      "Bash(npm run:*)",
+      "Bash(npm start:*)",
+      "Bash(npm ls:*)",
+      "Bash(npx tsc:*)",
+      "Bash(npx eslint:*)",
+      "Bash(npx react-native:*)",
+      "Bash(yarn add:*)",
+      "Bash(pod install:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git status:*)",
+      "Bash(git log:*)",
+      "Bash(git diff:*)",
+      "Bash(git checkout:*)",
+      "Bash(git reset:*)",
+      "Bash(node:*)",
+      "Bash(python3:*)",
+      "Bash(ls:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(cat:*)",
+      "Bash(chmod:*)"
+    ]
+  }
+}

package/templates/settings/spring-boot.json

@@ -0,0 +1,24 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(./gradlew build:*)",
+      "Bash(./gradlew test:*)",
+      "Bash(./gradlew bootRun:*)",
+      "Bash(./gradlew:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git status:*)",
+      "Bash(git log:*)",
+      "Bash(git diff:*)",
+      "Bash(git checkout:*)",
+      "Bash(git reset:*)",
+      "Bash(python3:*)",
+      "Bash(curl:*)",
+      "Bash(ls:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(cat:*)",
+      "Bash(chmod:*)"
+    ]
+  }
+}