leerness 1.36.18 → 1.36.20

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.36.20 — 2026-07-14 — `--apply --json`이 실제로 적용하도록 수정 — mutation-before-output (codex fresh-QA #7, 3커맨드 재현확정)
+
+codex fresh-surface QA(1.36.19 이연분)에서 확정한 **silent no-op** 버그 수정: `--json` 분기가 mutation "전"에 return 해, `--apply --json`이 적용을 보고하고도 실제로는 아무 변경도 안 하던 3개 커맨드.
+
+- **`reuse autodetect --apply --json`** — 후보만 보고하고 reuse-map.md를 안 씀(bin:20307의 --json return이 20319의 --apply 앞). → apply를 출력 전에 수행하고 JSON에 `applied`/`added` 반영. 실측: `--apply --json` → `applied:true, added:2` + reuse-map 실제 기록(0→1건), `--apply`(no-json) 무회귀.
+- **`release cleanup --apply --json`** — `apply:true, deleteCount:N`을 보고하고도 브랜치를 안 지움(15018의 --json return이 15051의 삭제 앞). → 삭제를 출력 전에 수행하고 JSON에 `deleted`/`deleteFailed` 반영 + 삭제 실패 시 `exitCode=1`. 실측: `--apply --keep 1 --json` → `deleted:3` + 브랜치 실제 삭제(4→1).
+- **`env encoding --apply --json`** — read-only 파일 apply 실패를 `action:'failed'`로 기록만 하고 exit 0. → 실패 시 `process.exitCode=1`. 실측: read-only→exit 1, writable→exit 0.
+- **검증**: selftest 290/290(신규 소스가드 — 3커맨드의 apply-before-output 구조 + 실패 exit 반영), 각 커맨드 재현확정(임시 프로젝트/git-repo/read-only 파일), 게이트 e2e, 게시본 클린룸.
+- **이연(다음 라운드)**: codex #8(CRLF `plan.md` 태스크 파서 tasks:[] + 잘못된 JSON 스키마가 `--json` 경로 crash — 파서 서브시스템 별도 조사) + #6(`copyRec` lstatSync 심링크).
+
+## 1.36.19 — 2026-07-14 — 전략 앵커(project-brief/plan Goal) 미작성 감지 — 인계 AI가 프로젝트 맥락을 못 받던 근본원인 표면화 (실사용 7 프로젝트 dogfood)
+
+**현장 관찰**: leerness를 오래 적용한 실프로젝트에서, 인계받은 AI(codex 등)가 "leerness를 참조하나 프로젝트 맥락을 이해 못 하고" 작업하는 현상이 보고됨. 7개 실사용 프로젝트를 dogfood 조사한 결과 근본원인이 드러남 — **동적 상태(current-state 7/7, decisions)는 잘 유지되나, 정체성 앵커인 `project-brief.md` Purpose(5/7 미작성)와 `plan.md` Goal/Scope(7/7 미작성)이 템플릿 placeholder 그대로 방치됨**. 27개 결정을 쌓은 프로젝트조차 brief는 빈칸. 그 결과 인계 AI는 "최근 무슨 작업을 했는지"(동적)는 받지만 "이 프로젝트가 무엇이고 범위가 어디까지인지"(정체성)를 못 받아, 최근 스레드만 이어가며 전체 프레임을 놓침. 게다가 leerness 스스로 이 갭을 전혀 경고하지 않았음(감지 부재).
+
+- **전략 앵커 미작성 감지 (신규)**: pure-utils에 `_briefUnfilled`/`_planGoalUnfilled` 순수 detector 추가 — `## Purpose`/`## Goal` 섹션이 템플릿 placeholder 문구이거나 실내용 0(빈 bullet)이면 미작성으로 판정. bullet/문단 무관(문단형 실작성도 정상 인식), 섹션 자체가 없으면 미플래그(FP 회피). 7 프로젝트 ground-truth + 컨트롤(placeholder/빈칸/bullet작성/문단작성/섹션없음)로 판별 정밀 검증.
+- **`audit` finding 2종**: project-brief Purpose 미작성 → `project_brief_unfilled` 경고("인계받는 AI가 프로젝트 목적/맥락을 못 받습니다"), plan Goal 미작성 → `plan_goal_unfilled` 경고. `<!-- leerness:na -->` 마커로 의도적 스킵 가능(기존 design-system/reuse-map 관례와 동일).
+- **handoff 헤드라인 표면화**: 세션 시작 헤드라인에 `📋 project-brief 미작성` / `📋 plan Goal 미작성` / `📋 정체성앵커 미작성 (brief+plan)` 노출 — 파묻힌 init task(T-0001) 대신 매 세션 가시화. 채워진 프로젝트엔 무신호(무노이즈).
+- **검증**: selftest 289/289(신규 앵커 감지 행위검사 — placeholder/빈칸/bullet/문단/섹션없음 5판별 + audit/handoff 배선 가드), 실프로젝트 실증(Adzento=brief+plan 경고, cafe-macro/view-work=brief populated·plan만), 게이트 e2e, 게시본 클린룸.
+- **이연(다음 라운드, codex fresh-surface QA)**: #7 `--json`이 mutation 전 early-return(`reuse autodetect`/`release cleanup`/`env encoding` `--apply --json`이 apply를 보고하나 실제 미적용) + 실패 시 exit 0, #8 CRLF `plan.md` tasks:[] & 잘못된 JSON 스키마가 `--json` 경로에서 crash(구조화 에러 아님), #6 `copyRec` lstatSync 심링크 미처리. 재현→수정 예정.
+
 ## 1.36.18 — 2026-07-14 — UR-0052: handoff --compact 단일경로 + ID 5자리+ 대응 (P2-6 주석 마스킹은 조사 후 이연)
 
 1.36.17에서 백로그로 이연했던 UR-0052 3건 중 2건(P3-8·P1-2)을 재현·수정. P2-6(주석 마스킹)은 codex 7라운드 적대 재검 끝에 **파서 없이 안전 구현 불가**로 판단해 이연(하단 상세). 각 수정은 파일 스크립트 프로브 + selftest 케이스로 실증(맹신 X).

package/README.md

@@ -125,7 +125,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.36.18 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.36.20 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -179,7 +179,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.36.18는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
+Leerness v1.36.20는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -200,7 +200,7 @@ Leerness v1.36.18는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.36.18)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.36.20)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -238,6 +238,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.36.18: 2026-07-14
+Last synced by Leerness v1.36.20: 2026-07-14
 <!-- leerness:project-readme:end -->
 

