@kaydash9999/banker-plugins 0.23.3 → 0.24.1

package/skills/init-dir/templates/scripts/stop.cmd

@@ -0,0 +1,13 @@
+@echo off
+rem scripts\stop.cmd: Windows form of ./scripts/stop.sh (banker init-dir)
+rem Exit: 0 done, 1 failed, 2 no settings, 3 Node 18 or later not found
+setlocal
+set "NODE_BIN=%NODE%"
+if "%NODE_BIN%"=="" set "NODE_BIN=node"
+"%NODE_BIN%" -e "process.exit(Number(process.versions.node.split('.')[0]) >= 18 ? 0 : 1)" >nul 2>&1
+if errorlevel 1 (
+  echo Node 18 or later is required: %NODE_BIN% 1>&2
+  exit /b 3
+)
+"%NODE_BIN%" "%~dp0lib\service.mjs" stop %*
+exit /b %ERRORLEVEL%

package/skills/init-dir/templates/scripts/stop.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+# ./scripts/stop.sh: 서비스와 감독 프로세스를 멈춤 (banker init-dir)
+# 종료 코드: 0 성공, 1 실패, 2 설정 없음, 3 Node 18 이상 없음
+dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) || exit 1
+node_bin=${NODE:-node}
+if ! "$node_bin" -e 'process.exit(Number(process.versions.node.split(".")[0]) >= 18 ? 0 : 1)' >/dev/null 2>&1; then
+  echo "Node 18 이상 필요: $node_bin" >&2
+  exit 3
+fi
+exec "$node_bin" "$dir/lib/service.mjs" stop "$@"

package/skills/init-dir/templates/tests/README.md

@@ -0,0 +1,15 @@
+# tests
+
+단위 시험과 통합 시험 폴더. banker init-dir 이 만든 틀이다.
+
+| 폴더 | 둘 것 |
+|---|---|
+| `tests/unit/` | 단위 시험. 외부 서비스 없이 빠르게 끝나는 것 |
+| `tests/integration/` | 통합 시험. 실제 서비스, 파일, 네트워크를 쓰는 것 |
+
+- 실행: `./tests/run.sh`(Windows `tests\run.cmd`). 스위트 이름을 주면 그것만(`./tests/run.sh unit`)
+- 스위트 설정: `tests.conf` 에 `<스위트>=<명령>`. 프로젝트 폴더에서 셸로 실행
+- 출력: 스위트마다 한 줄(`PASS unit (1.2s)`, `FAIL integration (0.3s, 종료 1)`). 실패하면 그 출력의 마지막 20줄, 끝에 요약 한 줄
+- 시간 한도: 스위트마다 600초. `tests.conf` 의 `timeout=<초>` 나 환경 변수 `TESTS_TIMEOUT_SECONDS`(우선)로 바꿈. 넘으면 `FAIL <스위트> (600.0s, timeout 600초)` 와 그 스위트의 프로세스 트리 종료. 그래서 `timeout` 은 스위트 이름으로 못 씀
+- 종료 코드: 0 모두 통과, 1 실패 있음, 2 설정 없음(실행할 명령 없음 포함), 3 Node 18 이상 없음
+- 시험은 결과를 간결하게 출력하도록 쓴다. 통과는 조용히, 실패는 무엇이 왜 틀렸는지 한두 줄로

package/skills/init-dir/templates/tests/run.cmd

@@ -0,0 +1,13 @@
+@echo off
+rem tests\run.cmd: Windows form of ./tests/run.sh (banker init-dir)
+rem Exit: 0 all passed, 1 a suite failed, 2 no settings, 3 Node 18 or later not found
+setlocal
+set "NODE_BIN=%NODE%"
+if "%NODE_BIN%"=="" set "NODE_BIN=node"
+"%NODE_BIN%" -e "process.exit(Number(process.versions.node.split('.')[0]) >= 18 ? 0 : 1)" >nul 2>&1
+if errorlevel 1 (
+  echo Node 18 or later is required: %NODE_BIN% 1>&2
+  exit /b 3
+)
+"%NODE_BIN%" "%~dp0run.mjs" %*
+exit /b %ERRORLEVEL%

