npm - tink-harness - Versions diffs - 1.15.4 → 1.16.0 - Mend

tink-harness 1.15.4 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/.claude-plugin/plugin.json +1 -1
package/CHANGELOG.md +3 -1
package/README.ko.md +119 -136
package/README.md +115 -172
package/VERSIONING.md +1 -1
package/commands/deep-cast.md +824 -0
package/commands/list.md +1 -0
package/package.json +1 -1
package/templates/claude/commands/tink/deep-cast.md +824 -0
package/templates/claude/commands/tink/list.md +1 -0

package/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "tink",
   "description": "A small harness layer for Claude Code and Codex.",
-  "version": "1.15.4",
+  "version": "1.16.0",
   "author": {
     "name": "dotori"
   }

package/CHANGELOG.md CHANGED Viewed

@@ -4,7 +4,9 @@ All notable changes to Tink are tracked here.
 ## Unreleased
-- Added a geobench product spec and runbook for measuring Tink's LLM answer visibility with hit rate, MRR, share of voice, and citation metrics. The runbook keeps benchmark execution separate from this repo and says to publish aggregate metrics only.
+## [1.16.0] - 2026-06-25
+- `/tink:deep-cast` 신규 명령 추가: `cast_mode`를 변경하지 않고 이번 작업 한 번만 deep 모드(구조화 인터뷰)로 실행한다. `/tink:cast deep`이 기본값을 영구 변경하는 것과 구분된다.
 ## [1.15.4] - 2026-06-24

package/README.ko.md CHANGED Viewed

@@ -1,67 +1,30 @@
-<p align="center">
+<p align="center">
   <img src=".github/assets/hero.webp" alt="Tink Hero Banner" width="100%">
 </p>
 # Tink
-**Claude Code · Codex 작업의 맥락이 더는 사라지지 않게.**
-Tink는 사소하지 않은 모든 에이전트 작업을 눈에 보이는 파일로 남깁니다 — 작업 계약, 실행 상태, 검증 단계, 그리고 승인해야만 저장되는 재사용 하네스. 서버도, 텔레메트리도, 숨은 상태도 없습니다.
+**Claude Code · Codex 에이전트 작업을 눈에 보이게, 재사용 가능하게, 승인 게이트로. 서버도, 숨은 상태도 없이.**
 <sub>Claude Code와 Codex를 위한 작은 하네스 레이어</sub>
-**최신 패키지:** v1.15.4 — deep 모드 인터뷰 UX 개선: 라운드 표시 적응형 전환, 구성 요소 이모지 표기, 질문 없을 때 표시 생략. 전체 변경 이력은 [CHANGELOG](CHANGELOG.md)를 확인하세요.
+<p>
+  <a href="https://github.com/dotoricode/tink-harness/releases/latest"><img src="https://img.shields.io/github/v/release/dotoricode/tink-harness?label=release&color=2ea44f" alt="GitHub release"></a>
+  <a href="https://www.npmjs.com/package/tink-harness"><img src="https://img.shields.io/npm/v/tink-harness?label=npm&color=cb3837" alt="npm version"></a>
+  <a href="https://github.com/dotoricode/tink-harness/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/dotoricode/tink-harness/ci.yml?branch=main&label=ci" alt="CI"></a>
+  <a href="https://github.com/dotoricode/tink-harness/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dotoricode/tink-harness" alt="License"></a>
+  <a href="https://github.com/dotoricode/tink-harness/stargazers"><img src="https://img.shields.io/github/stars/dotoricode/tink-harness?style=social" alt="GitHub stars"></a>
+</p>
 [English](README.md) · **한국어** · [변경 이력](CHANGELOG.md)
 ---
