@angar2/taskery 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 angar2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# taskery
+
+> Claude Code 메인 세션을 위한 *가벼운 task 시스템*.
+> **1 메인 세션 + 스킬 8종 + catastrophic hook 3종 + npx 배포**.
+
+---
+
+## 한 줄 정신
+
+practice 영역(SW 개발)을 process로 강제하지 않는다.
+
+- **Process는 자동화 OK, Practice는 자유롭게 + 사용자 판단 신뢰** — 결정적 영역(린트/타입/빌드)만 강제, 휴리스틱은 강제 X
+- **Catastrophic만 hook 차단, 형식 위반은 instruction + 대화** — 합리적 변형 차단 사고 회피
+- **Top-down 선제적 작성 금지, bottoms-up** — 진짜 데이터 모이면 그때 추가 (PLAYBOOK 카탈로그 + FRICTION_LOG 패턴 ≥ 3회 트리거)
+
+---
+
+## 빠른 시작
+
+```bash
+# 새 프로젝트
+npx -p @angar2/taskery create-taskery <project-name>
+
+# 기존 프로젝트에 설치
+cd <your-project>
+npx @angar2/taskery init
+
+# 최신 버전 동기화
+npx @angar2/taskery update
+```
+
+> 글로벌 install (`npm install -g @angar2/taskery`) 후엔 `taskery init` / `create-taskery <name>` 단축 명령 사용 가능.
+
+요구 사항: Node.js >=18, Claude Code (CLI / VS Code / JetBrains).
+
+---
+
+## 스킬 8종 — project > plan > task 위계 + 회고
+
+| 스킬 | 레벨 | 역할 |
+|------|------|------|
+| `/project-init` | project | PROJECT/AGENT-GUIDE/LINKED-REPOS/.env 골격 생성 (1회성) |
+| `/plan-init` | plan | `.project/plans/<vX.X>/` 안 기획 문서 작성 |
+| `/task-init` | task | task.md 빈 골격 + status=draft |
+| `/task-plan` | task | Requirements/Scope/Dev Plan/Test Plan 작성 |
+| `/task-dev` | task | Phase 순서 구현 + self-check |
+| `/task-test` | task | 격리 세션 검증 (confirmation bias 회피) |
+| `/task-close` | task | 검증 명령 게이트 + 커밋 + dev 병합 |
+| `/refine` | meta | FRICTION_LOG 정독 + 패턴 감지 + bottoms-up 보강 제안 |
+
+명령어 직접 호출(`/task-init` 등) 또는 메인 세션이 frontmatter description 매칭으로 자동 발동.
+
+---
+
+## Catastrophic Hook 3종
+
+| Hook | 영역 | 잡는 것 |
+|------|------|--------|
+| `git-guard.sh` | PreToolUse(Bash) | main/dev 직접 커밋 / `--force` / `--no-verify` / `branch -D` / `reset --hard` |
+| `pre-commit-verify.sh` | PreToolUse(Bash) | `git commit` 시 검증 명령(린트/타입/빌드/테스트) 모두 PASS 게이트 |
+| `closed-immutable.sh` | PreToolUse(Write\|Edit) | `closed` 상태 task.md 본 파일 재수정 차단 |
+
+**잘 지키면 hook 작동 0회 (무해). catastrophic만 차단.**
+
+---
+
+## 디렉토리 구조 (사용자 프로젝트 — `npx @angar2/taskery init` 후)
+
+```
+my-app/
+├─ CLAUDE.md                     # 메인 세션 진입점
+├─ .taskery-manifest.json        # 자산 manifest (npx 자동 갱신)
+├─ .claude/
+│   ├─ settings.json             # hook 등록
+│   ├─ skills/                   # 8 스킬
+│   └─ hooks/                    # 3 catastrophic 안전망
+└─ .project/
+    ├─ PROJECT.md                # /project-init 생성
+    ├─ AGENT-GUIDE.md            # /project-init 생성
+    ├─ rules/
+    │   ├─ TASK_DOC_RULE.md      # task 양식
+    │   └─ GIT_RULE.md           # git 정책
+    ├─ plans/                    # /plan-init 생성
+    ├─ tasks/                    # /task-init 생성
+    ├─ flows/                    # /task-dev 갱신
+    ├─ changelog/                # /task-close 갱신
+    ├─ shared/                   # 멀티리포 메시지
+    └─ FRICTION_LOG.md           # 짜증 누적
+```
+
+---
+
+## 상세 문서
+
+> 본 리포 spec 문서는 npm 패키지에 포함되지 않으므로 GitHub에서 정독.
+
+- [plan/OVERVIEW.md](https://github.com/angar2/taskery/blob/main/plan/OVERVIEW.md) — 진입 + 큰 그림 + 단일 진실 소스
+- [plan/SKILLS.md](https://github.com/angar2/taskery/blob/main/plan/SKILLS.md) — 스킬 8종 명세 + 흐름
+- [plan/TASK-DOC.md](https://github.com/angar2/taskery/blob/main/plan/TASK-DOC.md) — 태스크 양식 + 7 상태
+- [plan/HOOKS.md](https://github.com/angar2/taskery/blob/main/plan/HOOKS.md) — 3 catastrophic hook 정책
+- [plan/DISTRIBUTION.md](https://github.com/angar2/taskery/blob/main/plan/DISTRIBUTION.md) — npx 배포 + manifest
+- [plan/DECISIONS.md](https://github.com/angar2/taskery/blob/main/plan/DECISIONS.md) — 핵심 의사결정
+- [plan/PLAYBOOK.md](https://github.com/angar2/taskery/blob/main/plan/PLAYBOOK.md) — 미래 옵션 카탈로그
+
+---
+
+## 라이선스
+
+[MIT](LICENSE)
+
+---
+
+## 수정 이력
+
+| 날짜 | 변경 사항 |
+|------|----------|
+| 2026-05-09 | 신규 작성 — npm 페이지 진입 문서 |

package/bin/create.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * bin/create.js
+ * `npx -p @angar2/taskery create-taskery <project-name>` — 새 디렉토리 생성 + 진입 + init 흐름.
+ *
+ * 동작:
+ *   1. <project-name> 인자 검증 (없으면 에러)
+ *   2. 동일 이름 디렉토리 존재 검사 (있으면 에러)
+ *   3. mkdir <project-name> + cd
+ *   4. init.js 호출 (현재 디렉토리에 카피)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+function fail(msg) {
+  console.error(`create-taskery: ${msg}`);
+  process.exit(1);
+}
+
+const arg = process.argv[2];
+if (!arg) {
+  fail(`프로젝트 이름 인자 필요. 예: npx -p @angar2/taskery create-taskery my-app`);
+}
+
+// 안전한 디렉토리 이름 검증 — 절대경로 / .. / 빈 문자열 등 차단
+if (arg.startsWith('/') || arg.includes('..') || arg.trim() === '') {
+  fail(`'${arg}'는 유효한 디렉토리 이름이 아님. 상대 경로 + 단순 이름 사용.`);
+}
+
+const targetDir = path.resolve(process.cwd(), arg);
+
+if (fs.existsSync(targetDir)) {
+  fail(`'${arg}' 이미 존재. 다른 이름 사용하거나 'cd ${arg} && npx @angar2/taskery init' 호출.`);
+}
+
+console.log(`create-taskery: '${arg}' 생성 + taskery init...`);
+fs.mkdirSync(targetDir, { recursive: true });
+
+const initScript = path.resolve(__dirname, 'init.js');
+const r = spawnSync(process.execPath, [initScript], {
+  cwd: targetDir,
+  stdio: 'inherit',
+});
+
+if (r.status !== 0) {
+  console.error(`create-taskery: init 실패 — '${targetDir}' 정리는 사용자 직접 수행.`);
+  process.exit(r.status ?? 1);
+}
+
+console.log(`\n다음: cd ${arg}`);

package/bin/init.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * bin/init.js
+ * `npx @angar2/taskery init` 본체 — 현재 디렉토리에 template/ 자산 카피 + manifest 생성.
+ *
+ * 동작:
+ *   1. cwd에 .taskery-manifest.json 이미 있으면 경고 + confirm
+ *   2. template/ 안 *모든 파일* cwd로 카피 (디렉토리 자동 생성)
+ *   3. *.local.md 사용자 오버라이드 충돌 검사 (덮어쓰지 X)
+ *   4. .taskery-manifest.json 박음 (version + installed_at + files{path,hash,core,managed} 맵)
+ *   5. 결과 요약 출력 + 다음 단계 안내 (`/project-init`)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const {
+  MANIFEST_NAME,
+  findTemplateDir,
+  walkTemplate,
+  copyFile,
+  writeManifest,
+  readManifest,
+  getPackageVersion,
+  isLocalOverride,
+} = require('./lib');
+
+async function confirm(msg) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`${msg} (y/N) `, (ans) => {
+      rl.close();
+      resolve(ans.trim().toLowerCase() === 'y');
+    });
+  });
+}
+
+async function main() {
+  const cwd = process.cwd();
+  const templateDir = findTemplateDir();
+  const manifestPath = path.join(cwd, MANIFEST_NAME);
+
+  // 1. 기존 manifest 검사
+  if (fs.existsSync(manifestPath)) {
+    const ok = await confirm(
+      `${MANIFEST_NAME} 이미 존재 — taskery 이미 설치된 디렉토리. 'update' 사용 권장. 그래도 init 강행할까?`,
+    );
+    if (!ok) {
+      console.log('취소 — 종료.');
+      process.exit(0);
+    }
+  }
+
+  // 2. template/ 정독 + 해시 맵
+  const templateFiles = walkTemplate(templateDir);
+  const fileEntries = Object.entries(templateFiles);
+
+  console.log(`\ntaskery v${getPackageVersion()} init`);
+  console.log(`대상: ${cwd}`);
+  console.log(`카피 대상: ${fileEntries.length}개 파일\n`);
+
+  // 3. 카피 + manifest 빌드
+  const manifestFiles = {};
+  let copied = 0;
+  let skipped = 0;
+
+  for (const [rel, hash] of fileEntries) {
+    const src = path.join(templateDir, rel);
+    const dst = path.join(cwd, rel);
+
+    // .local.md suffix는 사용자 영역 — taskery template에는 없어야 정상이지만 방어적으로 스킵
+    if (isLocalOverride(rel)) {
+      console.log(`  skip (.local override 영역): ${rel}`);
+      skipped++;
+      continue;
+    }
+
+    // 사용자 .local.md 충돌 검사 — 사용자가 직접 만든 *.local.md 보호
+    // 본 init은 신규 설치 default, 충돌 거의 없지만 update 흐름과 일관성 유지
+    if (fs.existsSync(dst)) {
+      const ok = await confirm(`  '${rel}' 이미 존재 — 덮어쓸까?`);
+      if (!ok) {
+        console.log(`    skip: ${rel}`);
+        skipped++;
+        continue;
+      }
+    }
+
+    copyFile(src, dst);
+    manifestFiles[rel] = { hash, core: true, managed: true };
+    copied++;
+    console.log(`  copy: ${rel}`);
+  }
+
+  // 4. manifest 박음
+  const manifest = {
+    version: getPackageVersion(),
+    installed_at: new Date().toISOString(),
+    files: manifestFiles,
+  };
+  writeManifest(manifest, manifestPath);
+
+  // 5. 결과 보고
+  console.log(`\n✅ taskery init 완료`);
+  console.log(`   카피: ${copied}개 / 스킵: ${skipped}개`);
+  console.log(`   manifest: ${MANIFEST_NAME}\n`);
+  console.log(`다음 단계:`);
+  console.log(`  1. CLAUDE.md 정독 + 프로젝트 메타 + 검증 명령 채우기`);
+  console.log(`  2. Claude Code 진입 → '/project-init' 호출 → '.project/' 진입 문서 골격 생성`);
+  console.log(`  3. '/plan-init <vX.X>' 호출 → 9 기획 문서 작성`);
+  console.log(`  4. '/task-init' 호출 → 첫 task 시작\n`);
+}
+
+main().catch((e) => {
+  console.error(`taskery init 실패: ${e.message}`);
+  process.exit(1);
+});

package/bin/lib.js

@@ -0,0 +1,107 @@
+/**
+ * bin/lib.js
+ * 공통 유틸 — taskery init/create/update 스크립트가 공유.
+ *
+ * 핵심:
+ *   - findTemplateDir(): 패키지 설치 위치에서 template/ 디렉토리 찾기
+ *   - walkTemplate(templateDir): template/ 안 *모든 파일* 상대경로 + 해시 맵 리턴
+ *   - sha256(path): 파일 해시
+ *   - mkdirp(path): mkdir -p
+ *   - copyFile(src, dst): 파일 카피 + 디렉토리 자동 생성
+ *   - writeManifest(manifest, dst): manifest JSON 박음
+ *   - readManifest(path): 기존 manifest Read (없으면 null)
+ *   - LOCAL_SUFFIX: '.local.md' suffix 검사 (npx 미터치 룰)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const LOCAL_SUFFIX = '.local.md';
+const MANIFEST_NAME = '.taskery-manifest.json';
+
+function findTemplateDir() {
+  // 패키지 루트는 이 lib.js 파일의 부모(bin/)의 부모
+  const pkgRoot = path.resolve(__dirname, '..');
+  const tmpl = path.join(pkgRoot, 'template');
+  if (!fs.existsSync(tmpl)) {
+    throw new Error(`template/ not found at ${tmpl}. taskery 패키지 설치 손상 가능성.`);
+  }
+  return tmpl;
+}
+
+function sha256(filePath) {
+  const buf = fs.readFileSync(filePath);
+  return 'sha256:' + crypto.createHash('sha256').update(buf).digest('hex');
+}
+
+function walkTemplate(templateDir) {
+  // template/ 안 모든 파일 상대경로 + 해시 맵 리턴
+  // 결과: { 'CLAUDE.md': 'sha256:...', '.claude/skills/task-init.md': 'sha256:...', ... }
+  const result = {};
+  function walk(dir, relBase) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      const rel = relBase ? `${relBase}/${entry.name}` : entry.name;
+      if (entry.isDirectory()) {
+        walk(full, rel);
+      } else if (entry.isFile()) {
+        result[rel] = sha256(full);
+      }
+    }
+  }
+  walk(templateDir, '');
+  return result;
+}
+
+function mkdirp(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function copyFile(src, dst) {
+  mkdirp(path.dirname(dst));
+  fs.copyFileSync(src, dst);
+  // 실행 권한 보존 (hooks .sh 파일)
+  if (src.endsWith('.sh')) {
+    fs.chmodSync(dst, 0o755);
+  }
+}
+
+function writeManifest(manifest, dst) {
+  fs.writeFileSync(dst, JSON.stringify(manifest, null, 2) + '\n');
+}
+
+function readManifest(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch (e) {
+    throw new Error(`${filePath} 파싱 실패: ${e.message}`);
+  }
+}
+
+function isLocalOverride(relPath) {
+  // *.local.md suffix 사용자 오버라이드 — npx 미터치 명시
+  return relPath.endsWith(LOCAL_SUFFIX);
+}
+
+function getPackageVersion() {
+  const pkgPath = path.resolve(__dirname, '..', 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  return pkg.version;
+}
+
+module.exports = {
+  LOCAL_SUFFIX,
+  MANIFEST_NAME,
+  findTemplateDir,
+  sha256,
+  walkTemplate,
+  mkdirp,
+  copyFile,
+  writeManifest,
+  readManifest,
+  isLocalOverride,
+  getPackageVersion,
+};

package/bin/taskery.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * bin/taskery.js
+ * `npx @angar2/taskery <subcommand>` — 진입점 dispatcher.
+ *
+ * 서브커맨드:
+ *   init    — 현재 디렉토리에 taskery 자산 카피 + manifest 생성
+ *   update  — 최신 버전 fetch + manifest 비교 + 머지 갱신
+ *   help    — 사용법 출력
+ */
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+
+const sub = process.argv[2];
+
+function runScript(scriptName) {
+  const scriptPath = path.resolve(__dirname, scriptName);
+  const r = spawnSync(process.execPath, [scriptPath, ...process.argv.slice(3)], {
+    stdio: 'inherit',
+  });
+  process.exit(r.status ?? 1);
+}
+
+function help() {
+  console.log(`taskery v${require('./lib').getPackageVersion()}
+
+사용법:
+  npx @angar2/taskery init      현재 디렉토리에 taskery 자산 설치
+  npx @angar2/taskery update    최신 버전 fetch + 머지 갱신
+  npx @angar2/taskery help      도움말
+
+새 프로젝트 시작:
+  npx -p @angar2/taskery create-taskery <project-name>
+
+상세: https://github.com/angar2/taskery
+`);
+}
+
+switch (sub) {
+  case 'init':
+    runScript('init.js');
+    break;
+  case 'update':
+    runScript('update.js');
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+  case undefined:
+    help();
+    break;
+  default:
+    console.error(`taskery: 알 수 없는 서브커맨드 '${sub}'.`);
+    help();
+    process.exit(1);
+}

package/bin/update.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * bin/update.js
+ * `npx @angar2/taskery update` — template/ 최신 자산과 사용자 측 비교 + 머지 갱신.
+ *
+ * 머지 로직 (§9-1):
+ *   1. .taskery-manifest.json (cwd) 읽기 — 없으면 에러 ('init' 먼저)
+ *   2. template/ 정독 → 새 해시 맵
+ *   3. 각 파일 분기:
+ *      a. 동일 (new == manifest) → 미터치
+ *      b. 신규 (manifest에 없음) → 카피 + manifest에 추가
+ *      c. 변경 (new != manifest):
+ *         - 사용자 측 == manifest 해시 → 사용자 customize 없음 → 자동 갱신
+ *         - 사용자 측 != manifest 해시 → 사용자 customize → *.bak 백업 + confirm
+ *      d. 사라짐 (manifest에 있는데 template에 없음) → 사용자에게 경고만, 사용자 파일 보존
+ *   4. *.local.md suffix → manifest에 없음 → 미터치 (방어)
+ *   5. manifest 갱신 + 결과 요약
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const {
+  MANIFEST_NAME,
+  findTemplateDir,
+  walkTemplate,
+  sha256,
+  copyFile,
+  writeManifest,
+  readManifest,
+  getPackageVersion,
+  isLocalOverride,
+} = require('./lib');
+
+async function confirm(msg) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`${msg} (y/N) `, (ans) => {
+      rl.close();
+      resolve(ans.trim().toLowerCase() === 'y');
+    });
+  });
+}
+
+async function main() {
+  const cwd = process.cwd();
+  const templateDir = findTemplateDir();
+  const manifestPath = path.join(cwd, MANIFEST_NAME);
+
+  // 1. manifest 검사
+  const oldManifest = readManifest(manifestPath);
+  if (!oldManifest) {
+    console.error(
+      `taskery update: ${MANIFEST_NAME} 없음 — 'npx @angar2/taskery init' 먼저 실행 필요.`,
+    );
+    process.exit(1);
+  }
+
+  // 2. template/ 새 해시 맵
+  const newTemplateFiles = walkTemplate(templateDir);
+  const oldFiles = oldManifest.files || {};
+
+  console.log(`\ntaskery update`);
+  console.log(`  현재 manifest 버전: ${oldManifest.version}`);
+  console.log(`  새 패키지 버전: ${getPackageVersion()}\n`);
+
+  const newFiles = {};
+  const summary = { unchanged: 0, new: 0, autoUpdated: 0, customizedReplaced: 0, skipped: 0, removed: 0 };
+
+  // 3. 새 template 파일 분기
+  for (const [rel, newHash] of Object.entries(newTemplateFiles)) {
+    if (isLocalOverride(rel)) {
+      // template에 .local.md 들어가면 안 되지만 방어적 스킵
+      console.log(`  skip (.local override 영역): ${rel}`);
+      summary.skipped++;
+      continue;
+    }
+
+    const src = path.join(templateDir, rel);
+    const dst = path.join(cwd, rel);
+    const oldEntry = oldFiles[rel];
+
+    // a. 신규 — manifest에 없음
+    if (!oldEntry) {
+      copyFile(src, dst);
+      newFiles[rel] = { hash: newHash, core: true, managed: true };
+      summary.new++;
+      console.log(`  new: ${rel}`);
+      continue;
+    }
+
+    const oldManifestHash = oldEntry.hash;
+
+    // b. 동일 — new == manifest → 미터치 (manifest 항목 그대로)
+    if (newHash === oldManifestHash) {
+      newFiles[rel] = oldEntry;
+      summary.unchanged++;
+      continue;
+    }
+
+    // c. 변경 — new != manifest
+    // 사용자 측 해시 비교
+    let userHash = null;
+    if (fs.existsSync(dst)) {
+      userHash = sha256(dst);
+    }
+
+    if (userHash === oldManifestHash) {
+      // 사용자 customize 없음 → 자동 갱신
+      copyFile(src, dst);
+      newFiles[rel] = { hash: newHash, core: true, managed: true };
+      summary.autoUpdated++;
+      console.log(`  auto-update: ${rel}`);
+    } else {
+      // 사용자 customize 검출 — *.bak 백업 + confirm
+      console.log(`\n  ⚠ ${rel} — 사용자 customize 검출`);
+      console.log(`    manifest 해시: ${oldManifestHash}`);
+      console.log(`    사용자 해시:   ${userHash}`);
+      console.log(`    새 코어 해시:  ${newHash}`);
+      const ok = await confirm(`    *.bak 백업 후 새 코어로 덮어쓸까?`);
+      if (ok) {
+        // .bak 백업
+        if (fs.existsSync(dst)) {
+          fs.copyFileSync(dst, dst + '.bak');
+        }
+        copyFile(src, dst);
+        newFiles[rel] = { hash: newHash, core: true, managed: true };
+        summary.customizedReplaced++;
+        console.log(`    replaced (.bak 백업): ${rel}`);
+      } else {
+        // 사용자 customize 보존 — manifest 항목은 *그대로* 유지 (다음 update가 다시 비교)
+        newFiles[rel] = oldEntry;
+        summary.skipped++;
+        console.log(`    skipped (사용자 보존): ${rel}`);
+      }
+    }
+  }
+
+  // 4. 사라짐 검사 — manifest에 있는데 새 template에 없음
+  for (const rel of Object.keys(oldFiles)) {
+    if (!(rel in newTemplateFiles)) {
+      console.log(`  ⚠ removed in new version (사용자 파일 보존): ${rel}`);
+      summary.removed++;
+      // manifest에서도 제거 (next update 시 다시 검사 X)
+    }
+  }
+
+  // 5. manifest 갱신
+  const newManifest = {
+    version: getPackageVersion(),
+    installed_at: oldManifest.installed_at,
+    updated_at: new Date().toISOString(),
+    files: newFiles,
+  };
+  writeManifest(newManifest, manifestPath);
+
+  // 결과 보고
+  console.log(`\n✅ taskery update 완료`);
+  console.log(`   동일: ${summary.unchanged}, 신규: ${summary.new}, 자동 갱신: ${summary.autoUpdated}`);
+  console.log(`   *.bak 후 갱신: ${summary.customizedReplaced}, 사용자 보존: ${summary.skipped}`);
+  if (summary.removed > 0) {
+    console.log(`   ⚠ 새 버전에서 사라진 파일: ${summary.removed} (사용자 파일 그대로 보존)`);
+  }
+  console.log();
+}
+
+main().catch((e) => {
+  console.error(`taskery update 실패: ${e.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@angar2/taskery",
+  "version": "0.1.0",
+  "description": "Lightweight task system for Claude Code — 1 메인 세션 + 스킬 8종 + catastrophic hook 안전망 3종",
+  "bin": {
+    "taskery": "bin/taskery.js",
+    "create-taskery": "bin/create.js"
+  },
+  "files": [
+    "bin/",
+    "template/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "smoke:init": "node bin/init.js",
+    "smoke:update": "node bin/update.js"
+  },
+  "keywords": [
+    "claude-code",
+    "task-management",
+    "ai-coding-workflow",
+    "skills",
+    "slash-commands",
+    "agent-hooks"
+  ],
+  "author": "angar2 <angaridev@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/angar2/taskery.git"
+  },
+  "homepage": "https://github.com/angar2/taskery#readme",
+  "bugs": {
+    "url": "https://github.com/angar2/taskery/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}