package/bin/leerness.js

@@ -26,14 +26,14 @@ const { _isSecretKey, _isPlaceholderSecret, _looksSecretLike, _mergeLines, _merg
   _migrationGuideText, _parseContractSpec, _gitignoreMatch,
   _featureGraphTemplate, _parseFeatureGraph, _nextFeatureId, _featureBlock, _featureImpactBfs,
   _parseChangelogBetween, _cellSafe, _cellUnescape, _lineSafe, _parseLimit, _parseAddTitle, _parseImplExports, _taskPositionalPath, _completionClaimAllowed, _minorKey, _shouldPublishNpm,
-  _matchTool, _parsePackageJsonDeps, _parseRequirementsTxt, _buildGlossary, _renderGlossaryMd } = require('../lib/pure-utils');  // 1.9.318~1.11.4 (UR-0025/.../0007 glossary): 순수 유틸 모듈 분리
+  _matchTool, _parsePackageJsonDeps, _parseRequirementsTxt, _buildGlossary, _renderGlossaryMd, _briefUnfilled, _planGoalUnfilled } = require('../lib/pure-utils');  // 1.9.318~1.11.4 (UR-0025/.../0007 glossary): 순수 유틸 모듈 분리
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
 const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG, _TOOL_CATALOG, _LSP_LANG_PATTERNS, OPTIMISM_PATTERNS, BUILT_IN_PERSONAS, STRINGS, BUILTIN_CATALOG, ROADMAP_STATUS_LABEL, ROADMAP_STATUS_COLOR, SECRET_PATTERNS, MERGE_OVERWRITE_FILES, MINIMAL_SKIP_KEYS, REQUIRED_WORKSPACE_FILES, KEYWORD_STOPWORDS, SKILL_CATALOG_PRESETS } = require('../lib/catalogs');  // 1.9.344/368/369 (UR-0025): catalog 분리 · 1.11.4 (UR-0007): _TOOL_CATALOG
 const { findCorruptedStateJson: _findCorruptedStateJson } = require('../lib/state-integrity');  // 1.36.1 (클린룸 리뷰 FN): .harness/*.json 상태 무결성 (audit/health/check 공유)
 
