sleepcode 1.2.0 → 1.4.0

package/.claude/settings.local.json

@@ -11,7 +11,8 @@
       "Bash(npm publish)",
       "Bash(npm version:*)",
       "Bash(NPM_TOKEN=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 npm publish:*)",
-      "Bash(NPM_TOKEN=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 npm publish)"
+      "Bash(NPM_TOKEN=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 npm publish)",
+      "Bash(git push:*)"
     ]
   }
 }

package/README.md

@@ -31,7 +31,22 @@ npx sleepcode
 
 인터랙티브 모드로 프로젝트 타입, 이름, AI 역할 등을 설정합니다.
 
-### 2. 태스크 작성
+### 2. 참고 자료 추가
+
+`.sleepcode/docs/`에 기획서, 피그마 스크린샷 등 참고 자료를 넣습니다.
+
+### 3. 태스크 작성
+
+**방법 A: 자동 생성 (추천)**
+
+```bash
+npx sleepcode generate
+```
+
+참고 자료(docs/, Figma, Notion)와 프로젝트 구조를 분석해서 `tasks.md`를 자동 생성합니다.
+이미 구현된 기능은 제외됩니다.
+
+**방법 B: 직접 작성**
 
 `.sleepcode/tasks.md` 에 AI가 수행할 작업을 작성합니다:
 
@@ -43,27 +58,19 @@ npx sleepcode
 - [ ] 홈 화면 UI 개선
 ```
 
-### 3. 실행
+### 4. 실행
 
-**macOS / Linux:**
 ```bash
 # 1회 실행
-./.sleepcode/scripts/ai_worker.sh
+npx sleepcode run
 
-# 무한 루프 (tmux 권장)
-tmux new -s ai './.sleepcode/scripts/run_forever.sh'
+# 무한 루프 (잠자기 전)
+npx sleepcode run --loop
 ```
 
-**Windows (PowerShell):**
-```powershell
-# 1회 실행
-powershell -File .\.sleepcode\scripts\ai_worker.ps1
-
-# 무한 루프
-powershell -File .\.sleepcode\scripts\run_forever.ps1
-```
+OS에 맞는 스크립트를 자동으로 선택합니다 (macOS/Linux: `.sh`, Windows: `.ps1`).
 
-### 4. 아침에 확인
+### 5. 아침에 확인
 
 ```bash
 git log --oneline --since="12 hours ago"
@@ -82,6 +89,15 @@ git log --oneline --since="12 hours ago"
 
 ---
 
+## CLI 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `npx sleepcode` | 인터랙티브 초기화 |
+| `npx sleepcode run` | 1회 실행 |
+| `npx sleepcode run --loop` | 무한 루프 실행 |
+| `npx sleepcode generate` | 참고자료 기반 tasks.md 자동 생성 |
+
 ## CLI 옵션
 
 인터랙티브 모드 외에 CLI 인자로도 사용 가능합니다:
@@ -96,6 +112,9 @@ npx sleepcode --type react-native --name my-app --role "쇼핑몰 앱 개발"
 | `--name <name>` | 프로젝트 이름 |
 | `--role <desc>` | AI 역할 설명 |
 | `--figma-key <key>` | Figma API Key (선택) |
+| `--figma-file <name>` | Figma 참고 파일명 (선택) |
+| `--notion-key <key>` | Notion API Key (선택) |
+| `--notion-page <name>` | Notion 참고 페이지명 (선택) |
 | `--interval <sec>` | 반복 간격 초 (기본: 30) |
 | `-f, --force` | 기존 `.sleepcode/` 폴더 덮어쓰기 |
 | `-h, --help` | 도움말 |
@@ -109,7 +128,8 @@ npx sleepcode --type react-native --name my-app --role "쇼핑몰 앱 개발"
   rules.md               # ✏️ AI 역할 + 작업 규칙 (수정하세요)
   tasks.md               # ✏️ 작업 목록 (수정하세요)
   docs/                  # ✏️ 참고 자료 (피그마 스크린샷, 기획서 등)