-## 누구를 위한 도구인가
-이런 순간에 쓰세요:
-- Claude Code나 Codex가 작업 사이에 맥락을 자꾸 잃을 때
-- 같은 리뷰 / 리팩터링 / 디버깅 절차를 매번 손으로 반복할 때
-- 숨은 채팅 기억 대신 눈에 보이는 실행 상태를 원할 때
-- 재사용 가능한 에이전트 워크플로를 원하지만, 명시적 승인 후에만 저장되길 원할 때
-내 얘기 같다면, 버려도 되는 repo에서 먼저 시도해 보세요:
-```bash
-npx tink-harness@latest install
-```
-## 실제로 남는 것
-사소하지 않은 작업마다 열어보고, diff하고, 커밋할 수 있는 평범한 파일이 남습니다:
-```text
-.tink/current/                      # 진행 중인 실행 — 언제든 열람 가능
-  contract.json                     #   작업이 끝났을 때 참이어야 하는 것
-  plan.md                           #   눈에 보이는 계획
-  checks.md                         #   "완료" 선언 전 돌릴 검증
-.tink/runs/
-  2026-06-11-1430-auth-refactor.md  # 끝난 실행의 간결한 기록
-.tink/harnesses/
-  refactor-review.md                # 재사용 작업 방식 — 승인해야 저장
-```
-## CLAUDE.md·슬래시 명령·스킬만으로는 왜 부족할까?
-| 도구 | 제공하는 것 | Tink가 얹는 것 |
-|---|---|---|
-| CLAUDE.md | 프로젝트 전역 지침 | 작업 단위 계약·실행 상태·검증 |
-| 슬래시 명령 | 재사용 프롬프트 | 하네스 선택, 실행 기록, 진행도 추적 |
-| 스킬 | 재사용 능력 | 사용 생애주기: 건강 점수·정리·개선 신호 |
-| MCP | 외부 컨텍스트·도구 | 로컬, 승인 게이트 워크플로 메모리 |
-Tink는 이들을 대체하지 않고 함께 동작합니다.
+Tink가 없으면 에이전트 작업의 맥락은 매번 채팅 기록 속으로 사라집니다. 같은 리뷰·리팩터링·디버깅을 손으로 반복하고, 재사용하겠다고 적어둔 워크플로는 어딘가에 묻혀버립니다.
----
-## 빠른 시작
+Tink를 쓰면 사소하지 않은 모든 작업마다 읽고, diff하고, 커밋할 수 있는 파일이 남습니다 — 작업 계약, 눈에 보이는 계획, 검증 단계. 재사용 워크플로(하네스)는 명시적 승인 후에만 저장되고, 실제 run 기록을 바탕으로 점점 나아집니다. 그 기록이 로컬 건강 대시보드가 됩니다.
-1분이면 Tink를 직접 써볼 수 있습니다.
+## 1분이면 시작됩니다
 **Claude Code (플러그인):**
@@ -78,7 +41,7 @@ Tink는 이들을 대체하지 않고 함께 동작합니다.
 npx tink-harness@latest install
 ```
-설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있고, 언어는 `LANG`을 자동 감지합니다(`--lang=en|ko|zh`로 변경). Codex에서는 `$tink:cast <task>`로 시작합니다.
+설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있고, 언어는 `LANG`을 자동 감지합니다(`--lang=en|ko|zh`로 변경 가능).
 <details>
 <summary>repo 내부 Codex smoke 검증 (CODEX_HOME)</summary>
@@ -97,121 +60,107 @@ npx tink-harness@latest install
 $tink:cast 인증 모듈 리팩터링     # Codex
 ```
-`cast`는 작업에 맞는 하네스를 고르고(없으면 초안을 만들고), `.tink/current/`에 보이는 계획을 쓰고, 승인 후 첫 안전한 단계를 시작합니다. 끝난 run마다 간결한 기록이 남고 — 그 기록이 아래 대시보드가 됩니다.
-## 하네스 건강을 눈으로 확인
-몇 번의 run이 쌓이면, 명령 하나로 기록을 로컬 대시보드로 만들어 브라우저까지 열어 줍니다:
-```bash
-npx tink-harness dashboard          # 파일만 만들려면 --no-open 추가
-```
-내부적으로는 읽기 전용 helper 두 개(`node .tink/tools/generate-harness-lifecycle-summary.mjs` → `node .tink/tools/render-harness-health-report.mjs`)를 실행한 뒤 `.tink/maintenance/harness-health-report.html`을 엽니다.
+`cast`는 작업에 맞는 하네스를 고르고(없으면 초안을 만들고), `.tink/current/`에 보이는 계획을 쓰고, 승인 후 첫 안전한 단계를 시작합니다.
 ![Tink 대시보드 데모 — 건강 그룹 클릭, 하네스 카드 탐색, 3D 지도 조작](.github/assets/demo.gif)