-const VERSION = '1.36.18';
+const VERSION = '1.36.20';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2611,6 +2611,8 @@ function envCmd(root, sub) {
         }
       }
     }
+    // 1.36.20 (codex fresh-QA #7): apply 실패(read-only EPERM 등)를 exit code 에 반영 — 종전엔 action:'failed' 를 기록만 하고 exit 0.
+    if (apply && (result.applied || []).some(a => a.action === 'failed')) process.exitCode = 1;
     if (has('--json')) { log(JSON.stringify(result, null, 2)); return; }
     log(cy(`# leerness env encoding-check (1.9.241/242, UR-0014) — 셸 스크립트 인코딩 위험 감지`));
     log('');
@@ -2963,6 +2965,13 @@ function _selfTestCases() {
       const realDecl = p._parseContractSpec('function realFn(){}\n').declared.includes('realFn');        // 회귀: 펜스 밖 선언 유지
       return bracket && dotStill && fenceExcluded && realDecl;
     } },
+    { name: 'apply-before-output mutation 순서 (1.36.20, codex fresh-QA #7): reuse/release --apply 가 --json return 전 수행 + 실패 exit code — 소스가드', run: () => {
+      const s = read(__filename);
+      const reuseOk = s.includes('project: path.basename(root), found, applied, added') && s.includes("failJson(has('--json'), 'no_reuse_map'");   // reuse: apply 먼저 → json 에 applied/added
+      const releaseOk = s.includes('deleteCount: toDelete.length, deleted, deleteFailed') && s.includes('if (deleteFailed > 0) process.exitCode = 1');  // release: 삭제 먼저 → json 에 deleted
+      const encOk = s.includes("(result.applied || []).some(a => a.action === 'failed')) process.exitCode = 1");   // encoding: 실패 exit1
+      return reuseOk && releaseOk && encOk;
+    } },
     { name: 'ID 리더 5자리+ 대응 (1.36.18, UR-0052 P1-2): \\d{4}→\\d{4,} — 10k+ ID(T-10000) truncation 방지, 날짜 연도는 exactly-4 보존 — 행위검사', run: () => {
       // 행위: 5자리 ID 전체 캡처(구 \d{4}는 앞 4자리만 → truncation/충돌), 4자리 ID 무회귀, 날짜 연도 exactly-4 유지.
       const taskRe = /\bT-(\d{4,})\b/;
@@ -2984,6 +2993,22 @@ function _selfTestCases() {
       const libNoStale = !read(dir + '/feature.js').includes('F-\\d{4}$') && !read(dir + '/audit.js').includes('(M-\\d{4})');
       return idFive && idFour && ruleFive && mileFive && dateExact4 && readersWidened && dateKept && libWidened && libNoStale;
     } },
+    { name: '전략 앵커 미작성 감지 (1.36.19, 실사용 7 프로젝트 dogfood): project-brief Purpose / plan Goal placeholder·빈칸 감지 + 실작성(bullet/문단) 무오탐 — 행위검사', run: () => {
+      const p = require('../lib/pure-utils');
+      if (typeof p._briefUnfilled !== 'function' || typeof p._planGoalUnfilled !== 'function') return false;
+      const phBrief = p._briefUnfilled('# Project Brief\n## Purpose\n- 이 프로젝트의 목적을 실제 내용으로 업데이트하세요.\n## Users\n-\n');  // 템플릿 placeholder
+      const emptyBrief = p._briefUnfilled('## Purpose\n- \n## Users\n-\n');                                                          // 빈 bullet
+      const filledBullet = !p._briefUnfilled('## Purpose\n- 소셜 발행 자동화 MCP 서버\n');                                            // 실작성(bullet) 무오탐
+      const filledPara = !p._briefUnfilled('## Purpose\n코드베이스 변화를 실시간 가시화한다\n');                                       // 실작성(문단) 무오탐
+      const noSection = !p._briefUnfilled('# Project Brief\n## Project\nfoo\n');                                                       // Purpose 섹션 없음 → 미플래그(FP 회피)
+      const phPlan = p._planGoalUnfilled('# Plan\n## Goal\n- 사용자 목적을 기준으로 전체 계획을 유지합니다.\n## Scope\n-\n');           // plan 템플릿
+      const filledPlan = !p._planGoalUnfilled('## Goal\n- 카드뉴스 발행 자동화 완성\n');                                              // 실작성 plan 무오탐
+      // audit + handoff 배선 가드
+      const s = read(__filename); const au = require('fs').readFileSync(require('path').join(require('path').dirname(__dirname), 'lib', 'audit.js'), 'utf8');
+      const wired = au.includes("_finding('project_brief_unfilled'") && au.includes("_finding('plan_goal_unfilled'")
+        && s.includes('📋 project-brief 미작성');
+      return phBrief && emptyBrief && filledBullet && filledPara && noSection && phPlan && filledPlan && wired;
+    } },
     { name: '시크릿 스캐너 FN 헌트 (1.35.14): 하드코딩 자격증명 복합/JSON키 탐지 + Slack xapp + 사전단어 FP 억제 — 행위검사', run: () => {
       const pats = require('../lib/catalogs').SECRET_PATTERNS;
       const pu = require('../lib/pure-utils');
@@ -9325,6 +9350,19 @@ function handoff(root) {
           }
         }
       } catch {}
+      // 2b) 전략 앵커 미작성 (1.36.19, 실사용 7 프로젝트 dogfood): project-brief Purpose(5/7)·plan Goal(7/7)이 템플릿 그대로
+      //   방치돼 인계받는 AI 가 "프로젝트가 무엇인지/범위"를 못 받던 근본원인 → 세션시작 헤드라인에 표면화(파묻힌 init task 대신 가시화).
+      try {
+        const _naM = '<!-- leerness:na';
+        const _bf = path.join(root, '.harness/project-brief.md');
+        const _briefTxt = exists(_bf) ? read(_bf) : '';
+        const _planTxt = exists(planPath(root)) ? read(planPath(root)) : '';
+        const briefGap = !_briefTxt.includes(_naM) && _briefUnfilled(_briefTxt);
+        const planGap = !!_planTxt && !_planTxt.includes(_naM) && _planGoalUnfilled(_planTxt);
+        if (briefGap && planGap) parts.push(t('📋 정체성앵커 미작성 (brief+plan)', '📋 identity anchors unfilled (brief+plan)'));
+        else if (briefGap) parts.push(t('📋 project-brief 미작성', '📋 project-brief unfilled'));
+        else if (planGap) parts.push(t('📋 plan Goal 미작성', '📋 plan Goal unfilled'));
+      } catch {}
       // 3) MCP 활동 누적
       try {
         const stats = _readUsageStats(root);
@@ -14985,11 +15023,21 @@ function releaseCleanupCmd(root) {
   });
   const recent = mergedBranches.slice(0, keep);
   const toDelete = mergedBranches.slice(keep).filter(b => b !== currentBranch);
+  // 1.36.20 (codex fresh-QA #7): 삭제(mutation)를 출력(json/human) "전"에 수행. 종전엔 --json 분기가 삭제 전 return 해
+  //   `release cleanup --apply --json` 이 apply:true·deleteCount N 을 보고하고도 실제로 아무것도 안 지우던 silent no-op.
+  let deleted = 0, deleteFailed = 0;
+  if (apply) {
+    for (const b of toDelete) {
+      const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
+      if (r.status === 0) deleted++; else deleteFailed++;
+    }
+    if (deleteFailed > 0) process.exitCode = 1;   // 실패 시 nonzero exit
+  }
   // 5) JSON
   if (has('--json')) {
     log(JSON.stringify({
       apply, keep, total: allBranches.length, merged: mergedBranches.length,
-      unmerged: unmergedBranches.length, deleteCount: toDelete.length,
+      unmerged: unmergedBranches.length, deleteCount: toDelete.length, deleted, deleteFailed,
       toDelete, recent: recent.slice(0, keep), unmergedSample: unmergedBranches.slice(0, 5)
     }, null, 2));
     return;
@@ -15020,13 +15068,7 @@ function releaseCleanupCmd(root) {
   if (recent.length > 5) log(dm(`    ... +${recent.length - 5}개`));
   log('');
   if (apply) {
-    let ok = 0, fail = 0;
-    for (const b of toDelete) {
-      const r = cp.spawnSync('git', ['branch', '-d', b], { cwd: root, encoding: 'utf8' });
-      if (r.status === 0) ok++;
-      else fail++;
-    }
-    log(gr(`  ✓ 삭제 완료: ${ok}/${toDelete.length}건`) + (fail > 0 ? rd(` · 실패 ${fail}`) : ''));
+    log(gr(`  ✓ 삭제 완료: ${deleted}/${toDelete.length}건`) + (deleteFailed > 0 ? rd(` · 실패 ${deleteFailed}`) : ''));   // 1.36.20: 삭제는 출력 전 수행됨(#7)
   } else {
     log(dm(`  → 적용: leerness release cleanup --apply (안전: merged만 삭제, 현재 branch 보호)`));
     log(dm(`  → --keep N: 최근 N개 유지 (default 5)`));
@@ -20275,37 +20317,39 @@ function reuseAutodetectCmd(root) {
       }
     }
   }
-  if (has('--json')) {
-    log(JSON.stringify({ project: path.basename(root), found }, null, 2));
-    return;
-  }
-  log(`# leerness reuse autodetect (1.9.35)`);
-  log(`project: ${path.basename(root)}`);
-  log(`발견된 capability 후보: ${found.length}건`);
-  log('');
-  log('| Capability | Where | Kind | Note |');
-  log('|---|---|---|---|');
-  for (const c of found) log(`| ${c.name} | ${c.file} | util | (autodetect from module.exports) |`);
-  log('');
+  // 1.36.20 (codex fresh-QA #7): --apply mutation 을 출력(human/json) "전"에 수행. 종전엔 --json 분기가 --apply 앞에서
+  //   return 해 `reuse autodetect --apply --json` 이 후보만 보고하고 실제 reuse-map 을 안 쓰던 silent no-op. 이제 먼저 mutate →
+  //   applied/added 를 human/json 양쪽에 반영. 에러도 --json 시 구조화(failJson).
+  let applied = false, added = 0;
   if (has('--apply')) {
-    // reuse-map.md에 추가 (헤더 보존 + 후보 라인 append)
     const reusePath = path.join(root, '.harness', 'reuse-map.md');
     if (!exists(reusePath)) {
-      fail(`.harness/reuse-map.md 없음 — leerness init 먼저 실행`);
-      return process.exit(1);
+      failJson(has('--json'), 'no_reuse_map', `.harness/reuse-map.md 없음 — leerness init 먼저 실행`);
+      return process.exit(process.exitCode || 1);
     }
     let body = read(reusePath);
-    let added = 0;
     for (const c of found) {
       if (body.includes(`| ${c.name} |`)) continue; // 이미 있음
       body += `| ${c.name} | ${c.file} | util | autodetect 1.9.35 |\n`;
       added++;
     }
     writeUtf8(reusePath, body);
-    log(`✓ ${added}건 reuse-map.md에 추가됨`);
-  } else {
-    log(`(--apply 로 reuse-map.md에 자동 추가)`);
+    applied = true;
   }
+  if (has('--json')) {
+    log(JSON.stringify({ project: path.basename(root), found, applied, added }, null, 2));
+    return;
+  }
+  log(`# leerness reuse autodetect (1.9.35)`);
+  log(`project: ${path.basename(root)}`);
+  log(`발견된 capability 후보: ${found.length}건`);
+  log('');
+  log('| Capability | Where | Kind | Note |');
+  log('|---|---|---|---|');
+  for (const c of found) log(`| ${c.name} | ${c.file} | util | (autodetect from module.exports) |`);
+  log('');
+  if (applied) log(`✓ ${added}건 reuse-map.md에 추가됨`);
+  else log(`(--apply 로 reuse-map.md에 자동 추가)`);
 }
 
 // 1.9.165: leerness web — playwright bridge MVP (opt-in 의존성, 5능력 #1 보강)

package/lib/audit.js

@@ -7,6 +7,7 @@ const path = require('path');
 const { log, ok, warn, fail, failJson, today, now, absRoot, exists, read, readBuf, mkdirp, writeUtf8, append, rel } = require('./io');
 const { SECRET_PATTERNS } = require('./catalogs');
 const { findCorruptedStateJson } = require('./state-integrity');  // 1.36.1 (클린룸 리뷰 FN): 상태 JSON 무결성
+const { _briefUnfilled, _planGoalUnfilled } = require('./pure-utils');  // 1.36.19: 전략 앵커(project-brief/plan Goal) 미작성 감지
 
 function audit(root, opts = {}, deps = {}) {
   const { VERSION, arg, has, planPath, readProgressRows, currentStatePath, handoffPath, envDiff, _readFeatureGraph, _matchAPISkills, _listAPISkills, _collectSecretFindings } = deps;
@@ -61,7 +62,15 @@ function audit(root, opts = {}, deps = {}) {
   if (reuse.includes(naMarker)) ok('reuse-map.md marked NA (skipped)');
   else if (reuseLines === 0) { warnings++; warn('reuse-map.md is empty (consider populating known reusable elements)'); _finding('reuse_map_empty', 'warn', 'reuse-map.md is empty'); }
   else ok(`reuse-map.md has ${reuseLines} entries`);
+  // 1.36.19 (실사용 7 프로젝트 dogfood): 전략 앵커 미작성 — 동적 상태는 유지되나 project-brief Purpose(5/7)·plan Goal(7/7)이
+  //   템플릿 그대로라 인계받는 AI 가 "프로젝트가 무엇인지/범위"를 못 받음(관찰된 근본원인). naMarker 로 의도적 스킵 가능.
+  const briefFile = path.join(root, '.harness/project-brief.md');
+  const briefTxt = exists(briefFile) ? read(briefFile) : '';
+  if (briefTxt.includes(naMarker)) ok('project-brief.md marked NA (skipped)');
+  else if (_briefUnfilled(briefTxt)) { warnings++; warn('project-brief.md Purpose 미작성(템플릿 그대로) — 인계받는 AI가 프로젝트 목적/맥락을 못 받습니다 (project-brief.md 채우기)'); _finding('project_brief_unfilled', 'warn', 'project-brief.md Purpose still placeholder/empty — AI handoffs lack project context'); }
+  else ok('project-brief.md Purpose populated');
   const planText = exists(planPath(root)) ? read(planPath(root)) : '';
+  if (planText && !planText.includes(naMarker) && _planGoalUnfilled(planText)) { warnings++; warn('plan.md Goal 미작성(템플릿 그대로) — 프로젝트 목표/범위가 비어 인계 AI가 방향을 못 잡습니다 (plan.md Goal/Scope 채우기)'); _finding('plan_goal_unfilled', 'warn', 'plan.md Goal still placeholder/empty'); }
   const milestoneIds = Array.from(planText.matchAll(/^### (M-\d{4,})\./gm)).map(m => m[1]);
   const rows = readProgressRows(root);
   // 1.9.6 수정: 한 row에 여러 plan:M-XXXX 링크가 있어도 모두 인식 (matchAll로 전부 추출)

package/lib/pure-utils.js

@@ -1043,8 +1043,33 @@ function _renderGlossaryMd(entries, opts = {}) {
   return s + GLOSSARY_END + '\n';
 }
 
+// 1.36.19 (실사용 7 프로젝트 dogfood): 전략 앵커(project-brief Purpose / plan Goal) 미작성 감지.
+//   현장 관찰 — 동적 상태(current-state/decisions)는 7/7 유지되나 정체성 앵커는 brief 5/7·plan 7/7 이 템플릿 placeholder
+//   그대로 방치됨(27개 결정 쌓은 프로젝트조차 brief 빈칸). 인계받은 AI 가 "프로젝트가 무엇인지"를 못 받는 근본원인 →
+//   audit/handoff 가 표면화하도록 순수 detector. bullet/문단 무관, 빈 섹션·placeholder 문구를 모두 미작성으로 판정.
+//   섹션 자체가 없으면(구조 미상) 미플래그(FP 회피). `<!-- leerness:na -->` 스킵은 캘러(audit)가 처리.
+function _mdSectionBody(content, heading) {
+  const lines = String(content || '').split('\n');
+  const h = new RegExp('^##\\s*' + heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\s*$', 'i');
+  const i = lines.findIndex(l => h.test(l));
+  if (i < 0) return null;
+  const body = [];
+  for (let j = i + 1; j < lines.length; j++) { if (/^##\s/.test(lines[j])) break; body.push(lines[j]); }
+  return body.join('\n');
+}
+const _BRIEF_PLACEHOLDER_RE = /실제\s*(?:내용|목적)\s*으로\s*업데이트|describe .*purpose here|update .*with (?:the )?real/i;
+const _PLAN_GOAL_PLACEHOLDER_RE = /전체\s*계획을\s*유지합니다|사용자\s*목적을\s*기준으로|state your goal here|maintain the overall plan/i;
+function _sectionUnfilled(content, heading, placeholderRe) {
+  const body = _mdSectionBody(content, heading);
+  if (body == null) return false;                                       // 섹션 없음 → 미플래그
+  if (placeholderRe.test(body)) return true;                            // 템플릿 문구 그대로
+  return !body.split('\n').some(l => l.replace(/^\s*[-*]\s*/, '').trim().length > 0);  // 실내용(bullet/문단) 0 → 빈칸
+}
+function _briefUnfilled(content) { return _sectionUnfilled(content, 'Purpose', _BRIEF_PLACEHOLDER_RE); }
+function _planGoalUnfilled(content) { return _sectionUnfilled(content, 'Goal', _PLAN_GOAL_PLACEHOLDER_RE); }
+
 module.exports = {
-  _parseImplExports,
+  _parseImplExports, _briefUnfilled, _planGoalUnfilled, _mdSectionBody,
   _matchTool, _parsePackageJsonDeps, _parseRequirementsTxt, _buildGlossary, _renderGlossaryMd, GLOSSARY_START, GLOSSARY_END,
   _isSecretKey, compareVer, parseHarnessVersion,
   _isPlaceholderSecret, _looksSecretLike,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.36.18",
+  "version": "1.36.20",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",