-  scripts/               # ⚙️ 시스템 스크립트 (수정하지 마세요)
+  scripts/               # ⚙️ 시스템 (수정하지 마세요)
+    base_rules.md        #    공통 작업 규칙
     ai_worker.sh/.ps1    #    1회 실행 스크립트 (OS별)
     run_forever.sh/.ps1  #    무한 루프 스크립트 (OS별)
     log_filter.py        #    실시간 로그 필터
@@ -153,7 +173,7 @@ rules.md + tasks.md → 프롬프트 조합 → claude -p (비대화형) → 코
 
 | 동작 | 명령어 |
 |------|--------|
-| 세션 생성 + 실행 | `tmux new -s ai './.sleepcode/scripts/run_forever.sh'` |
+| 세션 생성 + 실행 | `tmux new -s ai 'npx sleepcode run --loop'` |
 | 백그라운드 전환 | `Ctrl+B` → `D` |
 | 세션 재접속 | `tmux attach -t ai` |
 | 실시간 로그 | `tail -f .sleepcode/logs/worker_*.log` |

package/bin/index.js

@@ -190,19 +190,32 @@ function parseArgs() {
     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] === '--figma-file' && args[i + 1]) parsed.figmaFileNames = args[++i];
+    else if (args[i] === '--notion-key' && args[i + 1]) parsed.notionKey = args[++i];
+    else if (args[i] === '--notion-page' && args[i + 1]) parsed.notionPages = 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 [옵션]
+       sleepcode run [--loop]
+       sleepcode generate
 
 옵션 없이 실행하면 인터랙티브 모드로 동작합니다.
 
+명령어:
+  run              1회 실행 (ai_worker 스크립트)
+  run --loop       무한 루프 실행 (run_forever 스크립트)
+  generate         참고자료 기반으로 tasks.md 자동 생성
+
 옵션:
   --type <type>        프로젝트 타입 (spring-boot, react-native, nextjs, custom)
   --name <name>        프로젝트 이름
   --role <desc>        AI 역할 설명
   --figma-key <key>    Figma API Key
+  --figma-file <name>  Figma 참고 파일명
+  --notion-key <key>   Notion API Key
+  --notion-page <name> Notion 참고 페이지명
   --interval <sec>     반복 간격 (초, 기본 30)
   -f, --force          기존 .sleepcode/ 덮어쓰기
   -h, --help           도움말
@@ -246,7 +259,7 @@ function writeFile(filePath, content) {
   fs.writeFileSync(filePath, content);
 }
 