-<sub>당신의 워크플로와 맞는다면, ⭐ 하나가 다른 개발자들이 찾는 데 도움이 됩니다.</sub>
-하네스와 그들이 쓰는 규칙·메모리, 그 연결을 보여주는 인터랙티브 3D 지도 — 무리마다 고유한 색을 갖고, 살아있는 관계 위로 신호가 흐릅니다:
-![Tink 하네스 지도 — 하네스·규칙·메모리·단계를 보여주는 인터랙티브 3D 뷰](.github/assets/dashboard-map.ko.png)
-실제 사용량 순으로 정렬된 하네스 카드 — 쉬운 말 건강 요약, 주의 점수, 승인 이력, 그리고 Claude Code·Codex 양쪽 복사용 명령이 포함된 다음 행동 제안:
-![사용량 순 하네스 카드와 쉬운 말 건강 요약·히스토리](.github/assets/dashboard-harnesses.ko.png)
-서버도, 텔레메트리도, 숨은 캐시도 없습니다 — 제안만 준비하는 정적 로컬 페이지입니다. 재사용되는 변경은 여전히 Tink의 승인 절차를 거칩니다.
+<sub>워크플로와 맞는다면 ⭐ 하나가 다른 개발자들이 찾는 데 도움이 됩니다.</sub>
 ---
-## GEO 노출도 측정
-Tink에는 LLM 답변에서 Tink가 얼마나 자주 언급되고, 어느 순위로 추천되며, 어떤 출처로 인용되는지 측정하기 위한 geobench 제품 스펙이 포함되어 있습니다.
+## 이런 순간에 쓰세요
-- Spec: [`geobench/tink-harness.yaml`](geobench/tink-harness.yaml)
-- Runbook: [`docs/geobench.md`](docs/geobench.md)
-- 지표: hit rate, MRR, share of voice, citation rate/share, confidence interval
-벤치마크 결과는 집계 지표만 공개하세요. 원문 provider 답변, 시크릿, 개인 실행 로그는 공개하지 않습니다.
+- Claude Code나 Codex가 작업 사이에 맥락을 자꾸 잃을 때
+- 같은 리뷰 / 리팩터링 / 디버깅 절차를 매번 손으로 반복할 때
+- 숨은 채팅 기억 대신 눈에 보이는 실행 상태를 원할 때
+- 재사용 가능한 에이전트 워크플로를 원하지만, 명시적 승인 후에만 저장되길 원할 때
 ---
-## 왜 만들었나
-새로운 AI 코딩 하네스와 워크플로는 계속 늘어납니다. 좋은 것도 많지만, 여러 개를 섞다 보면 환경이 무거워지고 매번 다시 정리해야 합니다.
-Tink는 큰 프레임워크가 아닙니다. Claude Code나 Codex가 지금 작업에 필요한 절차만 고르고, 없으면 작은 임시 하네스를 만들고, 반복되는 실수만 승인 후 재사용 지식으로 남기도록 돕습니다.
-## 업데이트
+## 실제로 남는 것
-Claude Code 플러그인:
+사소하지 않은 작업마다 열어보고, diff하고, 커밋할 수 있는 평범한 파일이 남습니다:
 ```text
-/plugin marketplace update tink-harness
-/plugin update tink@tink-harness
-/reload-plugins
+.tink/current/                      # 진행 중인 실행 — 언제든 열람 가능
+  contract.json                     #   작업이 끝났을 때 참이어야 하는 것
+  plan.md                           #   눈에 보이는 계획
+  checks.md                         #   "완료" 선언 전 돌릴 검증
+.tink/runs/
+  2026-06-11-1430-auth-refactor.md  # 끝난 실행의 간결한 기록
+.tink/harnesses/
+  refactor-review.md                # 재사용 작업 방식 — 승인해야 저장
 ```
