therookie 0.4.3 → 0.4.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "therookie",
-  "version": "0.4.3",
-  "description": "the Rookie — the AI new hire that remembers what you teach it. A CLI that connects a personal AI memory to AI tools like Claude and Codex.",
+  "version": "0.4.5",
+  "description": "the Rookie \u2014 the AI new hire that remembers what you teach it. A CLI that connects a personal AI memory to AI tools like Claude and Codex.",
   "license": "MIT",
   "keywords": [
     "ai",

package/src/cli.js

@@ -22,7 +22,7 @@ const HELP = `rookie — the Rookie Skill/Hook 설치 관리자
   rookie login [--local]
   rookie update [--force]
   rookie link [--local]
-  rookie save [--file <body.json>]   # 또는 stdin
+  rookie save [--file <body.json>] [--json]   # 또는 stdin. --json = 서버 raw 응답 출력
   rookie status
   rookie doctor [--deep-scan] [--dead-letters]
   rookie unlink [--local | --global]

package/src/commands/save.js

@@ -67,12 +67,29 @@ export async function runSave(flags) {
   if (repoUrl) body.repo_url = repoUrl
   else delete body.repo_url
 
-  const res = await apiPost(cfg.endpoint, cfg.token, '/api/rookie/batch-mutate', body, {
-    headers: {
-      'x-rookie-hostname': getHostname(),
-      'x-rookie-surface': 'local_cli',
-    },
-  })
+  let res
+  try {
+    res = await apiPost(cfg.endpoint, cfg.token, '/api/rookie/batch-mutate', body, {
+      headers: {
+        'x-rookie-hostname': getHostname(),
+        'x-rookie-surface': 'local_cli',
+      },
+    })
+  } catch (err) {
+    // --json 은 HTTP 실패도 파싱 가능한 JSON 으로 (spec 2026-07-16-checkpoint §2.2a)
+    if (flags.json) {
+      console.log(JSON.stringify({ error: String(err?.message ?? err) }))
+      process.exit(1)
+    }
+    throw err
+  }
+
+  if (flags.json) {
+    // 서버 raw 응답 그대로 — 재가공 없음. SKILL 은 summary.working_cards.ids[0]·superseded_count 를 읽는다.
+    console.log(JSON.stringify(res))
+    if (res.all_committed === false) process.exit(1)
+    return
+  }
 
   if (flags.quiet) return
   const s = res.summary ?? {}

package/templates/hook/lib/skill-gate.sh

@@ -24,5 +24,8 @@ skill_gate_record_epoch() {
   mkdir -p "$dir" 2>/dev/null
   printf '%s' "${size:-0}" > "$dir/$key.epoch" 2>/dev/null
   rm -f "$dir/$key.loaded" 2>/dev/null
+  # checkpoint 리마인더 카운터 리셋 (spec 2026-07-16-checkpoint-working-card §2.4) —
+  # /clear·compact 직후 이월된 카운트로 리마인더가 바로 뜨지 않게 한다.
+  rm -f "$dir/$key.prompts" 2>/dev/null
   return 0
 }

package/templates/hook/user-prompt-skill-gate.sh

@@ -41,6 +41,7 @@ cat | ROOKIE_GATE_DIR="$GATE_DIR" node -e '
   process.stdin.on("data",c=>d+=c).on("end",()=>{
     const SKILL_MSG="⚠️ 이 세션에서 아직 rookie Skill 을 로드하지 않았습니다. 다른 작업·응답 전에 먼저 rookie Skill 을 호출하세요 — 회상(recall)·미link 등록 제안·기억 저장 절차가 그 안에 있습니다. (이미 호출했다면 이 안내는 사라집니다.)";
     const RECALL_MSG="🧠 이 프롬프트에 과거 맥락·방법 회상 신호가 있습니다. grep·파일 열람·자기판단·두목 되묻기 이전에 GET /api/rookie/recall 을 먼저 호출하세요 (brand.ts 회상-순서 룰).";
+    const CKPT_MSG="📌 이 세션이 길어지고 있습니다. 직전 checkpoint 이후 마일스톤(커밋·배포·설계 수렴·단계 전환)이 지났다면 checkpoint 진입카드를 저장하세요 — 지나지 않았다면 무시해도 됩니다.";
     const injectMsg=(msg)=>{ try{ process.stdout.write(JSON.stringify({hookSpecificOutput:{hookEventName:"UserPromptSubmit",additionalContext:msg}})); }catch{} };
     try{
       const fs=require("fs"), path=require("path"), crypto=require("crypto");
@@ -80,8 +81,24 @@ cat | ROOKIE_GATE_DIR="$GATE_DIR" node -e '
           if(skillLoaded && key){ try{ fs.mkdirSync(gateDir,{recursive:true,mode:0o700}); fs.writeFileSync(path.join(gateDir,key+".loaded"),JSON.stringify({session_id:sid,transcript_path:tp,loaded_at:new Date().toISOString()}),{mode:0o600}); }catch{} }
         }
       }
+      // checkpoint 리마인더 카운터 (spec 2026-07-16-checkpoint-working-card §2.4).
+      // 매 프롬프트 +1. 임계 도달 + 더 높은 우선순위 메시지 없음 → 주입 + 리셋. 충돌 시 이월(threshold).
+      let ckptDue=false;
+      const every=parseInt(process.env.ROOKIE_CHECKPOINT_REMINDER_EVERY||"20",10);
+      if(key && Number.isFinite(every) && every>0){
+        try{
+          const pf=path.join(gateDir,key+".prompts");
+          let n=0;
+          try{ const v=parseInt(String(fs.readFileSync(pf,"utf8")).trim(),10); if(Number.isFinite(v)&&v>0) n=v; }catch{}
+          n+=1;
+          if(skillLoaded && !recallSignal && n>=every){ ckptDue=true; n=0; }
+          fs.mkdirSync(gateDir,{recursive:true,mode:0o700});
+          fs.writeFileSync(pf,String(n),{mode:0o600});
+        }catch{ ckptDue=false; }   // 카운터 실패 → 조용히 skip (fail-soft)
+      }
       if(!skillLoaded) return injectMsg(SKILL_MSG);   // 미로드 → skill 리마인더 (recall 리마인더 안 함, 한 turn 한 메시지)
       if(recallSignal) return injectMsg(RECALL_MSG);  // 로드됨 + 과거-방법 신호 → recall 리마인더
+      if(ckptDue) return injectMsg(CKPT_MSG);         // 로드됨 + 무신호 + 임계 도달 → checkpoint 리마인더
       return;                                         // 로드됨 + 신호 없음 → 조용
     }catch{ return injectMsg(SKILL_MSG); }   // fail-soft
   });

package/templates/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rookie
-description: Rookie 회상·저장 Skill — recall 트리거 (어제/전에/그때 등) 감지 시 GET /api/rookie/recall 강제 호출. hot write 4 카테고리 (운영사실/능력증거/자기규칙/취향)는 batch-mutate 직접 호출로 저장.
+description: Rookie 회상·저장 Skill — recall 트리거 (어제/전에/그때 등) 감지 시 GET /api/rookie/recall 강제 호출. hot write 4 카테고리 (운영사실/능력증거/자기규칙/취향)는 batch-mutate 로 저장.
 version: __VERSION__
 scope: __SCOPE__
 installed_at: __INSTALLED_AT__
@@ -11,142 +11,116 @@ installed_by: __INSTALLED_BY__
 
 ## ⚡ 로드 직후 필수 (다른 응답 전에)
 
-진입카드·미link 상태는 SessionStart hook 이 아니라 **이 skill 이 로드한다** — 로드되면 **다른 말을 하기 전에** 아래 "세션 시작" 절차를 실행한다:
+진입카드·미link 상태는 이 skill 이 로드한다 — **다른 말 전에** 아래 "세션 시작" 절차를 실행한다:
 
 1. `GET /api/rookie/context` 를 curl 로 호출해 `system_prompt`·`current_project`·`entry_cards` 전문을 받는다.
 2. **진입 카드 확인:**
-   - **1순위**: `entry_cards[]` 를 직접 읽는다. 비어있지 않으면 **그 작업을 이어가려는 사용자 의도를 우선 가정**해 먼저 언급한다. 안전 신호 반영 — `grade` `warn`/`old` → 이미 완료됐을 수 있으니 현재 상태부터 점검하는 톤 / `is_meta_card` → 메타 카드 의심 · 단일 fact 분리 권고 · `body` 절단본이라 전량 단정 금지 / `is_vague` → 목표 수준 카드 — recall 로 방법 맥락 보강 후 착수 / `has_contradiction` → 단정 전 점검 / `reasoning` → 근거로 고려.
-   - **activity-stale 신호(2026-07-15)**: `activity_stale=true`(또는 `newer_activity_count > 0`) → 카드는 있지만 **그 이후 같은 프로젝트에서 세션이 더 진행됐다**. `effective_grade`(age 와 activity 중 높은 등급) 를 권위 기준으로 삼아, 이어가기 전에 recall + 현재 상태(git log·해당 파일) 점검 후 착수한다. "이게 마지막 작업"이라 단정 금지.
-   - **`ephemeral_recovery`(임시 복구, 저장 아님)**: activity-stale 카드에 붙는 read-time 합성물. **`id` 가 없다** — 저장된 카드가 아니므로 `supersedes`·`task_id` 연결 대상이 아니고, 저장된 "다음 진입 카드"처럼 다루지 않는다. 기존 stale 카드와 **함께** 보여준다("직전 카드(오래됨) + 🛟 임시 복구: <headline>"). `synthesis_tier=bare`(메타데이터뿐)면 headline 을 확정 사실처럼 전하지 말고 "세션은 있었지만 세부 기록 없음"으로만. `synthesis_tier=evidence`(self-reported artifact_paths)는 "파일이 바뀐 것으로 보고됨"이지 "확인된 변경"이 아니다. 이 정보를 근거로 **진짜 다음 카드를 새로 저장**하면 다음 조회부터 임시 복구는 자연히 사라진다.
-   - **폴백**(구버전 서버): `system_prompt` 의 `## 🔖 진행 중 작업 카드` 마커를 grep 해 전문을 읽는다(유동 위치 — head/tail 훑기 금지). 텍스트 경로엔 `🔀 이 카드 이후 … 세션 N건` + `🛟 임시 복구(저장 아님)` 라인으로 동기돼 있다.
+   - **1순위**: `entry_cards[]` 를 직접 읽는다. 비어있지 않으면 **그 작업을 이어가려는 사용자 의도를 우선 가정**해 먼저 언급한다. 안전 신호 — `grade` `warn`/`old` → 이미 완료됐을 수 있으니 현재 상태부터 점검 / `is_meta_card` → 메타 카드 의심·단일 fact 분리 권고·`body` 절단본(전량 단정 금지) / `is_vague` → 목표 수준 카드 — recall 로 방법 보강 후 착수 / `has_contradiction` → 단정 전 점검 / `reasoning` → 근거로 고려.
+   - **activity-stale**: `activity_stale=true`(또는 `newer_activity_count>0`) → 카드 이후 같은 프로젝트에서 세션이 더 진행됐다. `effective_grade`(age·activity 중 높은 등급)를 권위 기준으로, recall + 현재 상태(git log·해당 파일) 점검 후 착수. "이게 마지막 작업" 단정 금지.
+   - **`ephemeral_recovery`(임시 복구, 저장 아님)**: activity-stale 카드에 붙는 read-time 합성물. `id` 없음 — `supersedes`·`task_id` 연결 금지. stale 카드와 **함께** 표시("직전 카드(오래됨) + 🛟 임시 복구: <headline>"). `synthesis_tier=bare`=세부 기록 없음으로만, `evidence`="바뀐 것으로 보고됨"(확인 아님). 진짜 다음 카드를 저장하면 다음 조회부터 사라진다.
+   - **폴백**(구버전 서버): `system_prompt` 의 `## 🔖 진행 중 작업 카드` 마커를 grep(유동 위치 — head/tail 훑기 금지). 텍스트 경로엔 `🔀 세션 N건`·`🛟 임시 복구` 라인으로 동기.
    - **무-주제 "이어서/계속하자"** 는 `entry_cards`(최신순) 우선. relevance recall 은 특정 주제를 명시했을 때만.
    - **카드 소비 규칙**: `[고정]`·`[통과]` 자산은 폐기·제외 제안 금지 / `[실패]` 접근은 재제안 금지 / "다음:" 이 목표 수준("~이어가기")뿐이면 목표를 되묻지 말고 방법 1개를 추천안 삼아 착수 보고.
-3. `current_project` 가 `null` 이면 미link — §6 등록 제안을 능동 수행한다.
-4. 사용자 입력에 recall 트리거가 있으면 recall 한다.
+3. `current_project` 가 `null` 이면 §6 등록 제안. 사용자 입력에 recall 트리거가 있으면 recall 한다.
 
 ## 세션 시작
 
-> 이하 모든 `rookie <cmd>` 는 글로벌 미설치 시 `node <the-rookie>/packages/rookie-cli/bin/rookie.js <cmd>` 로 실행한다.
+> `rookie <cmd>` 는 글로벌 미설치 시 `node <the-rookie>/packages/rookie-cli/bin/rookie.js <cmd>`.
 
-1. `.rookie-ignore` 파일 / `ROOKIE_DISABLED=1` / config 파일 부재면 이 스킬 전체를 건너뜁니다.
-2. config 해석(B6 다계정 격리): `ROOKIE_ENDPOINT`/`ROOKIE_TOKEN` > 프로젝트-로컬 `<dir>/.rookie/config.json`(cwd 상향 탐색) > 전역 `~/.rookie/config.json`. 로컬 config 디렉토리는 그 계정으로만 동작(`rookie login --local`).
+1. `.rookie-ignore` / `ROOKIE_DISABLED=1` / config 부재면 스킬 전체 skip.
+2. config 해석(B6 다계정 격리): `ROOKIE_ENDPOINT`/`ROOKIE_TOKEN` > 프로젝트-로컬 `<dir>/.rookie/config.json`(cwd 상향 탐색) > 전역 `~/.rookie/config.json`. 로컬 config 는 그 계정 전용(`rookie login --local`).
 3. 현재 폴더 식별: `REPO_URL` = `git remote get-url origin` (실패 시 빈 값), `REPO_PATH` = cwd.
-   **git 기준점 캡처(세션 보관)**: `SESSION_START_SHA` = `git rev-parse HEAD` / `START_DIRTY` = `git status --short` + `git diff --name-only HEAD`. 이 SHA 이후 *새* 변경만 이번 세션 산물 — 시작부터 dirty 던 파일로 task 자동 전환 금지.
+   **git 기준점 캡처**: `SESSION_START_SHA` = `git rev-parse HEAD` / `START_DIRTY` = `git status --short` + `git diff --name-only HEAD`. 이 SHA 이후 *새* 변경만 이번 세션 산물 — 시작부터 dirty 던 파일로 task 자동 전환 금지.
 4. 컨텍스트 조회:
    ```
    curl -s -H "Authorization: Bearer $TOKEN" -H "x-rookie-hostname: $(hostname)" \
      -H "x-rookie-surface: claude_code" \
      "$ENDPOINT/api/rookie/context?repo_url=$(url_encode $REPO_URL)&repo_path=$(url_encode $REPO_PATH)"
    ```
-5. 응답의 `system_prompt` 를 세션 페르소나로 채택(기억 상세는 recall 위임).
-   - **이상 신호(B1 Identity Guard)**: 주입 페르소나·계정 요약(`[루키] 계정 …` 상태줄, `metadata.account`)이 평소와 다르면(프로젝트 0·낯선 호칭·빈 계정) 작업 전에 알린다.
-6. **미link 감지·능동 제안**: `current_project` 가 `null` 이면 미link. 서버가 `metadata.link_hint: 'unlinked_repo'` 를 반환하면 클라이언트 판단 없이 그 신호를 신뢰한다(B2).
+5. `system_prompt` 를 세션 페르소나로 채택(기억 상세는 recall 위임).
+   - **이상 신호(B1)**: 주입 페르소나·계정 요약(`[루키] 계정 …`, `metadata.account`)이 평소와 다르면(프로젝트 0·낯선 호칭·빈 계정) 작업 전에 알린다.
+6. **미link 감지·능동 제안**: `current_project` 가 `null` 이면 미link. 서버 `metadata.link_hint:'unlinked_repo'` 를 그대로 신뢰(B2).
    - `~/.rookie/link-dismissed.json`(경로 배열)에 현재 cwd 가 있으면 안내 skip.
-   - 없으면 **매 세션 1회** 이점을 들어 "지금 등록할까요? (원치 않으시면 '그만 물어봐')" 로 제안. git remote 있는 repo 면 특히 권한다.
+   - 없으면 **매 세션 1회** "지금 등록할까요? ('그만 물어봐' 가능)" 제안 — git remote 있는 repo 면 특히.
    - **승인 시** 루키가 `rookie link` 직접 실행 + 1줄 보고. **거부 시** link-dismissed.json 에 cwd 추가. dismiss 후에도 "등록해줘" 하면 즉시 실행.
    - 자동 등록 금지(승인 전제). recall 0건(신규면 정상)과 미link 는 다른 신호 — **후자만** 알린다.
 
-6.5. **link 후속 — 스펙 연결·소개글**: `system_prompt` 에 스펙 동기화 directive 가 있으면 그 `[루키 지시]` 대로 능동 제안한다(판정은 서버 책임). directive 없으면 스펙 안내 금지.
-   - **미연결** directive: "스펙을 연결할까요?" → 승인 시 (A)+(C). / **반쪽** directive: "동기화할까요?" → 승인 시 (A) 의 task 동기화만(PUT 생략).
-   - **(A) 스펙 연결·동기화**: 로컬 스펙 문서를 찾아 `spec_doc_paths` 설정 + 문서별 task 동기화(문서 1개=task 1개, `spec_ref`=파일경로, `spec_html`=렌더 HTML). **task 는 전부 todo 시작(스펙 ≠ 구현)** — sync 에 `status` 금지(서버가 todo 고정). 진척은 증거 기반 `PATCH /api/rookie/tasks`. 재동기화해도 기존 status 보존.
-     ```bash
-     # 미연결일 때만
-     curl -s -X PUT "$ENDPOINT/api/rookie/projects/spec-source" -H "Authorization: Bearer $TOKEN" \
-       -H "Content-Type: application/json" -d '{"project_id":"<id>","spec_doc_paths":["docs/specs/**"]}'
-     # 공통
-     curl -s -X POST "$ENDPOINT/api/rookie/tasks/sync" -H "Authorization: Bearer $TOKEN" \
-       -H "Content-Type: application/json" \
-       -d '{"project_id":"<id>","items":[{"title":"<스펙 제목>","spec_ref":"<파일경로>","spec_html":"<렌더 HTML>"}]}'
-     ```
-     스펙 문서가 없으면 "같이 만들까요?" → brainstorming 으로 작성 후 연결.
-   - **(C) 소개글**: 소개글이 비어 있으면 README·CLAUDE.md 파악 후 1~2문장 초안을 `PATCH /api/rookie/projects {"id","description"}` — 기존 소개글 덮어쓰기 금지. 완료 시 1줄 보고.
-   - **거부** 시 `POST /api/rookie/projects/spec-dismiss {"project_id":"<id>","dismissed":true}` (되돌리기는 `false`). 명시 요청은 dismiss 와 무관하게 수행.
-   - 미link(§6) → 미스펙(directive) → 정상 3단계 신호를 구분해 해당 단계만 1회 알린다(승인 전제).
+6.5. **link 후속 — 스펙 연결·소개글**: `system_prompt` 에 스펙 동기화 directive(`[루키 지시]`)가 있을 때만 능동 제안한다(판정은 서버 책임). **미연결** directive → "스펙을 연결할까요?" → 승인 시 (A)+(C) / **반쪽** directive → "동기화할까요?" → 승인 시 (A) 의 task 동기화만(PUT 생략).
+   - **(A) 스펙 연결·동기화**: 로컬 스펙 문서를 찾아 `spec_doc_paths` 설정 + 문서별 task 동기화(문서 1개=task 1개). **task 는 전부 todo 시작(스펙 ≠ 구현)** — sync 에 `status` 금지(서버가 todo 고정), 재동기화해도 기존 status 보존. 진척은 `PATCH /api/rookie/tasks`.
+     - 미연결일 때만: `PUT /api/rookie/projects/spec-source {"project_id":"<id>","spec_doc_paths":["docs/specs/**"]}`
+     - 공통: `POST /api/rookie/tasks/sync {"project_id":"<id>","items":[{"title":"<스펙 제목>","spec_ref":"<파일경로>","spec_html":"<렌더 HTML>"}]}`
+     - 스펙 문서가 없으면 "같이 만들까요?" → brainstorming 으로 작성 후 연결.
+   - **(C) 소개글**: 비어 있으면 README·CLAUDE.md 파악 후 1~2문장 초안을 `PATCH /api/rookie/projects {"id","description"}` — 기존 소개글 덮어쓰기 금지. 완료 시 1줄 보고.
+   - **거부** 시 `POST /api/rookie/projects/spec-dismiss {"project_id":"<id>","dismissed":true}` (되돌리기는 `false`). 명시 요청은 dismiss 와 무관하게 수행. 미link(§6) → 미스펙(directive) → 정상 3단계 중 해당 단계만 1회 알린다(승인 전제).
 
-6.6. **spec 후속 자동 스캔**: link + `spec_doc_paths` 설정 시 세션 시작 1회 `rookie scan-specs`(cli 가 하루 1회 throttle — 중복 안전). 결과는 조용히 둔다(proposal 은 `/projects` 에서 처리). "후속 스캔해줘" 하면 `--force`. 미link·미설정·실패는 조용히 skip.
+6.6. **spec 후속 자동 스캔**: link + `spec_doc_paths` 설정 시 세션 시작 1회 `rookie scan-specs`(하루 1회 throttle). 결과는 조용히 둔다(proposal 은 `/projects`). 명시 요청 시 `--force`. 미link·미설정·실패 조용히 skip.
 
 7. **임베딩 헬스 경고**: `embedding_health.degraded:true` 면 세션당 1회 — ``⚠️ 회상 임베딩 가동률 {ratio×100}% (최근 {window_days}일 {call_count}건) — 키/quota 점검 필요.`` `false` 면 침묵.
-8. **완료 후보 surface**: `## 🎯 완료 후보 감지` 블록의 `🎯 <task_id(전체 UUID)> "<title>" ← <sha> <subject>` 줄이 보이면 **다른 응답 전에** 각 후보를 done 승인 게이트로 여쭙는다. UUID 는 PATCH 용 — 두목께는 title 로만(§10e). `<sha>` 는 줄의 값 그대로(자르지 말 것):
-   - `"'<title>' 을 완료로 올릴까요? — 근거: 커밋 <sha> <subject>"` → OK 시에만 `PATCH {id, status:'done', detail:'<기존>\n\n✅ 완료 <date> — 커밋 <sha>'}`. **자동 done 금지.**
-   - "아직/보류" 면 `PATCH {id, detail:'<기존>\n__done_defer:<sha>'}` 로 재알림 차단 — 이후 **다른 새 커밋** 매칭 시만 재surface.
-   - 블록 없으면 침묵. 근거는 주입된 git 출력만(자기 서술 근거·self-loop 금지).
+8. **완료 후보 surface**: `## 🎯 완료 후보 감지` 블록의 `🎯 <task_id(전체 UUID)> "<title>" ← <sha> <subject>` 줄이 보이면 **다른 응답 전에** 후보별 done 승인 게이트로 여쭙는다(UUID 는 PATCH 용, 두목껜 title 만. `<sha>` 는 그대로): `"'<title>' 을 완료로 올릴까요? — 근거: 커밋 <sha> <subject>"` → OK 시에만 `PATCH {id, status:'done', detail:'<기존>\n\n✅ 완료 <date> — 커밋 <sha>'}` (**자동 done 금지**) / "아직/보류" 면 `PATCH {id, detail:'<기존>\n__done_defer:<sha>'}` 로 재알림 차단 — 이후 **다른 새 커밋** 매칭 시만 재surface. 블록 없으면 침묵. 근거는 주입된 git 출력만(self-loop 금지).
 9. 실패(HTTP·네트워크)는 조용히 폴백 — 현재 프로젝트 `CLAUDE.md` 만 따릅니다.
 
 ## 복구 세션 tail 추출
 
 비정상 종료 세션은 Stop hook 이 못 돌아 fact·진입카드가 없다 — chunk 복구는 `orphan_recover`, **fact 추출은 차차 책임**(서버 추출 off). 컨텍스트에 ``🛟 …`` 블록과 ``- <sid> :: <transcript_path>`` 목록이 보이면 **다른 응답 전에** 처리한다:
 
-1. `rookie orphan-extract --batch=5` — 대기 세션을 오래된 순으로 읽어 rule-base 초안(요약·파일 경로·git sha, redact 통과)을 뽑아 준다. transcript 원문 통째 Read 금지(부족할 때만 보조 확인 — Claude `~/.claude/projects/`, Codex `~/.codex/sessions/`).
+1. `rookie orphan-extract --batch=5` — 대기 세션을 오래된 순으로 읽어 rule-base 초안(요약·파일 경로·git sha, redact 통과)을 뽑는다. transcript 원문 통째 Read 금지(부족 시 보조 — Claude `~/.claude/projects/`, Codex `~/.codex/sessions/`).
 2. 초안에서 **저장 가치가 있는 것만** — 운영 사실/결정→working_card, 파일·결과물→evidence, 명시적 자기규칙→self_rule, 취향→personal_fact. 잡담·민감정보 금지(redactor 원칙). 0건 세션도 정상.
 3. **recall 로 dedup 후** 누락분만 `POST /api/rookie/batch-mutate`(`project_id` 포함).
-4. 처리한 세션마다(0건이어도) 초안 하단의 완료 marker 명령을 **그대로** 실행해 큐에서 비운다 — 안 하면 매 세션 재노출된다:
+4. 처리한 세션마다(0건이어도) 초안 하단의 완료 marker 명령을 **그대로** 실행해 큐에서 비운다 — 안 하면 매 세션 재노출:
    ```bash
    source "$HOME/.rookie/bin/lib/orphan-recovery.sh" 2>/dev/null && orphan_mark_client_extracted '<sid>'
    ```
-   (로컬 설치면 `<project>/.rookie/bin/lib/orphan-recovery.sh`) Codex 세션은 `ROOKIE_ORPHAN_DIR="…/codex"` prefix 로 나온다. transcript 소실 세션도 안내대로 marker 로 비운다.
-5. 한 줄 보고(`[복구] 세션 N건 tail 추출·저장`). raw transcript·UUID 나열 금지. 남은 대기는 다음 세션에서 이어서.
+   (로컬 설치면 `<project>/.rookie/bin/…`) Codex 세션은 `ROOKIE_ORPHAN_DIR="…/codex"` prefix. transcript 소실 세션도 marker 로 비운다.
+5. 한 줄 보고(`[복구] 세션 N건 tail 추출·저장`). raw transcript·UUID 나열 금지. 남은 대기는 다음 세션에서.
 
-## 컨텍스트 다이어트 (주1회, 승인 게이트 — spec 2026-07-10)
+## 컨텍스트 다이어트 (주1회, 승인 게이트)
 
-주 1회 SessionStart hook 이 `rookie context-diet` 로 임계 초과를 감지하면 ``## 🍞 컨텍스트 다이어트 권고`` 블록을 주입한다. 블록이 보이면 **다른 응답 전에 1회** 제안, 없으면 침묵. **전 항목 승인 게이트 — 자동 실행 없음.** 승인 시:
+SessionStart hook 이 주 1회 임계 초과 시 ``## 🍞 컨텍스트 다이어트 권고`` 블록을 주입한다. 보이면 **다른 응답 전에 1회** 제안, 없으면 침묵. **전 항목 승인 게이트 — 자동 실행 없음.** 승인 시:
 - **CLAUDE.md**: 아카이브성 내용 `docs/` 이관 + 참조 1줄 치환. 의미 단위 압축(단순 truncate 금지). diff 제시 → 승인 후 커밋.
 - **스킬 정리**: 0회 후보 제시 → 고른 것만. settings 비활성화(가역) 우선 / 폴백 `~/.claude/skills/<name>` → `skills.disabled/` 이동(삭제 아님, symlink·플러그인은 안내만). keep 은 `~/.rookie/context-diet-keep.json`.
 - **루키 자기 다이어트**: rookie Skill 문서 중복 정리 — diff 제시 → 승인 후 반영(템플릿 SSOT 커밋 + 재배포).
 
-**거부/보류 snooze**: `~/.rookie/context-diet-snooze.json` 에 `{"<key>":"<ISO until>"}` 30일(전체 거부면 90일. key = claude_md_project·claude_md_total·skills_agents_desc·rookie_self·unused_skills). snooze 는 블록에서 자동 제외. 실패 항목만 1줄 보고. 상시 현황 `rookie doctor`.
+**거부/보류 snooze**: `~/.rookie/context-diet-snooze.json` 에 `{"<key>":"<ISO until>"}` 30일(전체 거부 90일. key = claude_md_project·claude_md_total·skills_agents_desc·rookie_self·unused_skills). 실패 항목만 1줄 보고. 현황 `rookie doctor`.
 
 ## 회상 (recall)
 
-다음 트리거가 **사용자 메시지에** 등장하면 반드시 `/api/rookie/recall` 호출:
+다음 트리거가 **사용자 메시지에** 등장하면 반드시 `/api/rookie/recall` 호출 — 시간 단서(어제·전에·그때·예전에·이전에·지난번·저번에) / 작업 동사(진행해·이어·계속·다음·마저·배포·마무리) / 환경 질의(포트·유저명·경로·서버·호스트·도메인) / 과거 방법·재현(기존·어떻게 했/만들었/제작·재현·다시/새로 만들·파이프라인·방식).
 
-| 카테고리 | 키워드 |
-|---|---|
-| 시간 단서 | 어제·전에·그때·예전에·이전에·지난번·저번에 |
-| 작업 동사 | 진행해·이어·계속·다음·마저·배포·마무리 |
-| 환경 질의 | 포트·유저명·경로·서버·호스트·도메인 |
-| 과거 방법·재현 | 기존·예전·저번·어떻게 했/만들었/제작·재현·다시/새로 만들·파이프라인·방식 |
+> **위는 예시다 (전부 아님).** 과거에 무엇을·어떻게 했는지가 답에 필요하면 키워드가 없어도 grep/ls/파일 열람 **이전에** recall 먼저. 애매하면 되묻기 전에 recall.
 
-> **표는 예시다 (전부 아님).** 과거에 무엇을·어떻게 했는지가 답에 필요한 질문은 키워드가 없어도 grep/ls/파일 열람 **이전에** recall 을 먼저 호출한다. 애매하면 되묻기 전에 recall 먼저.
-
-기본은 `scope=all` (식별자 불필요, 항상 동작):
+기본은 `scope=all`(식별자 불필요):
 ```
 curl -s -H "Authorization: Bearer $TOKEN" \
   "$ENDPOINT/api/rookie/recall?q=$(url_encode '질문 요점')&scope=all&limit=5&kind=all"
 ```
 ⚠️ `scope=project` 는 `repo_url`·`repo_path` 필수 — 없으면 fail-closed 로 **무조건 0건**. 꼭 필요한 게 아니면 `scope=all`.
 
-응답 `results[]` 의 `summary` 를 컨텍스트로 활용. 0건이면 추측하지 말고 아는 범위로 답하되 "recall 0건" 류 문구를 화면에 내지 않는다.
+응답 `results[]` 의 `summary` 를 활용. 0건이면 추측 말고 아는 범위로 답하되 "recall 0건" 류 문구는 화면에 내지 않는다.
 
 - **출처 프로젝트 구분 (필수)**: `project_name` 이 현재 세션 프로젝트와 **다르면** 출처를 밝히고, **현 세션의 "다음 할 일" 후보로 제안하지 않는다**(두목이 명시 언급 시 예외). `null` 은 전역/개인 — "(전역)" 표기.
 - **같은 주제 "다음:" 카드가 여러 장이면** `memory_at`(ISO 시각) 최신 카드가 현재 상태 기준. 구 카드는 이력으로만.
-- **0건 + `meta.fail_closed:true` 자가교정** (알리지 않고 1회 재시도): `missing_project_identifier` → 식별자 넣거나 `scope=all` / `project_not_linked` → `scope=all`.
+- **0건 + `meta.fail_closed:true` 자가교정**(조용히 1회 재시도): `missing_project_identifier` → 식별자 추가 또는 `scope=all` / `project_not_linked` → `scope=all`.
 - **자기 출력 분석 금지** — 트리거는 사용자 입력에서만(self-loop 위험). **매 turn 호출 금지** — 트리거 등장 시만.
 
 ## 저장 (hot write, batch-mutate 직접 호출)
 
-| 카테고리 | 트리거 | 대상 |
-|---|---|---|
-| 운영 사실 | 자동 (서버/포트/유저명/경로/명시 결정) | working_cards |
-| 능력 증거 | 자동 (파일·결과물 산출 시) | evidence |
-| 자기 규칙 | 사용자 명시 시그널만 ("원칙·습관·항상·절대") | self_rules |
-| 개인 취향 | 사용자 명시 시그널만 ("좋아해·선호·취향") | personal_fact 별도 경로 |
-| 잡담·일회성 / 민감 정보 | 저장 안 함 | — |
+카테고리: 운영 사실(서버/포트/유저명/경로/명시 결정, 자동) → working_cards / 능력 증거(파일·결과물 산출 시, 자동) → evidence / 자기 규칙(사용자 명시 시그널 "원칙·습관·항상·절대" 만) → self_rules / 개인 취향(명시 시그널 "좋아해·선호·취향" 만) → personal_fact 별도 경로 / 잡담·일회성·민감 정보 → 저장 안 함.
 
-저장 전 **recall 로 먼저 dedup** → 이미 있으면 저장 안 함(1차 책임은 루키). 성공 시 1줄 알림(`[기억] <요약> 저장`). 실패 시 retry 1회 + 알림.
+저장 전 **recall dedup** — 같은 취지 durable fact 존재 시 새 저장 금지. **재확인 근거가 있으면** `verifications` confirmed 1건(fact 당 하루 1회, 서버 동일 게이트 — working card·근거 없는 회상 제외)으로 반복 신호를 남긴다. 성공 시 `[기억] <요약> 저장` 1줄, 실패 시 retry 1회 + 알림.
 
-**`rookie:mutate` fence 를 사용자 화면에 출력하지 않는다** — 저장은 `batch-mutate` 를 Bash 로 직접 호출하고 화면엔 `[기억] …` 한 줄만. (endpoint/token 은 `~/.rookie/config.json`. 토큰 출력 금지.)
+**`rookie:mutate` fence 를 화면에 출력하지 않는다** — 저장은 Bash 직접 호출, 화면엔 `[기억] …` 한 줄만(config 는 `~/.rookie/config.json`, 토큰 출력 금지).
 
 ```bash
 rookie save --file <body.json>        # 또는:  echo '<body>' | rookie save
 ```
-⚠️ **`curl` 로 직접 batch-mutate 를 치지 않는다.** `rookie save` 가 **cwd·git remote·hostname 을 자동 주입**한다 — 차차가 워크스페이스 식별자를 빠뜨릴 여지 자체를 없애기 위한 진입점이다(2026-07-14: 손으로 붙이던 구조 때문에 evidence 의 51%가 전역으로 샜다). 본문에는 **기억할 내용만** 담는다.
+⚠️ **`curl` 로 직접 batch-mutate 금지** — `rookie save` 가 cwd·git remote·hostname 을 자동 주입해 전역 누수를 막는다. 본문엔 **기억할 내용만**.
 
-⚠️ **전역 fact 는 `project_id: null` 을 명시한다.** 워크스페이스도 명시 의사도 없으면 서버가 `missing_workspace_context` 로 **거부**한다(조용한 전역 누수 차단). 미등록 폴더(link 안 된 곳)의 저장은 전역이 아니라 **그 폴더에 격리**되며, 나중에 `rookie link` 하면 자동 승격된다.
+⚠️ **전역 fact 는 `project_id: null` 을 명시한다.** 식별자도 명시 의사도 없으면 서버가 `missing_workspace_context` 로 **거부**. 미등록 폴더 저장은 **그 폴더에 격리**, `rookie link` 시 자동 승격.
 
 `<body>` 스키마 (필요한 키만):
 ```json
 {
-  "working_cards": { "items": [ { "summary": "진입 카드 본문", "verification": { "method": "ssh|curl|git|grep|lsof|read|reasoning|assertion", "evidence": "직접 명령 결과 한 줄" }, "supersedes": ["부모 fact UUID"], "tags": ["custom"], "ttl_at": "ISO8601?", "artifact_paths": ["task 매칭 입력용? ≤20 (저장 안 함)"], "project_id": "?", "task_id": "? (트리거 조건 참조)" } ], "repo_url": "(권장) git remote — 없으면 project 귀속 안 됨", "repo_path": "(권장) repo_url 없을 때 hostname 과 매칭", "project_id": "(레거시) batch 기본 — item 이 우선, 보통 생략", "conversation_id": "uuid?" },
+  "working_cards": { "items": [ { "summary": "진입 카드 본문", "verification": { "method": "ssh|curl|git|grep|lsof|read|reasoning|assertion", "evidence": "직접 명령 결과 한 줄" }, "supersedes": ["부모 fact UUID"], "tags": ["custom"], "ttl_at": "ISO8601?", "artifact_paths": ["task 매칭용? ≤20 (저장 안 함)"], "project_id": "?", "task_id": "?" } ], "repo_url": "(권장) git remote — 없으면 project 귀속 안 됨", "repo_path": "(권장) repo_url 없을 때 hostname 매칭", "project_id": "(레거시) item 이 우선, 보통 생략", "conversation_id": "uuid?" },
   "self_rules": [ { "category": "identity|voice|work_style|strength|preference|rule", "rule": "규칙 본문", "confidence": "high|medium|low", "supersedes": "기존 rule UUID?", "deprecation_reason": "user_override|conflict|noise|manual?" } ],
   "evidence": [ { "capability": "능력 진술문", "approach": "접근법?", "status": "completed|in-progress?", "context": "맥락?", "artifact_paths": ["파일 절대경로 (project 폴백 매칭에도 쓰임)"], "project_id": "? (uuid=명시 귀속 / null=전역 / 생략=세션 귀속)" } ],
   "verifications": [ { "fact_id": "검증 대상 fact UUID", "method": "(위와 동일 enum)", "outcome": "confirmed|refuted|ambiguous", "evidence": "검증 명령 결과 한 줄" } ]
@@ -154,20 +128,21 @@ rookie save --file <body.json>        # 또는:  echo '<body>' | rookie save
 ```
 
 ### 응답 확인 — `all_committed` 게이트 + 귀속 확인
-**귀속 확인 (all_committed 와 무관)**: `repo_url`/`repo_path` 를 보냈는데 응답 `working_cards.project_attributed` 가 `false` 이거나 `evidence.unattributed` 가 0 보다 크면(전역 의도로 `project_id:null` 명시한 경우 제외) `⚠️ [기억] 프로젝트 미귀속 저장 — rookie link 상태 확인 필요` 1줄 경고. 조용한 전역 NULL 누수 금지.
+**귀속 확인**(all_committed 와 무관): `repo_url`/`repo_path` 를 보냈는데 `working_cards.project_attributed=false` 또는 `evidence.unattributed>0` 이면(전역 의도 `project_id:null` 명시 제외) `⚠️ [기억] 프로젝트 미귀속 저장 — rookie link 상태 확인 필요` 1줄 경고.
 
 top-level `all_committed` 가 **`true` 일 때만** `[기억] … 저장` 보고. `false` 면:
-- **`rejected[]`** (정책 거부 — 재시도 무의미): `meta_card_summary`(메타 카드)·`residual_marker`(민감정보 마커)·`self_rule_rejected`. 단일 fact 로 분리하거나 원인 제거 후 재저장. 민감정보 마커면 포기.
+- **`rejected[]`**(정책 거부 — 재시도 무의미): `meta_card_summary`·`residual_marker`(민감정보)·`self_rule_rejected` — 단일 fact 분리 또는 원인 제거 후 재저장, 민감정보 마커면 포기.
 - **`failed[]`** (일시 실패): `insert_failed`·`unexpected_error` 등 — retry 1회, 그래도 실패면 보고.
 - 미저장이 남으면 `⚠️ [기억] N건 미저장 — <사유>` 한 줄(raw JSON·UUID 금지). `all_committed:true` 전엔 "저장 완료" 라 하지 않는다.
 
-> **레거시 폴백**: 직접 curl 불가한 실행환경만 응답 끝 ` ```rookie:mutate ``` ` fence(Stop hook 이 dispatch). 일반 세션에선 fence 금지.
+> **레거시 폴백**: 직접 curl 불가 환경만 응답 끝 ` ```rookie:mutate ``` ` fence(Stop hook dispatch). 일반 세션 fence 금지.
 
 ### 트리거 조건
-- **working_cards**: 다음 세션 진입 카드 — 세션 종료 시점 권고, 매 단계 금지. **body 에 `repo_url`/`repo_path` 를 넣어라** — 서버가 세션 project 로 자동 귀속. 미link 세션이면 NULL(정상).
-  - **직전 카드 supersede (필수 습관)**: 같은 작업 흐름(같은 프로젝트 + 제목·대상 파일·브랜치가 이어짐)의 새 "다음:" 카드는 recall dedup 에서 확인한 직전 카드 `id` 를 `supersedes` 에 넣어 닫는다. 애매하면 supersedes 없이 저장. 프로젝트 불일치 parent 는 서버가 자동 skip.
-  - **cross-project·전역 예외**: 명백히 다른 프로젝트/전역 fact 는 **생략이 아니라 명시적으로 `project_id: null`**(전역) 또는 그 프로젝트 uuid — 생략은 세션 project 자동 귀속이라 오귀속된다. null 이어도 scope=all 회상에 잡힌다.
-  - **task 연결 (P2.3)**: 확실히 매칭된 task 면 `task_id` 지정 — done 시 카드 자동 은퇴. project_id 는 생략해 task 에서 derive(불일치 시 400). **애매하면** task_id 없이 `__task_link_candidate:<task_id>` 태그만.
+- **working_cards**: 다음 세션 진입 카드 — 세션 마무리 + 아래 checkpoint, 매 턴·매 단계 금지. **body 에 `repo_url`/`repo_path` 필수** — 서버가 세션 project 로 자동 귀속, 미link 면 NULL(정상).
+  - **checkpoint(세션 중간 저장)**: 마일스톤(커밋/push·배포·설계 수렴·큰 단계 전환) 완결 시 `rookie save --json` 으로 카드 1건 — `tags:["checkpoint"]`, 직전 checkpoint 를 `supersedes` 로 닫기(응답 `summary.working_cards.ids[0]` 기억, `superseded_count` 확인). 마무리 저장도 마지막 checkpoint supersede. id 분실 시 recall dedup, 애매하면 supersedes 생략.
+  - **직전 카드 supersede (필수 습관)**: 같은 작업 흐름(프로젝트·이어지는 제목/파일/브랜치)의 새 "다음:" 카드는 recall dedup 으로 확인한 직전 카드 `id` 를 `supersedes` 에 넣어 닫는다. 애매하면 생략. 프로젝트 불일치 parent 는 서버가 자동 skip.
+  - **cross-project·전역 예외**: 명백히 다른 프로젝트/전역 fact 는 **생략이 아니라 명시적으로 `project_id: null`**(전역) 또는 그 프로젝트 uuid — 생략은 세션 project 자동 귀속(오귀속). null 도 scope=all 회상에 잡힌다.
+  - **task 연결**: 확실히 매칭된 task 면 `task_id` 지정 — done 시 카드 자동 은퇴. project_id 는 생략해 task 에서 derive(불일치 시 400). **애매하면** task_id 없이 `__task_link_candidate:<task_id>` 태그만.
 - **self_rules**: 사용자 명시 자기 규칙 지시 시만. / **evidence**: 파일·결과물 산출 시. / **verifications**: 루키가 직접 명령으로 fact 검증 시.
 
 ### 파일 변경 알림
@@ -177,7 +152,7 @@ top-level `all_committed` 가 **`true` 일 때만** `[기억] … 저장` 보고
 
 서버는 LLM 추출을 하지 않는다 — 세션 핵심 기억은 루키가 직접 저장한다. **마무리 징후 감지 시** (끝내자/수고/오늘 여기까지, 작업 완결, 의미 있는 단락):
 
-1. **다음 진입점 1건** — 미완결 작업·다음 액션·대기 결정을 추론해 working_cards 1건. 본문은 "다음: <바로 실행할 첫 행동>" 으로 시작 — 목표("~이어가기")가 아니라 행동, 방법 미정 난제면 "다음: 방법 후보 A/B 중 두목과 결정" 처럼 미정을 명시. `[고정]`·`[실패]`·`[두목 제약]` 마커 권장. + 필요한 파일·명령·근거 1줄(속기·내부기호 금지, 평이한 한국어). 명확히 완결됐으면 생략(0건 정상).
+1. **다음 진입점 1건** — 미완결 작업·다음 액션·대기 결정을 추론해 working_cards 1건. 본문은 "다음: <바로 실행할 첫 행동>" 시작(목표형 "~이어가기" 금지, 방법 미정이면 "다음: 방법 후보 A/B 중 두목과 결정"). `[고정]`·`[실패]`·`[두목 제약]` 마커 권장 + 파일·명령·근거 1줄(속기·내부기호 금지, 평이한 한국어). 명확히 완결됐으면 생략(0건 정상).
 2. **미저장 운영 사실·능력 증거·자기 규칙** — recall dedup 후 누락분만.
 3. **프로젝트 task status reconcile** (link 세션만) — `GET /api/rookie/tasks?project_id=<id>` 1회 후, **이번 세션 실제 산물과 사용자 지시**를 task 와 매칭(루키 자기 서술 근거 금지):
    - **(가) git 산물 수집 먼저** (git 이 진실):
@@ -186,7 +161,7 @@ top-level `all_committed` 가 **`true` 일 때만** `[기억] … 저장` 보고
      git diff --name-only ${SESSION_START_SHA:-HEAD~20}..HEAD
      git status --short   # START_DIRTY 제외분만 산물
      ```
-     커밋·파일·PR 또는 DB 검증 fact 가 매칭 근거. **양쪽 다 0 이면 어떤 status 도 바꾸지 않는다(특히 done).** 코드 없이 DB 검증만으로 완성되는 작업은 검증 fact 로 done 후보까지 인정(자동 done 은 여전히 금지). `SESSION_START_SHA` 미캡처 시 폴백 `HEAD~20`(과탐해도 doing 까지만).
+     커밋·파일·PR 또는 DB 검증 fact 가 매칭 근거 — **양쪽 다 0 이면 어떤 status 도 바꾸지 않는다(특히 done)**. DB 검증만으로 완성되는 작업은 검증 fact 로 done 후보 인정(자동 done 금지 동일). `SESSION_START_SHA` 미캡처 시 폴백 `HEAD~20`(과탐해도 doing 까지만).
    - (나) 산물을 task 의 `spec_ref`/`title`/`detail` 과 의미 매칭 — 변경 파일이 `spec_ref` 영역과 겹치면 강한 매칭.
    - 작업했는데 todo → `PATCH {id, status:'doing'}` (자동). / 매칭 없음 → `POST /tasks {project_id, title, status:'doing', source:'agent'}`.
    - doing 중 근거 실재하는 완성건 → **일괄 1회 보고** `"다음 N개를 완료로 올릴까요? — A(근거…), B(근거…)"` → OK 시에만 done PATCH. "느낌상 완료" 제외.
@@ -195,20 +170,15 @@ top-level `all_committed` 가 **`true` 일 때만** `[기억] … 저장` 보고
 
 ## 프로젝트 task 추적 (status 는 루키 전용)
 
-`/projects` 의 task status 는 **루키가 실제 업무·증거 기반으로만 갱신**한다(수동 토글 없음). 매 turn 금지 — **착수/완료 시점만**. 자기 출력 분석 금지. (마무리 reconcile 은 위 섹션 — 안전망.)
+`/projects` 의 task status 는 **루키가 실제 업무·증거 기반으로만 갱신**한다(수동 토글 없음). 매 turn 금지 — **착수/완료 시점만**. 자기 출력 분석 금지(마무리 reconcile 은 위 §).
 
 - **진행중 (doing)** — 착수 시 `GET /api/rookie/tasks?project_id=$PID` 후 의미 매칭: 확실 → `PATCH {id, status:'doing'}` + 1줄 알림 / 애매 → "이 작업이 'X' task 맞나요?" 1회 확인 / 매칭 없음 → `POST /tasks {…, status:'doing', source:'agent'}` 신규.
 - **완료 (done)** — **자동 done 금지.** `"'X' 를 완료로 올리겠습니다 — 근거: <파일/PR/검증 한 줄>. 올릴까요?"` → OK 시 `PATCH {id, status:'done', detail:'<기존>\n\n✅ 완료 YYYY-MM-DD — <근거>'}`.
-- **보류 (blocked)** — `PATCH {id, status:'blocked', blocked_reason:'<사유>'}`.
-- **재개 (done → doing)** — 추가 작업 발생 시 루키 자율 `PATCH {id, status:'doing', detail:'<기존>\n\n🔄 재개 YYYY-MM-DD — <사유>'}` (확인 불요).
-
-### 자동 계층 도출 (승인 게이트)
+- **보류 (blocked)** — `PATCH {id, status:'blocked', blocked_reason:'<사유>'}`. / **재개 (done→doing)** — 추가 작업 발생 시 루키 자율 `PATCH {id, status:'doing', detail:'<기존>\n\n🔄 재개 YYYY-MM-DD — <사유>'}` (확인 불요).
 
-평면 task 가 많으면 루키가 상위 목표를 제안해 계층을 잡는다(spec `2026-07-05-auto-hierarchy-derivation-design.md`).
+### 자동 계층 도출 (승인 게이트) — 평면 task 다수 시 상위 목표 제안(spec 2026-07-05)
 
 - **⭐ 3단 구조 원칙 (두목 2026-07-05, 항상 적용)**: 잎사귀 task 를 목표(1단) 직계에 붙이지 않는다 — 반드시 **목표 → 중간그룹(2단) → 잎(3단)**. 중간그룹이 없으면 먼저 만들거나 제안. done 잎도 예외 없다.
-- **트리거**: 두목 명시 요청 또는 미분류 최상위 task 다수(예 ≥8) 시 **1회 제안**.
-- **절차**: tasks 조회 → `title`/`detail` 의미로 배정 → 요약 제시(**raw uuid 금지, title 로**) → **승인 게이트**: OK 한 그룹만 기록.
-- **기록**: 신규 목표/중간그룹 `POST /api/rookie/tasks {project_id, title, detail?, status:'todo', source:'agent', parent_task_id?}` — 목표는 parent 없이, 중간그룹은 `parent_task_id`=목표. 잎은 `PATCH {id, parent_task_id:<중간그룹>}`. DB trigger 가 최종 검증(owner/project 일치·무사이클·≤32단), 실패 자식만 400 라벨 1줄 보고 후 건너뜀.
-- **안전**: 기존 `parent_task_id` 있는 task 재배정 금지(명시 지시 시만). 목표 중복이면 기존에 붙인다. 신규 목표에 자식 0건이면 명시 보고(자동 삭제 금지). 부분 실패 무손실.
-- **보고**: "목표 N개 · 자식 M건 연결(실패 K건: 사유)" 1줄.
+- **트리거**: 두목 명시 요청 또는 미분류 최상위 task 다수(예 ≥8) 시 **1회 제안**. **절차**: tasks 조회 → `title`/`detail` 의미로 배정 → 요약 제시(**raw uuid 금지, title 로**) → **승인 게이트**: OK 한 그룹만 기록.
+- **기록**: 신규 목표/중간그룹 `POST /api/rookie/tasks {project_id, title, detail?, status:'todo', source:'agent', parent_task_id?}` — 목표는 parent 없이, 중간그룹은 `parent_task_id`=목표. 잎은 `PATCH {id, parent_task_id:<중간그룹>}`. DB trigger 가 최종 검증(owner/project·무사이클·≤32단), 실패 자식만 400 라벨 1줄 보고 후 skip.
+- **안전**: 기존 `parent_task_id` 있는 task 재배정 금지(명시 지시 시만). 목표 중복이면 기존에 붙인다. 신규 목표에 자식 0건이면 명시 보고(자동 삭제 금지). 부분 실패 무손실. **보고**: "목표 N개 · 자식 M건 연결(실패 K건: 사유)" 1줄.

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.3",
-  "skill_version": "1.24.0"
+  "cli_version": "0.4.5",
+  "skill_version": "1.26.0"
 }