package/skills/init-dir/templates/tests/run.mjs

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+/**
+ * tests/run.mjs: runs the test suites in tests/tests.conf and prints one short line per suite (made by banker
+ * init-dir).
+ *
+ *   ./tests/run.sh [suite ...]        (Windows: tests\run.cmd)
+ *
+ * tests.conf lines are `<suite>=<command>`; the command runs through the shell in the project folder. A suite
+ * with no command is SKIP. Each run prints `PASS <suite> (1.2s)` or `FAIL <suite> (0.3s, 종료 1)` with the last
+ * lines of its output, then one summary line.
+ *
+ * Each suite has a time limit, 600 seconds unless `timeout=<seconds>` in tests.conf or the environment variable
+ * TESTS_TIMEOUT_SECONDS (which wins) says otherwise. A suite past it is `FAIL <suite> (600.0s, timeout 600초)` and
+ * its whole process tree is killed (its process group on POSIX, taskkill /T /F on Windows). `timeout` is therefore
+ * not a suite name.
+ *
+ * Exit status: 0 every suite run passed, 1 a suite failed, 2 no settings (no tests.conf, no command to run, an
+ * unknown suite name), 3 environment (the wrappers did not find Node 18 or later).
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const TESTS = dirname(fileURLToPath(import.meta.url));
+const ROOT = dirname(TESTS);
+const CONF = join(TESTS, "tests.conf");
+const TAIL_LINES = 20;
+const KEEP_BYTES = 1024 * 1024;
+const WIN = process.platform === "win32";
+const DEFAULT_TIMEOUT_S = 600;
+
+// The suites and the time limit in seconds: { suites, timeout }. `timeout=` sets the limit, every other key is a suite.
+function readConf() {
+  const suites = [];
+  let timeout = DEFAULT_TIMEOUT_S;
+  for (const raw of readFileSync(CONF, "utf8").split(/\r?\n/)) {
+    const line = raw.trim();
+    const eq = line.indexOf("=");
+    if (line.startsWith("#") || eq <= 0) continue;
+    const [key, value] = [line.slice(0, eq).trim(), line.slice(eq + 1).trim()];
+    if (key === "timeout") timeout = seconds(value) ?? timeout;
+    else suites.push({ name: key, command: value });
+  }
+  return { suites, timeout: seconds(process.env.TESTS_TIMEOUT_SECONDS) ?? timeout };
+}
+
+function seconds(text) {
+  const n = Number(text);
+  return text && Number.isFinite(n) && n > 0 ? n : null;
+}
+
+// The suite's whole tree: its process group on POSIX (it runs detached), taskkill /T /F on Windows.
+function killTree(child) {
+  // The shell may be gone while what it started still holds the output pipes, so the group is killed regardless.
+  if (!child.pid) return;
+  if (WIN) spawnSync("taskkill", ["/T", "/F", "/PID", String(child.pid)], { stdio: "ignore", windowsHide: true });
+  else {
+    try {
+      process.kill(-child.pid, "SIGKILL");
+    } catch {
+      // the group is gone already
+    }
+  }
+}
+
+// Output kept for the failure tail: the last KEEP_BYTES of stdout and stderr together.
+function collector() {
+  let text = "";
+  const add = (chunk) => {
+    text = (text + chunk).slice(-KEEP_BYTES);
+  };
+  return { add, lines: () => text.split(/\r?\n/).filter((l) => l.trim() !== "") };
+}
+
+let current = null;
+
+// Runs one suite: { code, signal, error, timedOut, output }.
+function spawnSuite(suite, limitS) {
+  return new Promise((done) => {
+    const out = collector();
+    const child = spawn(suite.command, { shell: true, cwd: ROOT, detached: !WIN, stdio: ["ignore", "pipe", "pipe"], windowsHide: true });
+    current = child;
+    let timedOut = false;
+    let error = null;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      killTree(child);
+    }, limitS * 1000);
+    for (const stream of [child.stdout, child.stderr]) {
+      stream.setEncoding("utf8");
+      stream.on("data", out.add);
+    }
+    child.on("error", (e) => {
+      error = e;
+    });
+    child.on("close", (code, signal) => {
+      clearTimeout(timer);
+      current = null;
+      done({ code, signal, error, timedOut, output: out.lines() });
+    });
+  });
+}
+
+async function runSuite(suite, limitS) {
+  const began = Date.now();
+  const r = await spawnSuite(suite, limitS);
+  const took = ((Date.now() - began) / 1000).toFixed(1);
+  if (r.code === 0 && !r.timedOut) return { pass: true, line: `PASS ${suite.name} (${took}s)` };
+  const why = r.timedOut ? `timeout ${limitS}초` : r.error ? r.error.message : r.code === null ? `신호 ${r.signal}` : `종료 ${r.code}`;
+  return { pass: false, line: `FAIL ${suite.name} (${took}s, ${why})`, tail: r.output.slice(-TAIL_LINES) };
+}
+
+function choose(suites, names) {
+  if (names.length === 0) return { chosen: suites };
+  const unknown = names.filter((n) => !suites.some((s) => s.name === n));
+  if (unknown.length > 0) return { error: `tests.conf 에 없는 스위트: ${unknown.join(", ")}` };
+  return { chosen: suites.filter((s) => names.includes(s.name)) };
+}
+
+async function runAll(chosen, limitS) {
+  const count = { pass: 0, fail: 0, skip: 0 };
+  for (const suite of chosen) {
+    if (suite.command === "") {
+      count.skip++;
+      console.log(`SKIP ${suite.name} (명령 없음)`);
+      continue;
+    }
+    const r = await runSuite(suite, limitS);
+    count[r.pass ? "pass" : "fail"]++;
+    console.log(r.line);
+    for (const line of r.tail ?? []) console.log(`  ${line}`);
+  }
+  console.log(`결과: 통과 ${count.pass}, 실패 ${count.fail}, 건너뜀 ${count.skip}`);
+  return count.fail > 0 ? 1 : 0;
+}
+
+function usageError(text) {
+  console.error(text);
+  return 2;
+}
+
+async function main(names) {
+  if (!existsSync(CONF)) return usageError(`설정 파일 없음: ${CONF}`);
+  const conf = readConf();
+  const { chosen, error } = choose(conf.suites, names);
+  if (error) return usageError(error);
+  if (!chosen.some((s) => s.command !== "")) return usageError(`실행할 명령 없음: ${CONF} 의 unit=, integration= 을 채우세요`);
+  return runAll(chosen, conf.timeout);
+}
+
+// A suite runs in its own process group, so Ctrl+C or a stop of run.mjs does not reach it by itself: pass it on.
+for (const [signal, code] of [["SIGINT", 130], ["SIGTERM", 143], ["SIGHUP", 129]]) {
+  process.on(signal, () => {
+    if (current) killTree(current);
+    process.exit(code);
+  });
+}
+
+process.exitCode = await main(process.argv.slice(2));

package/skills/init-dir/templates/tests/run.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+# ./tests/run.sh: tests/tests.conf 의 스위트를 돌리고 스위트마다 한 줄로 결과를 보고 (banker init-dir)
+# 종료 코드: 0 모두 통과, 1 실패 있음, 2 설정 없음, 3 Node 18 이상 없음
+dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) || exit 1
+node_bin=${NODE:-node}
+if ! "$node_bin" -e 'process.exit(Number(process.versions.node.split(".")[0]) >= 18 ? 0 : 1)' >/dev/null 2>&1; then
+  echo "Node 18 이상 필요: $node_bin" >&2
+  exit 3
+fi
+exec "$node_bin" "$dir/run.mjs" "$@"

package/skills/init-dir/templates/tests/tests.conf

@@ -0,0 +1,7 @@
+# 시험 스위트(banker init-dir). ./tests/run.sh 가 읽음
+# <스위트>=<명령>. 프로젝트 폴더에서 셸로 실행. 비어 있으면 건너뜀
+# 예: unit=node --test tests/unit
+# 스위트마다 시간 한도(초). 기본 600, 넘으면 FAIL(timeout) 과 프로세스 트리 종료. 환경 변수 TESTS_TIMEOUT_SECONDS 가 우선
+# timeout=600
+unit=
+integration=

package/skills/init-dir/templates/work/README.md

@@ -0,0 +1,8 @@
+# work
+
+사용자와 코딩 에이전트가 함께 쓰는 작업공간. banker init-dir 이 만든 틀이다.
+
+- 사용자가 에이전트에게 줄 파일(요구 문서, 예시 자료, 스크린샷 등)을 여기에 둔다
+- 에이전트는 사용자가 이 폴더를 가리키면 여기서 파일을 찾는다
+- 비밀값(키, 토큰, 비밀번호)을 두지 말 것. 커밋 전 git-init 이나 audit-security 스캔이 잡는다
+- 이 폴더는 git 에서 빼지 않는다

package/skills/progress-mon/README.md

@@ -1,6 +1,6 @@
 # progress-mon
 
-프로젝트 진척도를 4탭 웹 화면(진척도, 구현요건, workflow, 구성도)으로 보이는 스킬. 사용 절차는 `SKILL.md`.
+프로젝트 진척도를 5탭 웹 화면(진척도, 구현요건, workflow, 구성도, ADR)으로 보이는 스킬. 사용 절차는 `SKILL.md`.
 이 폴더 하나를 banker 의 `skills/progress-mon/` 으로 그대로 옮긴다.
 
 ## 구조
@@ -13,15 +13,17 @@
 | `scripts/pm-config.mjs` | 프로젝트 루트와 자료 폴더 결정, `config.json` 읽기, 기본값, 형식 검사, 원자적 쓰기(임시 파일과 rename, Windows 재시도) |
 | `scripts/pm-sources.mjs` | events.jsonl, git log, 워크플로 journal, `items.json` 읽기. 스토리와 라벨 판정 함수, 시각 해석, 읽기 캐시 |
 | `scripts/pm-html.mjs` | escape, 색 검사, 유한 수 검사, 글 폭 추정, 줄바꿈, 공통 CSS, 탭 머리 |
-| `scripts/pm-render.mjs` | 4탭, 단일 HTML 스냅숏(`export`), workflow 배치, 구성도 자동 배치 |
+| `scripts/pm-render.mjs` | 5탭, 단일 HTML 스냅숏(`export`), workflow 배치, 구성도 자동 배치 |
+| `scripts/pm-adr.mjs` | ADR 탭 검사: `adr.json` 두 층 스키마 검사, 참조 확인과 정리(`check --adr-cleanup`), `docs/adr/` 갈라짐 경고, 밀도, 집계, check 대조 기록(`adr-check.json`) |
+| `scripts/pm-adr-view.mjs` | ADR 탭 렌더: 화면 본문과 check 대조 배지 |
 | `scripts/pm-server.mjs` | `serve`, `start`, `stop`, `status`. 바인드, Host 검사, 신원 경로, 상태 파일, 포트 선택, 로그 |
 | `scripts/pm-data.mjs` | `init`, `item`, `note`, `stage`, `story`(`items.json` 잠금과 낡은 잠금 정리) |
-| `scripts/pm-memory.mjs` | 메모리 규칙 등록, 규칙 로드 한도 측정 |
+| `scripts/pm-memory.mjs` | 메모리 규칙 등록, 옛 판 규칙 줄의 제자리 교체(첫 원본 `.progress-mon.bak`), 규칙 로드 한도 측정 |
 | `scripts/pm-check.mjs` | 자료 형식, 상호 참조, 구성도와 workflow 기하, 밀도 검사 |
 | `scripts/index.js` | `node --test <폴더>/` 진입 로더. 모든 `*.test.mjs` 적재, 마지막 시험 `all <n> test files loaded` |
 | `scripts/*.test.mjs` | 모듈별 시험. 시험마다 `timeout: 60000` |
-| `references/` | `config.md`, `items.md`, `req-spec.md`, `reqs.md`, `flow.md`, `arch.md`(스키마와 판정 규칙), `authoring.md`(init 작성 지침, 밀도 기준), `inventory.md` |
-| `assets/fixture/` | 형식 시험용 최소 자료와 변형(`variants/`). 화면 수준의 견본이 아님 |
+| `references/` | `config.md`, `items.md`, `req-spec.md`, `reqs.md`, `flow.md`, `arch.md`, `adr.md`(스키마와 판정 규칙), `authoring.md`(init 작성 지침, 밀도 기준), `inventory.md` |
+| `assets/fixture/` | 형식 시험용 최소 자료와 변형(`variants/`, 옛 판 규칙 줄 `variants/legacy-init/`). 화면 수준의 견본이 아님 |
 
 - 의존성: Node 18 이상 내장 모듈만. npm 의존 0
 - 인코딩: UTF-8, BOM 없음, LF. 숨은 문자는 escape(`\u{...}`)로만
@@ -40,6 +42,7 @@
 - 시험은 임시 HOME, 임시 프로젝트, OS 가 고른 빈 포트에서 돈다. 포트 30000, 3456, 3458 은 쓰지 않는다
 - 시험은 PATH 의 `git` 으로 임시 저장소를 만든다. git 이 없는 PC 에서는 그 시험 10개가 실패한다(2026-10-30, PATH 에 node 와 mkfifo 만 두고 실측). 스킬 자체는 git 이 없으면 커밋 기록 없이 동작
 - FIFO 와 `/dev/zero` 시험은 POSIX 만. Windows 에서는 이유를 밝히고 건너뛴다
+- ADR 화면 e2e 는 Playwright Chromium 으로 `export` 한 HTML 을 연다. Playwright 는 `BUILD_TESTBOX_PLAYWRIGHT_DIR`(테스트박스 도구 폴더, `node_modules` 를 담은 폴더)이 있으면 그곳, 없으면 `npm root -g` 에서 찾는다. Playwright 가 없거나 Chromium 을 띄우지 못하면 사유를 밝히고 건너뛴다. `PM_ADR_SHOT=<png 경로>` 를 주면 스크린숏을 그 경로에 남긴다
 
 ## 개발
 
@@ -88,7 +91,7 @@ override 에 banker 블록이나 이 스킬 블록만 있으면 `init`, `status`
 | 항목 | `/banker:progress` | `/banker:progress-mon` |
 |---|---|---|
 | 종류 | 명령(`commands/progress.md`)과 훅 | 스킬 |
-| 보이는 곳 | Claude Mods 패널(세션 작업 목록) | 브라우저(로컬 포트 서버, 4탭) |
+| 보이는 곳 | Claude Mods 패널(세션 작업 목록) | 브라우저(로컬 포트 서버, 5탭) |
 | 런타임 | mod 를 지원하는 Claude Code 만 | Claude Code 와 Codex |
 | 서버 | 없음 | 있음(127.0.0.1 기본) |
 
@@ -100,8 +103,8 @@ override 에 banker 블록이나 이 스킬 블록만 있으면 `init`, `status`
 
 ```json
 { "name": "progress-mon", "type": "skill", "target": "both",
-  "reason": "project progress web screen with four tabs (progress, requirements, workflow, architecture) on a local server; init reads the code and writes the tab data, registers a one-line update rule in project memory; item, note, stage, story keep it current; pure Node, no deps",
-  "supportingFiles": ["README.md", "references/arch.md", "references/authoring.md", "references/config.md", "references/flow.md", "references/inventory.md", "references/items.md", "references/req-spec.md", "references/reqs.md", "scripts/index.js", "scripts/pm-check.mjs", "scripts/pm-config.mjs", "scripts/pm-data.mjs", "scripts/pm-html.mjs", "scripts/pm-memory.mjs", "scripts/pm-render.mjs", "scripts/pm-server.mjs", "scripts/pm-sources.mjs", "scripts/progress-mon.mjs", "assets/fixture/README.md", "assets/fixture/config.json", "assets/fixture/events.jsonl", "assets/fixture/items.json", "assets/fixture/commits.json", "assets/fixture/req-spec.json", "assets/fixture/reqs.json", "assets/fixture/flow.json", "assets/fixture/arch.json", "assets/fixture/workflows/wf_ex1/journal.jsonl", "assets/fixture/workflows/wf_ex1/agent-a01.jsonl", "assets/fixture/workflows/wf_ex1/agent-a02.jsonl", "assets/fixture/workflows/wf_ex1/agent-a03.jsonl", "assets/fixture/workflows/wf_ex1/agent-a04.jsonl", "assets/fixture/variants/arch-auto/arch.json", "assets/fixture/variants/check-auto/arch.json", "assets/fixture/variants/check-overlap/arch.json", "assets/fixture/variants/history-manual/config.json", "assets/fixture/variants/history-manual/items.json", "assets/fixture/variants/workflow-wide/flow.json"],
+  "reason": "project progress web screen with five tabs (progress, requirements, workflow, architecture, ADR) on a local server; init reads the code and writes the tab data, registers a one-line update rule in project memory; item, note, stage, story keep it current; pure Node, no deps",
+  "supportingFiles": ["README.md", "references/adr.md", "references/arch.md", "references/authoring.md", "references/config.md", "references/flow.md", "references/inventory.md", "references/items.md", "references/req-spec.md", "references/reqs.md", "scripts/index.js", "scripts/pm-adr.mjs", "scripts/pm-adr-view.mjs", "scripts/pm-check.mjs", "scripts/pm-config.mjs", "scripts/pm-data.mjs", "scripts/pm-html.mjs", "scripts/pm-memory.mjs", "scripts/pm-render.mjs", "scripts/pm-server.mjs", "scripts/pm-sources.mjs", "scripts/progress-mon.mjs", "assets/fixture/README.md", "assets/fixture/config.json", "assets/fixture/events.jsonl", "assets/fixture/items.json", "assets/fixture/commits.json", "assets/fixture/req-spec.json", "assets/fixture/reqs.json", "assets/fixture/flow.json", "assets/fixture/arch.json", "assets/fixture/adr.json", "assets/fixture/workflows/wf_ex1/journal.jsonl", "assets/fixture/workflows/wf_ex1/agent-a01.jsonl", "assets/fixture/workflows/wf_ex1/agent-a02.jsonl", "assets/fixture/workflows/wf_ex1/agent-a03.jsonl", "assets/fixture/workflows/wf_ex1/agent-a04.jsonl", "assets/fixture/variants/arch-auto/arch.json", "assets/fixture/variants/check-auto/arch.json", "assets/fixture/variants/check-overlap/arch.json", "assets/fixture/variants/history-manual/config.json", "assets/fixture/variants/history-manual/items.json", "assets/fixture/variants/workflow-wide/flow.json", "assets/fixture/variants/legacy-init/rules.json", "assets/fixture/variants/legacy-init/state.json"],
   "caveat": "needs Node 18 or later (above the package engines floor); binds 127.0.0.1 only by default, --host takes a private IPv4 with a warning; data lives in .omc/progress-mon/ (Codex .omx/progress-mon/); on Codex start, stop, status and init each ask for sandbox_permissions require_escalated, and a long-lived screen runs from the user's terminal (serve) since closing the session may stop the server" }
 ```
 

package/skills/progress-mon/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: progress-mon
-description: "프로젝트 진척도를 4탭 웹 화면(진척도, 구현요건, workflow, 구성도)으로 로컬 서버(기본 127.0.0.1:30000)에 띄움. 인자 없이 부르면 자료 폴더가 없을 때 init(코드를 읽어 4탭 자료를 쓰고 갱신 규칙 등록), 서버가 꺼져 있으면 start, 켜져 있으면 URL 보고. 하위 명령 init, start, stop, status, export, item, note, stage, story, check. 'progress-mon'/'진척도 화면'/'진척도 서버'/'진행 현황 웹 화면' 시 사용. 세션 작업 목록 패널은 이 스킬 대신 progress(Claude Code `/banker:progress`, Codex `$banker-progress`)."
+description: "프로젝트 진척도를 5탭 웹 화면(진척도, 구현요건, workflow, 구성도, ADR)으로 로컬 서버(기본 127.0.0.1:30000)에 띄움. ADR 탭은 결정마다 최적화 로직, 확장 대응, 포기와 얻은 것과 프로젝트의 검증, 흐름, 증거를 확인 가능한 참조와 함께 보임. 인자 없이 부르면 자료 폴더가 없을 때 init(코드를 읽어 5탭 자료를 쓰고 갱신 규칙 등록), 서버가 꺼져 있으면 start, 켜져 있으면 URL 보고. ADR 자료가 없는 옛 자료 폴더는 확인 뒤 ADR 단계를 먼저 함. 하위 명령 init, start, stop, status, export, item, note, stage, story, check. 'progress-mon'/'진척도 화면'/'진척도 서버'/'진행 현황 웹 화면' 시 사용. 세션 작업 목록 패널은 이 스킬 대신 progress(Claude Code `/banker:progress`, Codex `$banker-progress`)."
 ---
 
 # progress-mon: 프로젝트 진척도 웹 화면
 
-프로젝트의 진척도를 4탭 웹 화면으로 보인다. 서버는 Node 내장 모듈만 쓰고 기본으로 127.0.0.1 에만 바인드한다.
+프로젝트의 진척도를 5탭 웹 화면으로 보인다. 서버는 Node 내장 모듈만 쓰고 기본으로 127.0.0.1 에만 바인드한다.
 답변은 한글.
 
 progress-mon skill body marker v1
@@ -16,13 +16,16 @@ progress-mon skill body marker v1
 | 구현요건 | 요구 원문, 기능 명세, 근거 AC, 담당 스토리, 구현 여부 | `req-spec.json`, `reqs.json` |
 | workflow | 실행 흐름 그림, 분기, 외부 구성요소, 장면 대본 | `flow.json` |
 | 구성도 | 영역, 구성요소, 연결, 범례, 장면 대본 | `arch.json` |
+| ADR | 프로젝트 요약(검증, 흐름, 증거)과 결정마다 맥락, 선택지, 결론, 최적화 로직, 확장 대응, 포기와 얻은 것. 참조는 위치 글만 | `adr.json` |
 
 - 없는 출처는 건너뛴다. 자료가 없는 탭은 "자료 없음" 과 스키마 문서 경로를 보인다
 - 진척도, 구현요건 탭은 30초마다 자동 갱신(meta refresh). 다른 갱신 연결은 없다
+- ADR 탭은 서버가 `adr.json` 만 읽는다. 프로젝트의 `docs/adr/`, `docs/evidence/` 는 에이전트가 init 과 갱신 때 근거 출처로 읽고 참조로 가리킨다
 
 ## 언제 쓰나
 
-- 다른 프로젝트에서도 같은 4탭 진척도 화면을 띄우고 싶을 때
+- 다른 프로젝트에서도 같은 5탭 진척도 화면을 띄우고 싶을 때
+- 결정의 근거와 검증 증거를 타인이 확인할 수 있게 한 화면에 모으고 싶을 때(ADR 탭)
 - 단계, 스토리, 그 밖 작업의 진행을 에이전트가 세션마다 기록하게 하고 싶을 때
 - 화면을 서버 없이 한 파일로 넘겨야 할 때(`export`)
 
@@ -70,11 +73,30 @@ progress-mon skill body marker v1
    | 종료 3, `꺼짐(자료 폴더 없음: ...)` | 아래 "init 절차" 를 끝까지. 마지막 단계가 `start` 와 URL 보고 |
    | 종료 3, `꺼짐(자료 폴더: ...)` | `start` 를 실행하고 출력의 URL 을 보고 |
    | 종료 0, `실행 중: <URL> (PID n)` | URL 과 `탭 자료:` 줄을 보고 |
+   | 자료 폴더가 있고 `탭 자료:` 줄이 `ADR 없음` | 위 행의 일을 하기 전에 아래 "기존 프로젝트의 ADR 단계" 를 한다. `ADR 깨짐` 이면 하지 않고 깨짐을 보고(`check` 로 위치 확인) |
    | 종료 1 또는 2 | 오류 줄을 그대로 보고하고 멈춤 |
 
 3. `status` 의 표준 오류에 경고 줄(규칙 로드 한도, override 가려짐, `workflowDirs`)이 있으면 그대로 전한다
    - `WARN workflowDirs auto: 찾은 폴더 0` 은 이 프로젝트에서 Claude Code 워크플로를 돌린 적이 없으면 정상이다. 끄려면 `config.json` 의 `sources.workflowDirs` 를 `[]`(`references/config.md`)
 
+### 기존 프로젝트의 ADR 단계
+
+ADR 탭이 생기기 전 판으로 init 한 프로젝트는 `adr.json` 이 없고 메모리의 규칙 줄도 옛 판이다. 다음 인자 없는 호출에서 한 번 채운다.
+
+1. 진행 전에 한 번 묻는다: "ADR 탭 자료가 없습니다. 코드와 문서를 읽어 `adr.json` 을 쓰고 메모리의 progress-mon 규칙 줄을 새 판으로 바꿀까요?"
+   - Claude Code 는 AskUserQuestion, Codex 는 request_user_input 으로 묻는다(선택지: 진행, 이번에는 건너뜀)
+   - 사용자가 `--auto` 를 붙여 불렀거나(예 `/progress-mon --auto`, 스크립트에는 넘기지 않음) 다른 스킬이 자동 진행으로 불렀으면 묻지 않는다
+   - 건너뜀이면 원래 표의 일만 한다
+2. `<data>/state.json` 의 `memory`(`{kind, path}`)를 읽어 `init` 을 다시 실행한다. 다른 자료 파일은 이미 있으면 그대로 둔다
+   - `auto-memory`: `init --runtime <rt> --memory auto-memory --memory-dir "<path 의 폴더>"`(`--memory-dir` 필수. `path` 는 `MEMORY.md` 경로라 그 폴더를 넘긴다)
+   - `claude-md`, `agents-md`, `none`: `init --runtime <rt> --memory <kind>`
+   - Codex 는 init 처럼 `sandbox_permissions: "require_escalated"` 로 승인 요청
+3. 출력의 `규칙 줄 교체(백업 <경로>): <파일>` 줄을 사용자에게 알린다. 표식 줄(우리가 쓴 규칙 줄과 색인 줄)만 새 판으로 바꾸고 첫 원본을 그 백업에 남긴다. 사용자가 손으로 고친 표식 줄도 덮으므로 백업 경로를 함께 알린다
+4. 아래 "init 절차" 의 8(ADR 단계), 9~11(check 반복과 정리 단계)만 한다
+5. 원래 표의 일(`start` 와 URL 보고, 또는 URL 과 `탭 자료:` 보고)로 돌아간다
+
+- `--memory none` 으로 init 한 프로젝트는 바꿀 규칙 줄이 없어 1, 4, 5 만 한다
+
 - `start` 출력: `시작함: <URL>`, 이미 떠 있으면 `이미 실행 중(재사용): <URL>`. 포트가 차 있으면 다음 빈 포트를 쓰고 알림 줄을 낸다
 - `--port 0`(OS 선택)은 받지 않는다. 특정 포트를 피해야 하면 OS 가 고른 빈 포트를 먼저 얻어 `--port` 로 넘긴다(`references/config.md` 의 "포트와 주소")
 - 인자가 있는 호출(`/progress-mon status` 등)은 그 하위 명령을 `--runtime <rt>` 와 함께 그대로 실행하고 출력을 보고한다. `init` 만은 아래 절차를 따른다
@@ -86,19 +108,19 @@ progress-mon skill body marker v1
 | `init` | `--memory claude-md\|agents-md\|auto-memory\|none` `[--memory-dir <dir>] [--title <t>]` | 자료 폴더, `config.json`(있으면 그대로), 빈 `items.json`, `state.json` 생성. git 제외 목록에 자료 폴더 한 줄. 메모리 규칙 등록. `auto-memory` 는 `--memory-dir` 필수 |
 | `start` | `[--port <n>] [--port-strict] [--host <사설 IPv4>]` | 서버를 분리 실행하고 URL 출력. 같은 프로젝트 서버가 떠 있으면 재사용. 동시에 부른 start 는 차례로 돌아 서버 하나를 같이 씀. `<n>` 은 1024~65535 |
 | `stop` | 없음 | 상태 파일 PID 가 이 서버일 때만 끔 |
-| `status` | 없음 | 실행 여부, URL, PID, 자료 폴더, 탭별 자료 유무(깨진 JSON 은 깨짐), 시작 시각, 요청 수, 마지막 오류 시각. 서버를 띄운 뒤 `config.json` 의 `port`, `portStrict`, `hosts` 가 바뀌었으면 경고(그 셋만 `stop` 뒤 `start` 해야 적용, 나머지는 다음 응답에 반영) |
-| `export` | `<file> [--now <ISO>]` | 4탭을 한 HTML 파일로. 외부 자원 없음, `file://` 에서 탭 전환. 사용자가 지시할 때만 만든다 |
+| `status` | 없음 | 실행 여부, URL, PID, 자료 폴더, 탭별 자료 유무(`탭 자료:` 줄, 꺼져 있어도 자료 폴더가 있으면 보임. 깨진 JSON 은 깨짐), 시작 시각, 요청 수, 마지막 오류 시각. 서버를 띄운 뒤 `config.json` 의 `port`, `portStrict`, `hosts` 가 바뀌었으면 경고(그 셋만 `stop` 뒤 `start` 해야 적용, 나머지는 다음 응답에 반영) |
+| `export` | `<file> [--now <ISO>]` | 5탭을 한 HTML 파일로. 외부 자원 없음, `file://` 에서 탭 전환. 사용자가 지시할 때만 만든다 |
 | `item` | `--key <k> --status todo\|doing\|done --text <t> [--note <t>] [--issue <t>] [--at <ISO>] [--commit <hash>]` | 기타 항목. 같은 key 는 대체하고 시작 시각 유지(시작 시각은 `doing` 으로 기록할 때만). `--at` 은 지금 대신 그 시각으로 기록(시간대 필수). `--commit` 은 4~40자 16진 해시(commit Hash 칸에 앞 7자리). 빼면 있던 해시 유지 |
 | `note` | `--key <k> [--note <t>] [--issue <t>]` | 단계(`stage:<id>`)나 스토리 행의 비고, 문제점. 빈 값은 그 칸을 지움 |
 | `stage` | `--id <id> --status started\|done\|skipped\|failed\|stopped [--label <t>]` | 단계 상태 기록. 설정에 없는 id 는 새 단계 행 |
 | `story` | `--id <id> (--status todo\|doing\|done \| --commit <hash>) [--name <t>]` | 스토리 상태나 완료 커밋 기록. 설정에 없는 id 는 새 스토리 행 |
-| `check` | 없음 | 자료 파일 검사. `FAIL <파일> <json 경로> <이유>`, `WARN ...` 한 줄씩, 끝에 `check: FAIL n, WARN m` 과 밀도 요약 `density <탭> ok\|low`. 밀도 미달 줄 `WARN density <탭> <항목> <값>/<하한>[: <못 채운 대상>]` |
+| `check` | `[--adr-cleanup]` | 자료 파일 검사. `FAIL <파일> <json 경로> <이유>`, `WARN ...` 한 줄씩, 끝에 `check: FAIL n, WARN m` 과 밀도 요약 `density <탭> ok\|low`, 마지막 줄 `adr 근거 없음 n칸, 미검증 n, 구현 못 함 n, 참조 없는 서술 n`(늘. 참조 없는 서술은 `refs` 에 확인된 참조가 0개인 `optimization`, `scaling` 칸 수로 규칙은 WARN 이지만 0 이 아니면 화면 배지가 빨강). 밀도 미달 줄 `WARN density <탭> <항목> <값>/<하한>[: <못 채운 대상>]`. `--adr-cleanup` 은 먼저 init 정리 단계를 `adr.json` 에 적용(참조 FAIL 은 `gap`, 스키마 FAIL 이 남으면 같은 폴더의 `adr.json.rejected-<YYYYMMDD-HHMMSS>` 로 옮김. 이름이 있으면 `-2` 부터 번호)하고 `정리:` 줄(옮긴 경로 포함)을 낸 뒤 검사. 끝에 화면 대조용 `adr-check.json`(check 집계와 `adr.json` sha256)을 쓴다(`references/adr.md`) |
 
 - 공통 인자: `--runtime claude|codex`, `--project <dir>`, `--data <dir>`(자료 폴더 직접 지정)
 - 종료 코드: 0 성공(이미 그 상태 포함), 1 거부나 사용법 오류나 `check` FAIL, 2 예기치 못한 오류, 3 `status` 꺼짐
 - 자료 폴더가 없으면 `start`, `item`, `note`, `stage`, `story` 는 종료 1("init 먼저"). `status`, `check`, `export` 는 폴더를 만들지 않는다
 - 내부용 `serve`: `start` 와 같은 인자로 서버를 앞에서 실행. Codex 사용자 터미널 안내와 디버그에만 쓴다
-- 스키마와 규칙: `references/config.md`, `references/items.md`
+- 스키마와 규칙: `references/config.md`, `references/items.md`, `references/adr.md`
 
 ## init 절차
 
@@ -108,20 +130,33 @@ progress-mon skill body marker v1
    - 쓴 파일과 줄 수: 자동 메모리는 파일 2개(`progress-mon.md`, `MEMORY.md` 색인 1줄), `CLAUDE.md` 는 1줄, Codex 는 3줄 블록
    - `--memory claude-md` 는 프로젝트 루트 `CLAUDE.md` 를 만들거나 고친다. 새로 만들었으면 `git status` 에 추적하지 않는 파일로 보인다. 커밋할지는 사용자가 정한다고 알린다
    - 출력에 `경고:` 줄(규칙 로드 한도, override 가려짐)이 있으면 그대로 전한다. Claude 면 `--memory claude-md` 로 다시 등록할지 묻고, Codex 면 프로젝트 지시 파일 정리(banker `cleansing-memory`)나 `config.toml` 의 `project_doc_max_bytes` 확인을 제안한다
-   - 출력 끝 `다음 할 일` 3줄은 요약이다. 그 목록이 아니라 이 절차 4~13 을 모두 따른다(`inventory.json`, `config.json` 의 `title`, `shortName`, `stories`, 진척도 기록은 요약에 없어도 한다)
+   - 출력 끝 `다음 할 일` 3줄은 요약이다. 그 목록이 아니라 이 절차 4~14 를 모두 따른다(`inventory.json`, `config.json` 의 `title`, `shortName`, `stories`, 진척도 기록은 요약에 없어도 한다)
 4. `<S>/references/authoring.md` 를 읽는다. 밀도 기준 표, 읽기 예산, 좋은 예가 거기 있다
 5. 읽기 예산 안에서 코드를 읽고 `<data>/inventory.json` 을 쓴다(`references/inventory.md`)
 6. `<data>/config.json` 의 `title`, `shortName`, `stories` 를 채운다. `shortName` 은 브라우저 탭 제목과 구성도 그림 이름에 쓰는 짧은 이름(기본은 폴더 이름). 스토리가 없으면 빈 목록(`references/config.md`)
 7. `<data>/req-spec.json`, `reqs.json`, `flow.json`, `arch.json` 을 쓴다. 구조만 쓰고 좌표는 쓰지 않는다(자동 배치). 스토리가 없으면 명세마다 `state` 와 `note`(`references/req-spec.md`, `reqs.md`, `flow.md`, `arch.md`)
-8. `check` 를 실행한다. FAIL 이 있으면 고쳐 7 과 8 을 다시. 8 의 `check` 는 FAIL 0 이 될 때까지 최대 3회
-9. FAIL 0 이 된 뒤 `WARN density ...` 가 남으면 읽기 예산 안에서 한 번 보충하고 `check` 를 한 번 더 실행한다
-   - 이 보충과 `check` 는 8 의 3회에 세지 않는다. 보충은 한 번만
+8. ADR 단계: `<data>/adr.json` 을 쓴다(`references/adr.md`). 두 층(프로젝트의 검증, 흐름, 증거와 결정마다 최적화 로직, 확장 대응, 포기와 얻은 것). 근거 출처를 이 순서로 읽는다
+   1. 프로젝트의 `docs/adr/`(init-dir 규칙), `docs/evidence/`
+   2. `.omc/plans/*.md`(Codex `.omx/plans/`)의 ADR 절과 RALPLAN-DR
+   3. ultra-chain 실행 기록(`events.jsonl` 의 판정과 시험 기록)
+   4. 커밋 기록(`git log`)과 시험 파일
+
+   - 시험 결과는 실제로 돌린 명령의 출력만 참조한다. 출력 파일이 없으면 `cmd` 참조에 `output` 없이 두어 WARN 으로 드러낸다
+   - 근거가 없는 항목은 지어내지 않는다. 결정의 3칸과 흐름은 `{ "gap": "<사유>" }`, 증거 없는 모듈은 `status: "unverified"` 와 `why`, 증명 없는 기능은 `notImplemented`(구현됨, 검증됨 주장에 증거가 없으면 FAIL)
+   - `docs/adr/*.md` 가 있으면 결정마다 그 문서를 `sources` 로 가리킨다(가리키지 않는 문서는 WARN)
+9. `check` 를 실행한다. FAIL 이 있으면 고쳐 7, 8 과 9 를 다시. 9 의 `check` 는 FAIL 0 이 될 때까지 최대 3회
+10. FAIL 0 이 된 뒤 `WARN density ...` 가 남으면 읽기 예산 안에서 한 번 보충하고 `check` 를 한 번 더 실행한다
+   - 이 보충과 `check` 는 9 의 3회에 세지 않는다. 보충은 한 번만
    - 보충 뒤 새 FAIL 이 나오면 그 보충 부분을 고치거나 되돌려 FAIL 0 으로 둔다
    - 그래도 남은 `WARN density` 줄은 그대로 사용자에게 보고한다(실패 아님). 줄 끝의 대상 이름이 고칠 곳이다(`references/authoring.md`)
    - 자동 배치 WARN(`이름표 덮음`, `이름표가 그림 밖`)은 배치 조언이다. 자동 배치 선은 상자와 영역 제목을 돌아가므로 `선이 상자 지남` 은 보통 없다. 연결을 하한 아래로 지우지 않는다(`references/arch.md` 의 "자동 배치 WARN 줄이기")
    - `자기 연결` WARN 은 그 연결의 `from` 이나 `to` 를 실제 상대로 고친다
-10. 8 의 3회 뒤에도 FAIL 이 남으면 그 탭의 파일만 지워 "자료 없음" 으로 두고 남은 FAIL 을 보고한다
-11. 진척도 탭: 아는 단계와 작업을 적는다. 명령마다 `--note`(근거 커밋, 결과)를 쓴다. 문제점이 있으면 `--issue` 도 쓰고, 없으면 `--issue` 를 빼서 칸을 빈칸으로 둔다
+11. 정리 단계. 9 의 3회 뒤에도 FAIL 이 남으면
+    - 탭 파일(`req-spec.json`, `reqs.json`, `flow.json`, `arch.json`)은 FAIL 이 난 그 파일만 지워 "자료 없음" 으로 둔다
+    - `adr.json` 은 `check --adr-cleanup` 을 실행한다. 스키마 FAIL 이 남으면 지우지 않고 `adr.json.rejected-<YYYYMMDD-HHMMSS>` 로 옮겨 "자료 없음" 으로 두고(옮긴 경로를 보고), 참조 FAIL(`참조:` 가 붙은 줄)만 있으면 그 참조를 `{ "gap": "참조 확인 실패: <이유>" }` 로 바꾸고 다시 검사한다
+    - 정리 뒤 `증거 없음` FAIL(`정리: 증거가 남지 않은 주장 n건` 줄)이 남으면 스크립트는 옮기지 않는다. 증거를 지어내지 말고 그 모듈을 `status: "unverified"` 와 `why` 로, 그 기능을 `notImplemented` 로 옮긴 뒤 `check` 를 다시 돌린다(`references/adr.md` 의 "주장에는 증거")
+    - 남은 FAIL 과 정리 결과(`정리:` 줄)를 보고한다
+12. 진척도 탭: 아는 단계와 작업을 적는다. 명령마다 `--note`(근거 커밋, 결과)를 쓴다. 문제점이 있으면 `--issue` 도 쓰고, 없으면 `--issue` 를 빼서 칸을 빈칸으로 둔다
 
     | 프로젝트 | 쓸 명령 |
     |---|---|
@@ -131,11 +166,12 @@ progress-mon skill body marker v1
 
     - 스토리가 없는 프로젝트에서 `story` 를 쓰지 않는다. 설정에 없는 id 는 새 스토리 행이 되어 진척률이 켜진다. 단계도 같다(`stage` 는 새 단계 행)
     - 지난 커밋은 커밋 시각과 해시로 기록한다. `git log -n <수> --format="%h %cI %s"` 의 `%cI` 를 `--at`, `%h` 를 `--commit` 에 넘긴다(예 `item --key c-1a2b3c4 --status done --text "<제목>" --at 2026-10-20T12:34:56+09:00 --commit 1a2b3c4`). `--at` 이 없으면 모든 항목이 기록한 지금 시각으로 보인다. `--commit` 이 없으면 commit Hash 칸이 빈다
-12. `check` 를 다시 실행한다. 11 의 기록으로 `history 비고` 같은 밀도 줄이 바뀐다. 새 FAIL 이 있으면 고친다. 남은 `WARN` 은 보고한다
-13. `start` 를 실행하고 URL 을 보고한다
+13. `check` 를 다시 실행한다. 12 의 기록으로 `history 비고` 같은 밀도 줄이 바뀐다. 새 FAIL 이 있으면 고친다. 남은 `WARN` 은 보고한다
+14. `start` 를 실행하고 URL 을 보고한다
 
 - 자료가 없는 탭을 만들 수 없을 때(문서와 코드에 근거 없음)는 그 파일을 쓰지 않는다. 화면은 "자료 없음" 과 만드는 법을 보인다
-- 사용자 문서는 덧붙이기만 한다. 표식 `<!-- progress-mon:rule -->` 이 이미 있으면 다시 쓰지 않는다
+- 사용자 문서는 덧붙이기만 한다. 표식 `<!-- progress-mon:rule -->` 이 이미 있으면 다시 덧붙이지 않는다
+- 예외: 표식이 붙은 우리 줄(줄 앞머리가 `진척도 화면(progress-mon):` 인 규칙 줄과 `- [진척도 화면 갱신 규칙](progress-mon.md)` 인 색인 줄)이 지금 판과 다르면 그 줄만 제자리에서 바꾼다. 규칙 줄의 런타임은 줄에 `--runtime codex` 가 있으면 Codex 판. 줄 끝(CRLF, LF), BOM, 나머지 줄은 그대로이고, 첫 원본은 `<파일>.progress-mon.bak`(이미 있으면 덮지 않음). 앞머리가 다른 표식 줄은 손대지 않는다
 
 ## 갱신 규칙(init 뒤 세션)
 
@@ -151,6 +187,7 @@ progress-mon skill body marker v1
   | 스토리 진행, 완료 | `story --id <id> --status doing`, 완료 커밋은 `story --id <id> --commit <hash>` |
   | 그 밖 작업 | `item --key <k> --status doing\|done --text "<내용>" --note "<근거>" [--issue "<문제점>"]` |
   | 단계, 스토리 행의 비고 | `note --key stage:<id> --note "<근거>"`, `note --key <스토리 id> --issue "<문제점>"` |
+  | 결정이 생기거나 스토리가 끝남 | `<data>/adr.json` 을 고치고(`references/adr.md`) `check`. 참조 FAIL 은 FAIL 줄의 json 경로를 고침 |
 
 - Codex 는 모든 명령에 `--runtime codex` 를 붙인다. 세션을 닫아도 화면을 두려면 사용자 터미널의 `serve` 를 안내한다
 - 스토리 상태 우선순위: 커밋(제목 판정 또는 `story --commit`) 있으면 완료, 없으면 `story --status`, 없으면 진행 중 에이전트가 있으면 진행 중, 그 밖 예정

package/skills/progress-mon/assets/fixture/README.md

@@ -1 +1 @@
-형식 시험용 최소 자료(시험 픽스처와 형식 시험 보기 fixture-*). 화면 수준의 견본이 아님.
+형식 시험용 최소 자료(시험 픽스처와 형식 시험 보기 fixture-*). 화면 수준의 견본이 아님. `adr.json` 의 참조는 시험이 임시 프로젝트에 만드는 파일(`src/app.mjs`, `test/app.test.mjs`, `docs/evidence/test-run.md`, `docs/adr/0001-data-file.md`)을 가리킴. `variants/legacy-init/` 은 옛 판 init 의 규칙 줄(`rules.json`)과 `state.json`(`<memory-dir>` 자리는 시험이 바꿈).

package/skills/progress-mon/assets/fixture/adr.json

@@ -0,0 +1,35 @@
+{
+  "project": {
+    "verification": [
+      { "id": "M-1", "module": "설정 읽기", "result": "시험 3개 통과", "evidence": [{ "kind": "test", "path": "test/app.test.mjs", "name": "설정 읽기" }, { "kind": "cmd", "cmd": "node --test test/", "output": "docs/evidence/test-run.md" }] },
+      { "id": "M-2", "module": "화면 렌더", "result": "고정 자료로 HTML 확인", "evidence": [{ "kind": "file", "path": "src/app.mjs", "line": 3, "note": "render 함수" }] }
+    ],
+    "flow": { "input": "config.json 과 자료 파일", "logic": "설정을 읽어 검사한 뒤 탭마다 HTML 로 렌더", "output": "로컬 서버 화면과 단일 HTML", "refs": [{ "kind": "file", "path": "src/app.mjs", "line": 1 }] },
+    "proof": {
+      "implemented": [{ "feature": "설정 읽기와 화면", "modules": ["M-1", "M-2"], "proofs": [{ "kind": "test", "path": "test/app.test.mjs", "name": "설정 읽기" }, { "kind": "commit", "hash": "1a2b3c4" }] }],
+      "notImplemented": [{ "feature": "알림", "why": "범위 밖으로 미룸" }]
+    }
+  },
+  "decisions": [
+    {
+      "id": "ADR-1", "title": "자료는 JSON 파일", "status": "accepted", "date": "2026-10-20",
+      "context": "의존성 없이 자료를 저장해야 함",
+      "options": [{ "name": "JSON 파일", "pros": "내장 모듈만", "cons": "동시 쓰기 잠금 필요" }, { "name": "SQLite", "pros": "질의", "cons": "의존성 추가" }],
+      "decision": "JSON 파일", "why": "의존성 0 원칙과 자료 크기가 작음",
+      "optimization": { "process": "자료 크기 1 MB 미만에서 읽기 시간을 재어 파일 하나 읽기가 충분함을 확인", "modules": ["M-1"], "refs": [{ "kind": "cmd", "cmd": "node --test test/", "output": "docs/evidence/test-run.md" }] },
+      "scaling": { "argument": "탭마다 파일을 나눠 한 파일이 커지지 않음. 바뀐 파일만 다시 읽음", "limits": "파일 하나가 32 MB 를 넘으면 읽지 않음", "refs": [{ "kind": "file", "path": "src/app.mjs", "line": 2 }] },
+      "tradeoffs": { "gaveUp": [{ "what": "질의 기능", "why": "의존성 0" }], "gained": [{ "what": "설치 없는 실행", "purpose": "어느 PC 에서나 바로 실행" }] },
+      "sources": [{ "kind": "file", "path": "docs/adr/0001-data-file.md" }]
+    },
+    {
+      "id": "ADR-2", "title": "서버는 127.0.0.1 만", "status": "proposed",
+      "context": "화면을 로컬에서만 보이게 함",
+      "options": [{ "name": "127.0.0.1", "pros": "밖에서 못 봄", "cons": "다른 PC 에서 못 봄" }],
+      "rejected": "0.0.0.0 은 공개 노출 위험",
+      "decision": "127.0.0.1 바인드", "why": "보안 원칙",
+      "optimization": { "process": "바인드 주소별 접근 시험", "modules": ["M-2"], "refs": [{ "kind": "test", "path": "test/app.test.mjs", "name": "바인드" }] },
+      "scaling": { "gap": "규모 확장 근거를 아직 재지 않음" },
+      "tradeoffs": { "gaveUp": [{ "what": "원격 보기", "why": "노출 위험" }], "gained": [{ "what": "기본 안전", "purpose": "설정 실수로 밖에 열리지 않게" }] }
+    }
+  ]
+}

package/skills/progress-mon/assets/fixture/arch.json

@@ -13,7 +13,7 @@
     { "id": "browser", "zone": "user", "label": "브라우저", "x": 40, "y": 90, "w": 160, "h": 64, "kind": "사람", "detail": "탭을 고름" },
     { "id": "cli", "zone": "user", "label": "CLI", "x": 40, "y": 250, "w": 160, "h": 64, "kind": "명령", "detail": "시작, 정지, 기록" },
     { "id": "server", "zone": "app", "label": "서버", "x": 340, "y": 90, "w": 130, "h": 64, "kind": "프로세스", "detail": "Host 검사" },
-    { "id": "render", "zone": "app", "label": "렌더", "x": 530, "y": 90, "w": 130, "h": 64, "kind": "모듈", "detail": "네 탭 HTML" },
+    { "id": "render", "zone": "app", "label": "렌더", "x": 530, "y": 90, "w": 130, "h": 64, "kind": "모듈", "detail": "다섯 탭 HTML" },
     { "id": "files", "zone": "store", "label": "자료 파일", "x": 800, "y": 90, "w": 160, "h": 64, "kind": "파일", "detail": "JSON 네 개" },
     { "id": "git", "zone": "store", "label": "git 저장소", "x": 800, "y": 250, "w": 160, "h": 64, "kind": "저장소", "detail": "커밋 제목" }
   ],

package/skills/progress-mon/assets/fixture/flow.json

@@ -29,7 +29,7 @@
       "color": "#2e7d32",
       "steps": [
         { "id": "e1", "label": "인자 검사", "detail": "출력 파일 경로 확인", "actor": "cli.mjs", "refs": ["cli.mjs:80"], "planned": false },
-        { "id": "e2", "label": "네 탭 렌더", "detail": "네 탭을 한 파일에 담음", "actor": "render.mjs", "refs": ["render.mjs:200"], "planned": false },
+        { "id": "e2", "label": "다섯 탭 렌더", "detail": "다섯 탭을 한 파일에 담음", "actor": "render.mjs", "refs": ["render.mjs:200"], "planned": false },
         { "id": "e3", "label": "파일 쓰기", "detail": "임시 파일에 쓰고 이름 바꿈", "actor": "cli.mjs", "refs": [], "planned": true }
       ],
       "branches": [],
@@ -39,6 +39,6 @@
   "scenes": [
     { "n": 1, "sec": 2, "lane": "main", "focus": ["p1", "p2"], "caption": "인자와 설정을 읽음" },
     { "n": 2, "sec": 3, "lane": "main", "focus": ["p4", "p5"], "caption": "상태를 판정해 화면을 그림" },
-    { "n": 3, "sec": 2, "lane": "export", "focus": ["e2"], "caption": "네 탭을 한 파일로" }
+    { "n": 3, "sec": 2, "lane": "export", "focus": ["e2"], "caption": "다섯 탭을 한 파일로" }
   ]
 }

package/skills/progress-mon/assets/fixture/variants/arch-auto/arch.json

@@ -20,7 +20,7 @@
     { "id": "browser", "zone": "user", "label": "브라우저", "x": 40, "y": 90, "w": 160, "h": 64, "kind": "사람", "detail": "탭을 고름" },
     { "id": "cli", "zone": "user", "label": "CLI", "x": 40, "y": 250, "w": 160, "h": 64, "kind": "명령", "detail": "시작, 정지, 기록" },
     { "id": "server", "zone": "app", "label": "서버", "x": 340, "y": 90, "w": 130, "h": 64, "kind": "프로세스", "detail": "Host 검사" },
-    { "id": "render", "zone": "app", "label": "렌더", "x": 530, "y": 90, "w": 130, "h": 64, "kind": "모듈", "detail": "네 탭 HTML" },
+    { "id": "render", "zone": "app", "label": "렌더", "x": 530, "y": 90, "w": 130, "h": 64, "kind": "모듈", "detail": "다섯 탭 HTML" },
     { "id": "files", "zone": "store", "label": "자료 파일", "x": 800, "y": 90, "w": 160, "h": 64, "kind": "파일", "detail": "JSON 네 개" },
     { "id": "git", "zone": "store", "label": "git 저장소", "x": 800, "y": 250, "w": 160, "h": 64, "kind": "저장소", "detail": "커밋 제목" }
   ],

package/skills/progress-mon/assets/fixture/variants/legacy-init/rules.json

@@ -0,0 +1,6 @@
+{
+  "note": "옛 판(브랜치 bd4d7cd) init 이 쓴 규칙 줄. 규칙 줄 교체 시험이 이 줄로 메모리 파일을 만든다",
+  "claude": "진척도 화면(progress-mon): 단계는 stage, 스토리는 story, 그 밖 작업은 item 으로 갱신. .omc/progress-mon/state.json 의 skillDir 아래 scripts/progress-mon.mjs 를 node 로 직접 실행하고, 실패하면 progress-mon 스킬로 호출. 세션 시작 때 status, 꺼져 있으면 start. <!-- progress-mon:rule -->",
+  "codex": "진척도 화면(progress-mon): 모든 명령에 --runtime codex 를 붙임. 단계는 stage, 스토리는 story, 그 밖 작업은 item 으로 갱신. .omx/progress-mon/state.json 의 skillDir 아래 scripts/progress-mon.mjs 를 node 로 직접 실행하고, 실패하면 banker-progress-mon 스킬(플러그인 설치는 banker:progress-mon)로 호출. 세션 시작 때 status, 꺼져 있으면 start. start, stop, status 는 sandbox_permissions \"require_escalated\" 로 승인 요청. 세션을 닫아도 화면을 두려면 사용자 터미널에서 serve 실행을 안내. <!-- progress-mon:rule -->",
+  "index": "- [진척도 화면 갱신 규칙](progress-mon.md) - stage, story, item 으로 progress-mon 갱신 <!-- progress-mon:rule -->"
+}

package/skills/progress-mon/assets/fixture/variants/legacy-init/state.json

@@ -0,0 +1,5 @@
+{
+  "runtime": "claude",
+  "memory": { "kind": "auto-memory", "path": "<memory-dir>/MEMORY.md" },
+  "updatedAt": "2026-10-30T00:00:00Z"
+}