-Standalone / Codex:
-```bash
-npx tink-harness@latest update
-```
+## CLAUDE.md·슬래시 명령·스킬만으로는 왜 부족할까?
-업데이트는 질문 하나 — 어떤 agent surface를 갱신할지 — 만 묻고 나머지는 자동으로 처리합니다. 언어·설치 범위·git 정책은 설치 때 선택한 값을 그대로 재사용하며, ".tink 커밋 안 함"을 선택했다면 업데이트가 `.gitignore`를 절대 건드리지 않습니다. Tink가 관리하는 파일(commands, skills, 런타임 tools)은 항상 최신으로 덮어쓰고, 사용자가 수정한 하네스·메모리·설정과 `.tink/maintenance/`의 모든 기록(ledger 등)은 보존합니다.
+| 도구 | 제공하는 것 | Tink가 얹는 것 |
+|---|---|---|
+| CLAUDE.md | 프로젝트 전역 지침 | 작업 단위 계약·실행 상태·검증 |
+| 슬래시 명령 | 재사용 프롬프트 | 하네스 선택, 실행 기록, 진행도 추적 |
+| 스킬 | 재사용 능력 | 사용 생애주기: 건강 점수·정리·개선 신호 |
+| MCP | 외부 컨텍스트·도구 | 로컬, 승인 게이트 워크플로 메모리 |
-`CODEX_HOME`을 지정하지 않으면 Windows에서는 `%USERPROFILE%\.codex`, macOS/Linux에서는 `~/.codex`에 Codex skill이 설치됩니다.
+Tink는 이들을 대체하지 않고 함께 동작합니다.
-### 고급 옵션
+---
-Interactive install/update 중에는 **고급 옵션** 단계가 나옵니다. 예전에는 CLI flag를 직접 알아야 했지만, 이제는 선택 화면에서 볼 수 있습니다.
+## 하네스 건강 대시보드
-- `Preview only (--dry-run)`: 실제 파일을 바꾸기 전에 Tink가 무엇을 쓰고, 보존하고, 지울 예정인지 먼저 보고 싶을 때 씁니다. 파일은 변경하지 않습니다.
-- `Overwrite user-modified files (--force)`: 설치가 꼬였고 공식 템플릿으로 되돌리고 싶을 때만 씁니다. 일반 업데이트는 사용자가 고친 파일을 보존합니다.
-- `Clean Codex picker (--clean-codex-picker)`: 이 repo에서 Codex만 쓸 때, Codex picker에 `Source Command Tink ...` 중복 항목이 보여서 헷갈리면 씁니다. Claude Code와 Codex를 둘 다 쓰는 설치에서는 이 옵션을 보여주지 않습니다.
+몇 번의 run이 쌓이면, 명령 하나로 기록을 로컬 대시보드로 만들어 브라우저까지 열어 줍니다:
-패키지는 이미 `tink-harness` 실행 파일 이름을 제공합니다. package manager가 이 실행 파일을 `PATH`에 설치한 환경에서는 `tink-harness update`처럼 입력할 수 있습니다. 아직 설치되어 있지 않다면 `npx tink-harness@latest update`를 계속 쓰면 됩니다. macOS와 Windows에서 직접 명령 경로를 확실히 검증한 뒤 README 예시를 더 짧게 바꾸는 작업은 계획 문서에 따로 남겨둡니다.
+```bash
+npx tink-harness dashboard          # 파일만 만들려면 --no-open 추가
+```
-업데이트가 정상인지 빠르게 확인하려면 `docs/update-verification-recipe.ko.md` 또는 `docs/update-verification-recipe.md`를 확인하세요.
+하네스와 그들이 쓰는 규칙·메모리, 그 연결을 보여주는 인터랙티브 3D 지도:
-업데이트 후 Codex skill, schema, Windows 경고가 이상해 보이면 `docs/update-troubleshooting.ko.md` 또는 `docs/update-troubleshooting.md`를 확인하세요.
+![Tink 하네스 지도 — 하네스·규칙·메모리·단계를 보여주는 인터랙티브 3D 뷰](.github/assets/dashboard-map.ko.png)
-## 명령
+실제 사용량 순으로 정렬된 하네스 카드 — 쉬운 말 건강 요약, 주의 점수, 승인 이력, Claude Code·Codex 양쪽 복사용 다음 행동:
-Claude Code에서는 `/tink:*`, Codex에서는 `$tink:*`을 씁니다. 예전 `$tink cast` 형식도 호환되지만, 기본 안내와 자동완성 표면은 `$tink:*`입니다.
+![사용량 순 하네스 카드와 쉬운 말 건강 요약·히스토리](.github/assets/dashboard-harnesses.ko.png)
-### `/tink:cast` / `$tink:cast`
+서버도, 텔레메트리도, 숨은 캐시도 없습니다 — 제안만 준비하는 정적 로컬 페이지입니다. 재사용되는 변경은 여전히 Tink의 승인 절차를 거칩니다.
-작업을 읽고, 필요한 하네스만 고르고, `.tink/current/` 실행 상태를 만든 뒤 첫 번째 안전한 단계를 시작합니다.
+---
-Tink는 이제 비단순 작업에 대해 `.tink/current/contract.json`도 만듭니다. 이 파일에는 작업 종류, 위험, 성공 조건, 금지 사항, 검증 명령이 들어갑니다.
+## 왜 만들었나
-더 크거나 모호한 작업에서는 `cast`가 에이전트의 생각 단계를 파일로 더 잘 드러내는 하네스를 고를 수 있습니다. 모호한 아이디어는 `requirements-interview`, 큰 계획은 `plan-consensus`, 긴 실행은 `goal-checkpoint`, 안전한 인수인계는 `delegation-brief`를 씁니다.
+새로운 AI 코딩 하네스와 워크플로는 계속 늘어납니다. 좋은 것도 많지만, 여러 개를 섞다 보면 환경이 무거워지고 매번 다시 정리해야 합니다.
-더 특화된 작업에서는 focused harness도 선택할 수 있습니다. 이슈·PR·QA 정리는 `issue-triage`, 어려운 버그 재현 루프는 `bug-diagnosis-loop`, Standards와 Spec을 나누는 리뷰는 `review-two-axis`, 여러 세션에 걸친 미해결 결정은 `decision-map`, module/interface/seam 구조 개선은 `architecture-deepening`이 담당합니다. 모두 `/tink:cast` 또는 `$tink:cast`가 고르는 재사용 하네스이며, 별도 CLI 명령은 아닙니다.
+Hermes Agent를 쓰면서 기억에 남은 건 *사용할수록 나아지는 방식*이었습니다. 반복 작업이 재사용 스킬이 되고, 실수가 메모리가 되고, 시스템이 쓰는 사람에 맞게 천천히 바뀌어갔습니다.
-### `/tink:verify` / `$tink:verify`
+Tink는 간단한 질문에서 시작했습니다:
-`contract.json`에 적힌 검증을 실제로 실행하고 증거를 남깁니다.
+> Claude Code나 Codex도 같은 방식으로 나와 함께 성장할 수 있을까?
-릴리스, 배포, 공개 PR처럼 "된 것 같다"가 아니라 "확인했다"가 필요한 작업에서 씁니다.
+큰 프레임워크가 아니라, 더 많은 에이전트를 돌리는 게 아니라 — 지금 작업에 맞는 하네스를 고르고, 없으면 작은 걸 만들고, 시간이 지나면서 하네스 묶음이 조금씩 나아지도록.
-### `/tink:frog` / `$tink:frog`
+---
-거의 쓰지 않거나 겹치거나 너무 무거운 하네스를 정리 후보로 제안합니다. 사용자 승인 없이는 삭제하지 않습니다.
+<details>
+<summary><strong>명령 레퍼런스</strong></summary>
-### `/tink:weave` / `$tink:weave`
+Claude Code에서는 `/tink:*`, Codex에서는 `$tink:*`을 씁니다. 예전 `$tink cast` 형식도 호환됩니다.
-실제 실패, 반복 사용, 사용자 수정 내용을 바탕으로 하네스를 조금 더 정확하게 고칩니다. 필요한 경우 `.tink/rules/`의 rule graph나 opt-in hook guard 후보로 승격합니다.
+| 명령 | 하는 일 |
+|---|---|
+| `/tink:cast` | 작업을 읽고, 하네스를 고르거나 초안을 만들고, `.tink/current/`를 만든 뒤 첫 안전한 단계 시작 |
+| `/tink:deep-cast` | `cast`와 동일하지만 구조화 인터뷰(deep 모드)를 항상 실행 — 기본 `cast_mode` 설정은 변경하지 않음 |
+| `/tink:verify` | `contract.json`에 적힌 검증을 실행하고 증거를 남김 — "된 것 같다"가 아니라 "확인했다" |
+| `/tink:frog` | 거의 쓰지 않거나 겹치거나 너무 무거운 하네스를 정리 후보로 제안 — 승인 없이는 삭제 안 함 |
+| `/tink:weave` | 실제 실패·반복 사용·수정 내용으로 하네스를 조금 더 정확하게 고침 — 승인 후 저장 |
+| `/tink:setup` | 언어, 설치 범위, git 추적, hook 정책 설정 |
+| `/tink:list` | 사용 가능한 하네스와 사용 신호 확인 |
+| `/tink:update` | 설치 출처를 확인하고 안전한 업데이트 안내 |
-### 기타
+**cast 상세:** 더 크거나 모호한 작업에서 `cast`는 생각 단계를 파일로 드러내는 하네스를 고를 수 있습니다. 모호한 아이디어는 `requirements-interview`, 큰 계획은 `plan-consensus`, 긴 실행은 `goal-checkpoint`, 안전한 인수인계는 `delegation-brief`. 특화 하네스(`issue-triage`, `bug-diagnosis-loop`, `review-two-axis`, `decision-map`, `architecture-deepening`)도 모두 `cast`가 고르는 하네스이며, 별도 명령이 아닙니다.
-- `/tink:setup` / `$tink:setup`: 언어, 설치 범위, git 추적, hook 정책 설정
-- `/tink:list` / `$tink:list`: 사용 가능한 하네스와 사용 신호 확인
-- `/tink:update` / `$tink:update`: 설치 출처를 확인하고 안전한 업데이트 안내
+</details>
-## 작동 방식
+<details>
+<summary><strong>작동 방식</strong></summary>
 Tink가 아는 모든 것은 직접 읽고, diff 보고, 지울 수 있는 평범한 파일입니다.