-function generateFiles(targetDir, { typeKey, projectName, role, buildCmd, testCmd, lintCmd, figmaKey, sleepInterval }) {
+function generateFiles(targetDir, { typeKey, projectName, role, buildCmd, testCmd, lintCmd, figmaKey, figmaFileNames, notionKey, notionPages, sleepInterval }) {
   const scDir = path.join(targetDir, '.sleepcode');
   const claudeDir = path.join(targetDir, '.claude');
   fs.mkdirSync(path.join(scDir, 'docs'), { recursive: true });
@@ -270,6 +283,36 @@ function generateFiles(targetDir, { typeKey, projectName, role, buildCmd, testCm
     }
   }
 
+  // base_rules.md → scripts/ 하위로 복사 (Figma/Notion 섹션 조건부 처리)
+  const baseRulesSrc = path.join(TEMPLATES_DIR, 'common', 'base_rules.md');
+  if (fs.existsSync(baseRulesSrc)) {
+    let baseRules = fs.readFileSync(baseRulesSrc, 'utf-8');
+
+    // Figma 섹션
+    if (figmaKey) {
+      let figmaSection = `## Figma\n\n- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: \`${figmaKey}\`)`;
+      if (figmaFileNames) {
+        figmaSection += `\n- **참고 파일**: ${figmaFileNames}`;
+      }
+      baseRules = baseRules.replace('{{FIGMA_SECTION}}', figmaSection);
+    } else {
+      baseRules = baseRules.replace('\n{{FIGMA_SECTION}}\n', '');
+    }
+
+    // Notion 섹션
+    if (notionKey) {
+      let notionSection = `\n## Notion\n\n- **기획/문서**: Notion MCP 도구로 직접 조회 가능 (API Key: \`${notionKey}\`)`;
+      if (notionPages) {
+        notionSection += `\n- **참고 페이지**: ${notionPages}`;
+      }
+      baseRules = baseRules.replace('{{NOTION_SECTION}}', notionSection);
+    } else {
+      baseRules = baseRules.replace('\n{{NOTION_SECTION}}\n', '');
+    }
+
+    fs.writeFileSync(path.join(scDir, 'scripts', 'base_rules.md'), baseRules);
+  }
+
   // README.md → .sleepcode/ 루트에 복사
   const readmeSrc = path.join(TEMPLATES_DIR, 'common', 'README.md');
   if (fs.existsSync(readmeSrc)) {
@@ -308,12 +351,6 @@ function generateFiles(targetDir, { typeKey, projectName, role, buildCmd, testCm
     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(scDir, 'rules.md'), rules);
   }
 
@@ -342,44 +379,195 @@ function printResult() {
   console.log(`  ${C.green}✓${C.reset} .sleepcode/rules.md          ${C.dim}← 수정하세요${C.reset}`);
   console.log(`  ${C.green}✓${C.reset} .sleepcode/tasks.md          ${C.dim}← 수정하세요${C.reset}`);
   console.log(`  ${C.green}✓${C.reset} .sleepcode/docs/             ${C.dim}← 참고자료 추가${C.reset}`);
+  console.log(`  ${C.green}✓${C.reset} .sleepcode/scripts/base_rules.md`);
   console.log(`  ${C.green}✓${C.reset} .sleepcode/scripts/${workerScript}`);
   console.log(`  ${C.green}✓${C.reset} .sleepcode/scripts/${foreverScript}`);
   console.log(`  ${C.green}✓${C.reset} .sleepcode/scripts/log_filter.py`);
   console.log(`  ${C.green}✓${C.reset} .sleepcode/README.md`);
   console.log(`  ${C.green}✓${C.reset} .claude/settings.local.json`);
 
-  if (IS_WIN) {
-    console.log(`
+  console.log(`
 ${C.bold}${C.green}완료!${C.reset} 다음 단계:
 
   ${C.bold}1.${C.reset} .sleepcode/rules.md 를 프로젝트에 맞게 수정
-  ${C.bold}2.${C.reset} .sleepcode/tasks.md 에 작업 목록 작성
-  ${C.bold}3.${C.reset} 실행 (PowerShell):
-     ${C.dim}# 1회 실행${C.reset}
-     powershell -File .\\.sleepcode\\scripts\\ai_worker.ps1
-
-     ${C.dim}# 무한 루프${C.reset}
-     powershell -File .\\.sleepcode\\scripts\\run_forever.ps1
+  ${C.bold}2.${C.reset} .sleepcode/docs/ 에 참고 자료 추가 (기획서, 스크린샷 등)
+  ${C.bold}3.${C.reset} 태스크 생성:
+     ${C.cyan}npx sleepcode generate${C.reset}     ${C.dim}# 참고자료 기반 tasks.md 자동 생성${C.reset}
+     ${C.dim}또는 .sleepcode/tasks.md 를 직접 작성${C.reset}
+  ${C.bold}4.${C.reset} 실행:
+     ${C.cyan}npx sleepcode run${C.reset}          ${C.dim}# 1회 실행${C.reset}
+     ${C.cyan}npx sleepcode run --loop${C.reset}   ${C.dim}# 무한 루프${C.reset}
 `);
-  } else {
-    console.log(`
-${C.bold}${C.green}완료!${C.reset} 다음 단계:
+}
 
-  ${C.bold}1.${C.reset} .sleepcode/rules.md 를 프로젝트에 맞게 수정
-  ${C.bold}2.${C.reset} .sleepcode/tasks.md 에 작업 목록 작성
-  ${C.bold}3.${C.reset} 실행:
-     ${C.dim}# 1회 실행${C.reset}
-     ./.sleepcode/scripts/ai_worker.sh
+// ─── 실행 명령어 ───
+function runWorker(loop) {
+  const targetDir = process.cwd();
+  const scDir = path.join(targetDir, '.sleepcode', 'scripts');
 
-     ${C.dim}# 무한 루프 (tmux)${C.reset}
-     tmux new -s ai './.sleepcode/scripts/run_forever.sh'
-`);
+  if (!fs.existsSync(scDir)) {
+    console.error(`${C.red}.sleepcode/scripts/ 폴더가 없습니다. 먼저 'npx sleepcode'로 초기화하세요.${C.reset}`);
+    process.exit(1);
+  }
+
+  const scriptName = loop
+    ? (IS_WIN ? 'run_forever.ps1' : 'run_forever.sh')
+    : (IS_WIN ? 'ai_worker.ps1' : 'ai_worker.sh');
+  const scriptPath = path.join(scDir, scriptName);
+
+  if (!fs.existsSync(scriptPath)) {
+    console.error(`${C.red}스크립트를 찾을 수 없습니다: ${scriptPath}${C.reset}`);
+    process.exit(1);
+  }
+
+  const cmd = IS_WIN
+    ? `powershell -File "${scriptPath}"`
+    : `"${scriptPath}"`;
+
+  console.log(`${C.cyan}${loop ? '무한 루프' : '1회'} 실행: ${scriptName}${C.reset}\n`);
+
+  try {
+    execSync(cmd, { stdio: 'inherit', cwd: targetDir });
+  } catch (e) {
+    process.exit(e.status || 1);
+  }
+}
+
+// ─── 태스크 자동 생성 ───
+function generateTasks() {
+  const targetDir = process.cwd();
+  const scDir = path.join(targetDir, '.sleepcode');
+
+  if (!fs.existsSync(scDir)) {
+    console.error(`${C.red}.sleepcode/ 폴더가 없습니다. 먼저 'npx sleepcode'로 초기화하세요.${C.reset}`);
+    process.exit(1);
+  }
+
+  // claude CLI 확인
+  if (!checkCommand('claude --version')) {
+    console.error(`${C.red}claude CLI가 설치되어 있지 않습니다.${C.reset}`);
+    process.exit(1);
+  }
+
+  console.log(`${C.cyan}태스크 자동 생성 중...${C.reset}\n`);
+
+  // 참고 자료 수집
+  const parts = [];
+
+  // 1. base_rules.md (프로젝트 공통 규칙 — 역할 파악용)
+  const baseRulesPath = path.join(scDir, 'scripts', 'base_rules.md');
+  if (fs.existsSync(baseRulesPath)) {
+    parts.push(fs.readFileSync(baseRulesPath, 'utf-8'));
+  }
+
+  // 2. rules.md (프로젝트별 역할/작업방식)
+  const rulesPath = path.join(scDir, 'rules.md');
+  if (fs.existsSync(rulesPath)) {
+    parts.push(fs.readFileSync(rulesPath, 'utf-8'));
+  }
+
+  // 3. docs/ 디렉토리 파일 목록 + 내용
+  const docsDir = path.join(scDir, 'docs');
+  if (fs.existsSync(docsDir)) {
+    const files = fs.readdirSync(docsDir).filter(f => f !== '.gitkeep');
+    for (const file of files) {
+      const filePath = path.join(docsDir, file);
+      const stat = fs.statSync(filePath);
+      if (stat.isFile() && stat.size < 100000) {
+        // 텍스트 파일만 읽기 (이미지 등은 파일명만)
+        const ext = path.extname(file).toLowerCase();
+        if (['.md', '.txt', '.json', '.yaml', '.yml', '.csv', '.html'].includes(ext)) {
+          parts.push(`--- docs/${file} ---\n${fs.readFileSync(filePath, 'utf-8')}`);
+        } else {
+          parts.push(`--- docs/${file} --- (파일 존재, 내용은 직접 참고)`);
+        }
+      }
+    }
+  }
+
+  // 4. 현재 프로젝트 구조 (이미 구현된 것 파악용)
+  try {
+    const tree = execSync('git ls-files', { cwd: targetDir, stdio: ['pipe', 'pipe', 'pipe'], timeout: 10000 })
+      .toString().trim();
+    if (tree) {
+      parts.push(`--- 현재 프로젝트 파일 목록 (이미 구현됨) ---\n${tree}`);
+    }
+  } catch {
+    // git이 없거나 실패하면 무시
+  }
+
+  // 5. 기존 tasks.md (있으면 참고)
+  const tasksPath = path.join(scDir, 'tasks.md');
+  if (fs.existsSync(tasksPath)) {
+    const existing = fs.readFileSync(tasksPath, 'utf-8');
+    if (existing.includes('[ ]') || existing.includes('[x]')) {
+      parts.push(`--- 기존 tasks.md ---\n${existing}`);
+    }
+  }
+
+  // 프롬프트 구성
+  const context = parts.join('\n\n---\n\n');
+  const prompt = `${context}
+
+---
+
+위 프로젝트 정보와 참고 자료를 바탕으로 .sleepcode/tasks.md 파일을 생성해주세요.
+
+규칙:
+- 마크다운 체크리스트 형식으로 작성: \`- [ ] 태스크 내용\`
+- 구체적이고 실행 가능한 단위로 태스크를 나눌 것
+- 태스크 순서는 의존성을 고려하여 배치
+- Figma 디자인이 있으면 UI 구현 태스크도 포함
+- Notion 문서가 있으면 기획 내용을 반영
+- docs/ 폴더의 참고 자료를 반영
+- **이미 프로젝트에 구현되어 있는 기능은 태스크에 포함하지 않는다**
+- 현재 프로젝트 파일 목록을 분석하여 아직 구현되지 않은 것만 태스크로 작성
+- 첫 줄은 \`# 작업 목록\` 으로 시작
+- 태스크 목록 앞에 간단한 안내 문구 포함
+
+tasks.md 내용만 출력하세요. 다른 설명은 하지 마세요.`;
+
+  try {
+    const result = execSync(
+      'claude -p --output-format text',
+      {
+        input: prompt,
+        cwd: targetDir,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 300000,
+        maxBuffer: 1024 * 1024,
+      }
+    ).toString().trim();
+
+    // tasks.md에 저장
+    fs.writeFileSync(tasksPath, result + '\n');
+    console.log(`${C.green}✓${C.reset} .sleepcode/tasks.md 생성 완료\n`);
+    console.log(`${C.dim}${result}${C.reset}\n`);
+    console.log(`필요하면 tasks.md를 직접 수정한 뒤 실행하세요:`);
+    console.log(`  ${C.cyan}npx sleepcode run${C.reset}          ${C.dim}# 1회 실행${C.reset}`);
+    console.log(`  ${C.cyan}npx sleepcode run --loop${C.reset}   ${C.dim}# 무한 루프${C.reset}`);
+  } catch (e) {
+    console.error(`${C.red}태스크 생성 실패: ${e.message}${C.reset}`);
+    process.exit(1);
   }
 }
 
 // ─── 메인 ───
 async function main() {
   const targetDir = process.cwd();
+
+  // 서브커맨드 처리
+  const firstArg = process.argv[2];
+  if (firstArg === 'run') {
+    const loop = process.argv.includes('--loop');
+    runWorker(loop);
+    return;
+  }
+  if (firstArg === 'generate') {
+    generateTasks();
+    return;
+  }
+
   const cliArgs = parseArgs();
 
   console.log(`
@@ -410,6 +598,9 @@ ${C.bold}${C.magenta}  ╔══════════════════
     const projectName = cliArgs.name || path.basename(targetDir);
     const role = cliArgs.role || `${projectName} 서비스 개발`;
     const figmaKey = cliArgs.figmaKey || '';
+    const figmaFileNames = cliArgs.figmaFileNames || '';
+    const notionKey = cliArgs.notionKey || '';
+    const notionPages = cliArgs.notionPages || '';
     const sleepInterval = cliArgs.interval || '30';
 
     console.log(`${C.dim}타입: ${typeConfig.label}${C.reset}`);
@@ -424,6 +615,9 @@ ${C.bold}${C.magenta}  ╔══════════════════
       testCmd: typeConfig.testCmd,
       lintCmd: typeConfig.lintCmd,
       figmaKey,
+      figmaFileNames,
+      notionKey,
+      notionPages,
       sleepInterval,
     });
 
@@ -476,7 +670,24 @@ ${C.bold}${C.magenta}  ╔══════════════════
       console.log(`${C.dim}  린트: ${lintCmd || '(없음)'}${C.reset}`);
     }
 
-    const figmaKey = await ask(rl, 'Figma API Key (없으면 Enter)', '');
+    // Figma 연동
+    let figmaKey = '';
+    let figmaFileNames = '';
+    const useFigma = await ask(rl, 'Figma 디자인을 참고하나요? (y/N)', 'N');
+    if (useFigma.toLowerCase() === 'y') {
+      figmaKey = await ask(rl, 'Figma API Key', '');
+      figmaFileNames = await ask(rl, '참고할 Figma 파일명 (예: 홈화면, 로그인)', '');
+    }
+
+    // Notion 연동
+    let notionKey = '';
+    let notionPages = '';
+    const useNotion = await ask(rl, 'Notion 문서를 참고하나요? (y/N)', 'N');
+    if (useNotion.toLowerCase() === 'y') {
+      notionKey = await ask(rl, 'Notion API Key', '');
+      notionPages = await ask(rl, '참고할 Notion 페이지명 (예: 기획서, API명세)', '');
+    }
+
     const sleepInterval = await ask(rl, '반복 간격 (초)', '30');
 
     rl.close();
@@ -489,6 +700,9 @@ ${C.bold}${C.magenta}  ╔══════════════════
       testCmd,
       lintCmd,
       figmaKey,
+      figmaFileNames,
+      notionKey,
+      notionPages,
       sleepInterval,
     });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sleepcode",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "AI codes while you sleep — Claude AI 야간 자동화 세팅 CLI",
   "bin": {
     "sleepcode": "./bin/index.js"

package/templates/common/README.md

@@ -11,7 +11,8 @@ AI codes while you sleep — 밤새 개발 작업을 자동화하는 시스템
   rules.md           # ✏️ AI 역할 + 작업 규칙 (수정하세요)
   tasks.md           # ✏️ 오늘 진행할 작업 목록 (수정하세요)
   docs/              # ✏️ 개발 참고 자료 (피그마 스크린샷, 기획서 등)
-  scripts/           # ⚙️ 시스템 스크립트 (수정하지 마세요)
+  scripts/           # ⚙️ 시스템 (수정하지 마세요)
+    base_rules.md    #    공통 작업 규칙
     ai_worker.*      #    1회 실행 스크립트
     run_forever.*    #    무한 루프 감시자 스크립트
     log_filter.py    #    로그 필터 (핵심 메시지만 추출)
@@ -41,26 +42,15 @@ claude --dangerously-skip-permissions
 
 ### 2. 실행
 
-**macOS / Linux:**
 ```bash
-# 권한 부여
-chmod +x .sleepcode/scripts/*.sh
-
 # 1회 실행
-./.sleepcode/scripts/ai_worker.sh
+npx sleepcode run
 
-# 무한 루프 (tmux)
-tmux new -s ai './.sleepcode/scripts/run_forever.sh'
+# 무한 루프 (잠자기 전)
+npx sleepcode run --loop
 ```
 
-**Windows (PowerShell):**
-```powershell
-# 1회 실행
-powershell -File .\.sleepcode\scripts\ai_worker.ps1
-
-# 무한 루프
-powershell -File .\.sleepcode\scripts\run_forever.ps1
-```
+OS에 맞는 스크립트를 자동으로 선택합니다.
 
 ### 3. tmux 분리 (백그라운드 전환, macOS/Linux)
 

package/templates/common/ai_worker.ps1

@@ -7,10 +7,11 @@ Set-Location (Split-Path (Split-Path $PSScriptRoot -Parent) -Parent)
 $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
 Write-Host "[$timestamp] AI 단일 실행 시작"
 
+$baseRules = Get-Content .sleepcode/scripts/base_rules.md -Raw -Encoding UTF8
 $rules = Get-Content .sleepcode/rules.md -Raw -Encoding UTF8
 $tasks = Get-Content .sleepcode/tasks.md -Raw -Encoding UTF8
 
-$prompt = "$rules`n`n---`n`n$tasks"
+$prompt = "$baseRules`n`n---`n`n$rules`n`n---`n`n$tasks"
 
 # stream-json + verbose: 토큰 단위 실시간 출력
 $prompt | claude -p --dangerously-skip-permissions --output-format stream-json --verbose 2>&1 |

package/templates/common/ai_worker.sh

@@ -7,10 +7,15 @@ cd "$(dirname "$0")/../.." || exit 1
 
 echo "[$(date '+%Y-%m-%d %H:%M:%S')] AI 단일 실행 시작"
 
+BASE_RULES=$(cat .sleepcode/scripts/base_rules.md)
 RULES=$(cat .sleepcode/rules.md)
 TASKS=$(cat .sleepcode/tasks.md)
 
-PROMPT="${RULES}
+PROMPT="${BASE_RULES}
+
+---
+
+${RULES}
 
 ---
 

package/templates/common/base_rules.md

@@ -0,0 +1,39 @@
+# 공통 작업 규칙
+
+## 기본 원칙
+
+- 절대로 사용자에게 질문하지 않는다.
+- 작업이 끝났다고 판단하지 않는다.
+- 항상 다음 작업을 스스로 찾는다.
+- 가능한 한 많은 기능을 구현하며 계속 진행한다.
+
+---
+
+## 참고 자료
+
+- `.sleepcode/docs/` 디렉토리에 업로드된 파일 참고 (피그마 스크린샷, 기획서, 참고 이미지 등)
+
+{{FIGMA_SECTION}}
+{{NOTION_SECTION}}
+
+---
+
+## 태스크 완료 처리
+
+- `.sleepcode/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/common/run_forever.ps1

@@ -35,10 +35,11 @@ while ($true) {
         exit 0
     }
 
-    # rules.md + tasks.md 를 합쳐서 프롬프트 구성
+    # base_rules.md + rules.md + tasks.md 를 합쳐서 프롬프트 구성
+    $baseRules = Get-Content .sleepcode/scripts/base_rules.md -Raw -Encoding UTF8
     $rules = Get-Content .sleepcode/rules.md -Raw -Encoding UTF8
     $tasks = Get-Content .sleepcode/tasks.md -Raw -Encoding UTF8
-    $prompt = "$rules`n`n---`n`n$tasks"
+    $prompt = "$baseRules`n`n---`n`n$rules`n`n---`n`n$tasks"
 
     Log "claude 실행 중..."
     # stream-json -> log_filter.py 로 핵심 메시지만 추출

package/templates/common/run_forever.sh

@@ -31,11 +31,16 @@ while true; do
     exit 0
   fi
 
-  # rules.md + tasks.md 를 합쳐서 프롬프트 구성
+  # base_rules.md + rules.md + tasks.md 를 합쳐서 프롬프트 구성
+  BASE_RULES=$(cat .sleepcode/scripts/base_rules.md)
   RULES=$(cat .sleepcode/rules.md)
   TASKS=$(cat .sleepcode/tasks.md)
 
-  PROMPT="${RULES}
+  PROMPT="${BASE_RULES}
+
+---
+
+${RULES}
 
 ---
 

package/templates/rules/custom.md

@@ -8,25 +8,6 @@
 
 ---
 
-## 기본 원칙
-
-- 절대로 사용자에게 질문하지 않는다.
-- 작업이 끝났다고 판단하지 않는다.
-- 항상 다음 작업을 스스로 찾는다.
-- 가능한 한 많은 기능을 구현하며 계속 진행한다.
-
----
-
-## 참고 자료
-
-- `.sleepcode/docs/` 디렉토리에 업로드된 파일 참고
-
-## Figma
-
-- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
-
----
-
 ## 작업 방식
 
 - 작은 단위로 작업하고 자주 확인한다.
@@ -45,25 +26,3 @@
 
 - 기존 프로젝트 구조와 패턴을 존중한다.
 - 중복 코드를 만들지 않는다.
-
----
-
-## 태스크 완료 처리
-
-- `.sleepcode/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

@@ -8,25 +8,6 @@
 
 ---
 
-## 기본 원칙
-
-- 절대로 사용자에게 질문하지 않는다.
-- 작업이 끝났다고 판단하지 않는다.
-- 항상 다음 작업을 스스로 찾는다.
-- 가능한 한 많은 기능을 구현하며 계속 진행한다.
-
----
-
-## 참고 자료
-
-- `.sleepcode/docs/` 디렉토리에 업로드된 파일 참고 (피그마 스크린샷, 기획서, 참고 이미지 등)
-
-## Figma
-
-- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
-
----
-
 ## 작업 방식
 
 - 작은 단위로 작업하고 자주 확인한다.
@@ -53,25 +34,3 @@
 - 중복 코드를 만들지 않는다.
 - App Router 구조를 따른다.
 - Server Component / Client Component 를 적절히 구분한다.
-
----
-
-## 태스크 완료 처리
-
-- `.sleepcode/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

@@ -8,25 +8,6 @@
 
 ---
 
-## 기본 원칙
-
-- 절대로 사용자에게 질문하지 않는다.
-- 작업이 끝났다고 판단하지 않는다.
-- 항상 다음 작업을 스스로 찾는다.
-- 가능한 한 많은 기능을 구현하며 계속 진행한다.
-
----
-
-## 참고 자료
-
-- `.sleepcode/docs/` 디렉토리에 업로드된 파일 참고 (피그마 스크린샷, 기획서, 참고 이미지 등)
-
-## Figma
-
-- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
-
----
-
 ## 작업 방식
 
 - 작은 단위로 작업하고 자주 확인한다.
@@ -52,25 +33,3 @@
 - 중복 코드를 만들지 않는다.
 - 기존 컴포넌트를 최대한 재사용한다.
 - 새 컴포넌트는 기존 디렉토리 구조에 맞게 배치한다.
-
----
-
-## 태스크 완료 처리
-
-- `.sleepcode/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

@@ -8,25 +8,6 @@
 
 ---
 
-## 기본 원칙
-
-- 절대로 사용자에게 질문하지 않는다.
-- 작업이 끝났다고 판단하지 않는다.
-- 항상 다음 작업을 스스로 찾는다.
-- 가능한 한 많은 기능을 구현하며 계속 진행한다.
-
----
-
-## 참고 자료
-
-- `.sleepcode/docs/` 디렉토리에 업로드된 파일 참고 (ERD, 화면설계, API 명세 등)
-
-## Figma
-
-- **프론트엔드 디자인**: Figma MCP 도구로 직접 조회 가능 (API Key: `{{FIGMA_API_KEY}}`)
-
----
-
 ## 작업 방식
 
 - 작은 단위로 작업하고 자주 테스트한다.
@@ -54,25 +35,3 @@
 - REST API는 일관된 응답 형식을 유지한다.
 - Entity ↔ DTO 변환을 명확히 분리한다.
 - Service 계층에 비즈니스 로직을 집중한다.
-
----
-
-## 태스크 완료 처리
-
-- `.sleepcode/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 는 변경 내용을 구체적으로 설명한다.