@@ -226,11 +175,9 @@ Tink가 아는 모든 것은 직접 읽고, diff 보고, 지울 수 있는 평
 이 전부를 움직이는 원칙은 세 가지입니다.
-1. **일반 작업에는 하네스가 필요 없습니다.** 평범한 코드 변경·리뷰·문서 작업은 기본 절차(계획 → 단계 → 검증 증거)만으로 진행합니다. 하네스는 특화된 절차가 실제로 결과를 바꿀 때만 로드됩니다 — 출시 안전판, 목표 체크포인트, 계획 비평, 요구사항 인터뷰, 이슈 정리, 어려운 버그 진단 루프, 두 축 리뷰, decision map, architecture deepening, 도메인 워크플로.
-2. **제안만 합니다.** 대시보드·`frog`·`weave`는 실제 사용 신호로 제안을 준비할 뿐입니다. 재사용되는 것(하네스, 메모리, 삭제)은 반드시 별도 명시 승인을 거칩니다. 오늘 실행의 승인이 미래 실행이 물려받을 변경을 허가하지 않습니다.
-3. **느낌이 아니라 증거.** 실행 기록, 실패한 체크, evidence summary card, friction 이벤트가 무엇을 개선하고(`weave`), 초안에서 하네스로 승격하고, 정리할지(`frog`)를 결정합니다. 증거가 약하면 삭제가 아니라 유지·관찰이 기본입니다.
-대시보드는 이 파일들로 만든 정적 로컬 페이지입니다. harness health summary가 사용량, 실패한 체크, run review 카드, ROI 힌트, weave/frog 후보를 보여줍니다. 서버, 파일 감시, hidden cache, public `tink index` 명령, replay 명령은 없습니다.
+1. **일반 작업에는 하네스가 필요 없습니다.** 평범한 코드 변경·리뷰·문서 작업은 기본 절차(계획 → 단계 → 검증 증거)만으로 진행합니다. 하네스는 특화된 절차가 실제로 결과를 바꿀 때만 로드됩니다.
+2. **제안만 합니다.** 대시보드·`frog`·`weave`는 실제 사용 신호로 제안을 준비할 뿐입니다. 재사용되는 것은 반드시 별도 명시 승인을 거칩니다. 오늘 실행의 승인이 미래 실행이 물려받을 변경을 허가하지 않습니다.
+3. **느낌이 아니라 증거.** 실행 기록, 실패한 체크, evidence summary card, friction 이벤트가 무엇을 개선하고(`weave`), 승격하고, 정리할지(`frog`)를 결정합니다. 증거가 약하면 삭제가 아니라 유지·관찰이 기본입니다.
 <details>
 <summary><strong>설계 문서 색인</strong> — 기여자용 세부 내용</summary>
@@ -240,16 +187,52 @@ Tink가 아는 모든 것은 직접 읽고, diff 보고, 지울 수 있는 평
 - 하네스 건강 요약: `docs/harness-lifecycle-signals.ko.md`, `docs/harness-lifecycle-signals.md`
 - 외부 context 안전: `docs/mcp-safe-profile.md`, `docs/external-context-policy.md`
 - `.tink/current/` 상태 읽기: `docs/work-state.ko.md`, `docs/work-state.md`
-- GEO 노출도 벤치마크: `docs/geobench.md` · spec: `geobench/tink-harness.yaml`
 - 업데이트 안정화: `docs/phase-5-update-confidence.ko.md`, `docs/phase-5-update-confidence.md`
-- Context 효율: `docs/context-budget-ledger.ko.md`, `docs/context-budget-ledger.md`, `docs/context-metrics-evaluator.ko.md`, `docs/context-metrics-evaluator.md`, `docs/context-run-history-rollup.ko.md`, `docs/context-run-history-rollup.md`, `docs/context-threshold-status.ko.md`, `docs/context-threshold-status.md`, `docs/context-run-record-policy.ko.md`, `docs/context-run-record-policy.md`
-- 남은 작업 단위: `docs/planned-work-units.ko.md`, `docs/planned-work-units.md` · 로드맵·아이디어 점검: `docs/tink-idea-implementation-plan.ko.md`
+- Context 효율: `docs/context-budget-ledger.ko.md`, `docs/context-budget-ledger.md` 외 `docs/`
+- 남은 작업 단위: `docs/planned-work-units.ko.md`, `docs/planned-work-units.md`
 </details>
+</details>
+<details>
+<summary><strong>업데이트</strong></summary>
+**Claude Code 플러그인:**
+```text
+/plugin marketplace update tink-harness
+/plugin update tink@tink-harness
+/reload-plugins
+```
-## 계획된 작업 단위
+최신 버전을 못 찾으면 재설치:
-남은 계획은 번호가 붙은 단계보다 작업 단위 이름으로 관리합니다. 전체 목록은 `docs/planned-work-units.ko.md` 또는 `docs/planned-work-units.md`에 있으며, 세부 문서는 검증 증거 세분화, 외부 컨텍스트 정책, 메모리 결정 계층, 컨텍스트 변화 리뷰, 업데이트 진단으로 나누어 둡니다. 하네스 생애주기 신호는 이제 기본 JSON 요약과 정적 HTML 리포트까지 구현되어 별도 문서에서 관리합니다.
+```text
+/plugin uninstall tink@tink-harness
+/plugin install tink@tink-harness
+```
+**스탠드얼론 (Claude Code 또는 Codex):**
+```bash
+npx tink-harness@latest update
+```
+업데이트는 질문 하나 — 어떤 agent surface를 갱신할지 — 만 묻고 나머지는 자동으로 처리합니다. 언어·설치 범위·git 정책은 설치 때 선택한 값을 그대로 재사용하며, `.tink` 커밋 안 함을 선택했다면 업데이트가 `.gitignore`를 절대 건드리지 않습니다. Tink가 관리하는 파일은 항상 최신으로 덮어쓰고, 사용자가 수정한 하네스·메모리·설정과 `.tink/maintenance/`의 모든 기록은 보존합니다.
+`CODEX_HOME`을 지정하지 않으면 Windows에서는 `%USERPROFILE%\.codex`, macOS/Linux에서는 `~/.codex`에 설치됩니다.
+**고급 옵션** (대화형 마법사에서 표시):
+- `Preview only (--dry-run)`: 실제 파일을 바꾸기 전에 무엇을 쓰고·보존하고·지울지 먼저 확인.
+- `Overwrite user-modified files (--force)`: 설치가 꼬였을 때만. 일반 업데이트는 사용자가 고친 파일을 보존합니다.
+- `Clean Codex picker (--clean-codex-picker)`: Codex 전용으로 전환할 때 중복 항목 제거. Claude Code+Codex 혼합 설치에는 표시 안 됨.
+검증: `docs/update-verification-recipe.ko.md`. 문제 해결: `docs/update-troubleshooting.ko.md`.
+</details>
+---
 ## Tink가 아닌 것
@@ -257,7 +240,7 @@ Tink는 코딩 에이전트, 워크플로 엔진, 멀티 에이전트 런타임,
 ## 기여
-이슈와 PR을 환영합니다. [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요 — 핵심은 `npm test` 실행, 명령 템플릿 3벌 동기화, [문제/해결/검증] 구조의 설명입니다.
+이슈와 PR을 환영합니다. [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요 — 핵심은 `npm test` 실행, 명령 템플릿 3벌 동기화, 문제/해결/검증 구조의 설명입니다.
 Tink가 시간을 아껴줬다면 ⭐ 하나가 다른 개발자들이 Tink를 찾는 데 큰 도움이 됩니다.