tink-harness 1.2.1 → 1.3.0

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -2,81 +2,128 @@
 
 All notable changes to Tink are tracked here.
 
-## [Unreleased]
-
-No unreleased changes yet.
-
-
-## [1.2.1] - 2026-06-07
-
-### Changed
-
-- README now shows a GitHub Release badge and an explicit latest release line so the repository front page reflects the current release even when badge caches lag.
-- Published the README/release-display patch so GitHub source and the npm package stay aligned after the v1.2.0 publish.
-
-
-## [1.2.0] - 2026-06-07
-
-### Added
-
-- Codex autocomplete aliases matching the Claude Code command surface: `$tink:cast`, `$tink:verify`, `$tink:list`, `$tink:frog`, `$tink:weave`, `$tink:setup`, and `$tink:update`.
-- Contract-first context artifacts for non-trivial runs: `context-pack.md`, `context-map.json`, and `excluded-context.md`.
-- Repo Signal fixtures and documentation so `/tink:cast` can select relevant tests, schemas, sync partners, and verification hints without adding a new `tink index` command.
-- Verify Runner schema and fixtures for `.tink/current/verification.json`, including pass, fail, blocked, skipped, final report, notes summary, and maintenance signal behavior.
-- MCP Safe Profile documentation and external-context profile schema support for sources such as Figma, GitHub, official docs, dashboards, API responses, screenshots, attachments, and runbooks.
-- Compatibility policy documenting that new Tink work must support Claude Code and Codex, plus macOS and Windows.
-- PR history draft for this release in `docs/pr/2026-06-07-v1.2.0.md`.
-
-### Changed
-
-- Codex documentation and installer next-step guidance now prefer `$tink:*` spelling while keeping legacy `$tink <action>` prompts compatible.
-- Project guidance now uses lower-case `templates/codex/skills/` and the actual `.claude/` / `.claude-plugin/` paths so Mac/Linux case-sensitive filesystems match the documented structure.
-- Codex skill display is focused on action aliases only; shared Codex rules now live in non-visible `tink-core/RULES.md`.
-- `/tink:cast` records included, excluded, and external context more explicitly, including sensitivity, confidence, source handles, and verification hints.
-- `/tink:verify` now uses one portable runner model for Claude Code `/tink:verify` and Codex `$tink:verify`.
-- README and Korean README now explain the 1.2.0 release highlights and point to compatibility, repo signal, and MCP Safe Profile docs.
-
-### Fixed
-
-- Existing Codex installs that still have the old visible `skills/tink/SKILL.md` directory are cleaned up during install/update when it is recognized as the legacy Tink skill.
-
-### Removed
-
-- Removed the old installable Codex `tink` skill surface so the picker no longer shows duplicate or awkward `Tink: Tink` entries.
-
-
-## [1.1.1] - 2026-05-26
-
-### Added
-
-- Small Writ-inspired rule selection: rule graph nodes now distinguish `mandatory` and `retrievable` guidance with phase, budget cost, and keyword metadata.
-- Current-run `session.json` schema so Tink can record `loaded_rule_ids_by_phase` and avoid repeating the same rule guidance during a run.
-- Verification evidence and friction templates: `/tink:verify` now documents `.tink/current/verification.json` evidence and `.tink/maintenance/friction.jsonl` failure signals.
-
-### Changed
-
-- `/tink:cast`, `/tink:verify`, and `/tink:weave` now describe the smaller rule-loading path: mandatory first, keyword retrieval second, phase dedupe, compact evidence, then repeated-friction promotion through weave.
-- README and graph docs now explain the compact rule graph, verification evidence, and friction signal flow.
-
-
-## [1.1.0] - 2026-05-26
-
-### Added
-
-- Contract-first run model: `/tink:cast` now writes `.tink/current/contract.json` for non-trivial runs so task type, risks, success conditions, forbidden actions, verification, and evidence are structured before harness bodies are loaded.
-- `/tink:verify` command: runs the checks promised in the current contract, records compact evidence, and feeds failed checks into weave as `check_failed` signals.
-- Repo-local rule graph templates in `.tink/rules/index.json`, plus `contract.schema.json`, so Tink can select relevant harnesses, checks, and opt-in guard candidates without loading large Markdown by default.
-- Opt-in guard templates for repeated failures that should become real Claude Code hook boundaries after explicit approval.
-- Documentation for graph contracts, verification, and guard promotion.
-
-### Changed
-
-- `/tink:weave` can now classify improvements as harness edits, rule graph updates, or opt-in hook guard candidates.
-- Hook recommendation script now uses readable multilingual messages and keeps the default hook advisory-only.
-
-### Planned
-
-- Layered scope model: merge `global` (`~/.tink/`) + `repo` (`.tink/`) + `local` (`.tink/local/` or `.tink/settings.local.json`) following the Claude Code settings pattern. Tracked separately.
+## [Unreleased]
+
+No unreleased changes yet.
+
+
+## [1.3.0] - 2026-06-08
+
+### Added
+
+- Context Budget Ledger fields for `context-map.json` entries: `role`, `cost`, `reuse_signal`, `verification_link`, `staleness`, and `evidence_kind`.
+- `context-map.json.efficiency_metrics` example shape for recording six context-efficiency scores with basis, confidence, evidence refs, and limits.
+- Current-run fixture examples that connect selected context to verification links and mark avoid-next-time exclusions.
+- Repo signal `context_budget_policy` fixture guidance for scoring selected Context Graph Lite candidates without adding a public `tink index` command.
+- Korean-first Context Budget Ledger documentation with an English companion.
+- Korean context-engineering efficiency HTML explainer for the current operating model and expected improvement ranges.
+- Korean PR history draft for the Context Budget Ledger work in `docs/pr/2026-06-08-context-budget-ledger.ko.md`.
+
+### Changed
+
+- `/tink:cast` and `$tink:cast` guidance now asks context artifacts to record role, cost, reuse signal, verification link, staleness, and evidence kind when useful.
+- Work State Guide now explains how to read Context Budget Ledger fields.
+- README and Korean README now link to the Context Budget Ledger docs without expanding the main body.
+
+
+## [1.2.2] - 2026-06-08
+
+### Added
+
+- Work-unit docs for the remaining roadmap: verification evidence details, external context policy, harness lifecycle signals, memory decision layers, context change review, and update diagnosis.
+- External context policy and harness lifecycle schemas, plus fixtures for context changes, policy examples, and lifecycle recommendations.
+- Installed memory decision folders for approved, candidate, rejected, and evidence-backed memory.
+- Work State Guide explaining how to read `.tink/current/contract.json`, `context-pack.md`, `context-map.json`, `excluded-context.md`, `verification.json`, and `notes.md`.
+- Phase 5 Update Confidence plan for safer existing-user update flows.
+- Korean companion docs for the Work State Guide and Phase 5 Update Confidence plan.
+- Korean implementation audit and roadmap for the larger Tink idea set in `docs/tink-idea-implementation-plan.ko.md`.
+- HTML summary of v1.2.0 improvements in `docs/pr/2026-06-07-v1.2.0-improvements.html`.
+- Existing-user Codex update smoke test covering legacy `skills/tink/SKILL.md` cleanup, refreshed action skills, new schemas, and preserved user-modified schema files.
+- Codex `$tink:cast` approval protocol and compact approval request examples so non-trivial runs ask before creating run state, loading harnesses, editing files, or running commands.
+- Update Result Summary output for `tink-harness update`, including changed paths, preserved user-modified files, removed legacy paths, install locations, and the next command.
+- Existing user-modified `.tink/config.json` is now fully preserved during update unless `--force` is used.
+- Update troubleshooting docs in English and Korean, linked from README without expanding the README body.
+- Update verification recipe docs in English and Korean, linked from README as a short post-update checklist.
+- Context Graph Lite fixture rules for cast context selection, including changed-path-to-context coverage without adding a public `tink index` command.
+- Korean companion doc for Repo Signals and Context Graph Lite.
+- Current-run context artifact examples now show how `context_graph_rule` signals explain selected related files and excluded public graph indexing.
+- Korean PR history draft for the Phase 5/6 follow-up work in `docs/pr/2026-06-07-phase-5-6-follow-up.ko.md`.
+
+### Changed
+
+- README and Korean README now link to the work-state guide, Phase 5 update-confidence plan, update verification recipe, and update troubleshooting docs.
+
+
+## [1.2.1] - 2026-06-07
+
+### Changed
+
+- README now shows a GitHub Release badge and an explicit latest release line so the repository front page reflects the current release even when badge caches lag.
+- Published the README/release-display patch so GitHub source and the npm package stay aligned after the v1.2.0 publish.
+
+
+## [1.2.0] - 2026-06-07
+
+### Added
+
+- Codex autocomplete aliases matching the Claude Code command surface: `$tink:cast`, `$tink:verify`, `$tink:list`, `$tink:frog`, `$tink:weave`, `$tink:setup`, and `$tink:update`.
+- Contract-first context artifacts for non-trivial runs: `context-pack.md`, `context-map.json`, and `excluded-context.md`.
+- Repo Signal fixtures and documentation so `/tink:cast` can select relevant tests, schemas, sync partners, and verification hints without adding a new `tink index` command.
+- Verify Runner schema and fixtures for `.tink/current/verification.json`, including pass, fail, blocked, skipped, final report, notes summary, and maintenance signal behavior.
+- MCP Safe Profile documentation and external-context profile schema support for sources such as Figma, GitHub, official docs, dashboards, API responses, screenshots, attachments, and runbooks.
+- Compatibility policy documenting that new Tink work must support Claude Code and Codex, plus macOS and Windows.
+- PR history draft for this release in `docs/pr/2026-06-07-v1.2.0.md`.
+
+### Changed
+
+- Codex documentation and installer next-step guidance now prefer `$tink:*` spelling while keeping legacy `$tink <action>` prompts compatible.
+- Project guidance now uses lower-case `templates/codex/skills/` and the actual `.claude/` / `.claude-plugin/` paths so Mac/Linux case-sensitive filesystems match the documented structure.
+- Codex skill display is focused on action aliases only; shared Codex rules now live in non-visible `tink-core/RULES.md`.
+- `/tink:cast` records included, excluded, and external context more explicitly, including sensitivity, confidence, source handles, and verification hints.
+- `/tink:verify` now uses one portable runner model for Claude Code `/tink:verify` and Codex `$tink:verify`.
+- README and Korean README now explain the 1.2.0 release highlights and point to compatibility, repo signal, and MCP Safe Profile docs.
+
+### Fixed
+
+- Existing Codex installs that still have the old visible `skills/tink/SKILL.md` directory are cleaned up during install/update when it is recognized as the legacy Tink skill.
+
+### Removed
+
+- Removed the old installable Codex `tink` skill surface so the picker no longer shows duplicate or awkward `Tink: Tink` entries.
+
+
+## [1.1.1] - 2026-05-26
+
+### Added
+
+- Small Writ-inspired rule selection: rule graph nodes now distinguish `mandatory` and `retrievable` guidance with phase, budget cost, and keyword metadata.
+- Current-run `session.json` schema so Tink can record `loaded_rule_ids_by_phase` and avoid repeating the same rule guidance during a run.
+- Verification evidence and friction templates: `/tink:verify` now documents `.tink/current/verification.json` evidence and `.tink/maintenance/friction.jsonl` failure signals.
+
+### Changed
+
+- `/tink:cast`, `/tink:verify`, and `/tink:weave` now describe the smaller rule-loading path: mandatory first, keyword retrieval second, phase dedupe, compact evidence, then repeated-friction promotion through weave.
+- README and graph docs now explain the compact rule graph, verification evidence, and friction signal flow.
+
+
+## [1.1.0] - 2026-05-26
+
+### Added
+
+- Contract-first run model: `/tink:cast` now writes `.tink/current/contract.json` for non-trivial runs so task type, risks, success conditions, forbidden actions, verification, and evidence are structured before harness bodies are loaded.
+- `/tink:verify` command: runs the checks promised in the current contract, records compact evidence, and feeds failed checks into weave as `check_failed` signals.
+- Repo-local rule graph templates in `.tink/rules/index.json`, plus `contract.schema.json`, so Tink can select relevant harnesses, checks, and opt-in guard candidates without loading large Markdown by default.
+- Opt-in guard templates for repeated failures that should become real Claude Code hook boundaries after explicit approval.
+- Documentation for graph contracts, verification, and guard promotion.
+
+### Changed
+
+- `/tink:weave` can now classify improvements as harness edits, rule graph updates, or opt-in hook guard candidates.
+- Hook recommendation script now uses readable multilingual messages and keeps the default hook advisory-only.
+
+### Planned
+
+- Layered scope model: merge `global` (`~/.tink/`) + `repo` (`.tink/`) + `local` (`.tink/local/` or `.tink/settings.local.json`) following the Claude Code settings pattern. Tracked separately.
 
 
 ## [1.0.0] - 2026-05-25

package/README.ko.md

@@ -1,122 +1,131 @@
-<p align="center">
-  <img src=".github/assets/hero.gif" alt="Tink Hero Banner" width="100%">
-</p>
-
-# Tink
-
-Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
-
-Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
-
-**최신 릴리스:** v1.2.1 — Codex 스킬 표면 정리, context 기록, portable verification, 외부 context 안전 기준.
-
-[English](README.md) · **한국어**
-
----
-
-## 왜 만들었나
-
-새로운 AI 코딩 하네스와 워크플로는 계속 늘어납니다. 좋은 것도 많지만, 여러 개를 섞다 보면 환경이 무거워지고 매번 다시 정리해야 합니다.
-
-Tink는 큰 프레임워크가 아닙니다. Claude Code나 Codex가 지금 작업에 필요한 절차만 고르고, 없으면 작은 임시 하네스를 만들고, 반복되는 실수만 승인 후 재사용 지식으로 남기도록 돕습니다.
-
-## 설치
-
-Claude Code 플러그인:
-
-```text
-/plugin marketplace add dotoricode/tink-harness
-/plugin install tink@tink-harness
-/reload-plugins
-/tink:setup
-```
-
-Standalone / Codex 호환 설치:
-
-```bash
-npx tink-harness@latest install
-```
-
-설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있습니다. Codex에서는 `$tink:cast <task>`로 시작합니다.
-
-## 업데이트
-
-Claude Code 플러그인:
-
-```text
-/plugin marketplace update tink-harness
-/plugin update tink@tink-harness
-/reload-plugins
-```
-
-Standalone / Codex:
-
-```bash
-npx tink-harness@latest update
-```
-
-## 1.2.0에서 달라진 점
-
-이번 릴리스는 Tink를 Claude Code와 Codex에서 같은 하네스 레이어로 쓰기 쉽게 정리합니다.
-
-- Codex에는 하나의 넓은 `tink` 스킬 대신 `$tink:cast`, `$tink:verify` 같은 action skill만 보이도록 설치됩니다.
-- 비단순 작업은 `context-pack.md`, `context-map.json`, `excluded-context.md`로 어떤 context를 썼고 뺐는지 남깁니다.
-- Repo Signal은 새 `tink index` 명령을 만들지 않고도 관련 테스트, 스키마, 동기화 파일, 검증 힌트를 고르는 데 쓰입니다.
-- `/tink:verify`와 `$tink:verify`는 같은 Verify Runner 모델을 쓰며 `.tink/current/verification.json`에 검증 증거를 남깁니다.
-- 외부 context는 MCP Safe Profile을 따릅니다. 가장 작은 source handle만 남기고, 신뢰도와 민감도를 표시하며, 위험하거나 너무 넓은 context는 `excluded-context.md`에 따로 기록합니다.
-
-## 명령
-
-Claude Code에서는 `/tink:*`, Codex에서는 `$tink:*`을 씁니다. 예전 `$tink cast` 형식도 호환되지만, 기본 안내와 자동완성 표면은 `$tink:*`입니다.
-
-### `/tink:cast` / `$tink:cast`
-
-작업을 읽고, 필요한 하네스만 고르고, `.tink/current/` 실행 상태를 만든 뒤 첫 번째 안전한 단계를 시작합니다.
-
-Tink는 이제 비단순 작업에 대해 `.tink/current/contract.json`도 만듭니다. 이 파일에는 작업 종류, 위험, 성공 조건, 금지 사항, 검증 명령이 들어갑니다.
-
-### `/tink:verify` / `$tink:verify`
-
-`contract.json`에 적힌 검증을 실제로 실행하고 증거를 남깁니다.
-
-릴리스, 배포, 공개 PR처럼 "된 것 같다"가 아니라 "확인했다"가 필요한 작업에서 씁니다.
-
-### `/tink:frog` / `$tink:frog`
-
-거의 쓰지 않거나 겹치거나 너무 무거운 하네스를 정리 후보로 제안합니다. 사용자 승인 없이는 삭제하지 않습니다.
-
-### `/tink:weave` / `$tink:weave`
-
-실제 실패, 반복 사용, 사용자 수정 내용을 바탕으로 하네스를 조금 더 정확하게 고칩니다. 필요한 경우 `.tink/rules/`의 rule graph나 opt-in hook guard 후보로 승격합니다.
-
-### 기타
-
-- `/tink:setup` / `$tink:setup`: 언어, 설치 범위, git 추적, hook 정책 설정
-- `/tink:list` / `$tink:list`: 사용 가능한 하네스와 사용 신호 확인
-- `/tink:update` / `$tink:update`: 설치 출처를 확인하고 안전한 업데이트 안내
-
-## 작동 방식
-
-Tink는 직접 볼 수 있는 파일을 씁니다.
-
-- `.tink/harnesses/`: 재사용 가능한 작업 하네스
-- `.tink/rules/`: 계약 내용에 맞춰 필요한 하네스, 체크, guard 후보만 고르는 작은 rule graph
-- `.tink/schemas/`: `contract.json` 같은 구조화 파일의 스키마
-- `.tink/current/`: 현재 실행 상태
-- `.tink/runs/`: 완료, 중단, 취소, 교체된 실행 기록
-- `.tink/maintenance/`: 검증, friction, weave 신호 기록
-- `.tink/memory/`: 승인된 실수, 선호, 교훈
-
-Rule graph는 작게 유지합니다. Tink는 먼저 필수 규칙을 고르고, 작업 사실이나 keyword에 맞는 선택 규칙만 가져오며, phase별로 이미 읽은 rule id를 기록해 같은 안내를 반복하지 않습니다.
-
-설계 메모는 `docs/`에 둡니다. 기본 호환성 기준은 `docs/compatibility-policy.md`에 있으며, 새 작업은 Claude Code와 Codex, macOS와 Windows를 함께 고려해야 합니다. Repo Signal 동작은 `docs/repo-signals.md`에 정리되어 있고, 외부 context 안전 기준은 `docs/mcp-safe-profile.md`에 정리되어 있습니다.
-
-중요한 원칙은 승인입니다. 현재 작업을 진행하는 승인과, 미래에도 재사용될 상태를 저장하는 승인은 별개입니다. 새 하네스, 메모리, rule graph, hook guard 저장은 항상 별도 승인이 필요합니다.
-
-## Tink가 아닌 것
-
-Tink는 코딩 에이전트, 워크플로 엔진, 멀티 에이전트 런타임, 프롬프트 라이브러리가 아닙니다. Claude Code와 Codex 위에 얹는 작은 하네스 레이어입니다.
-
-## 라이선스
-
-MIT
+<p align="center">
+  <img src=".github/assets/hero.gif" alt="Tink Hero Banner" width="100%">
+</p>
+
+# Tink
+
+Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
+
+Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
+
+**최신 릴리스:** v1.3.0 — context 효율을 점수화하고 선택한 context를 검증과 연결하는 Context Budget Ledger 기반.
+
+[English](README.md) · **한국어**
+
+---
+
+## 왜 만들었나
+
+새로운 AI 코딩 하네스와 워크플로는 계속 늘어납니다. 좋은 것도 많지만, 여러 개를 섞다 보면 환경이 무거워지고 매번 다시 정리해야 합니다.
+
+Tink는 큰 프레임워크가 아닙니다. Claude Code나 Codex가 지금 작업에 필요한 절차만 고르고, 없으면 작은 임시 하네스를 만들고, 반복되는 실수만 승인 후 재사용 지식으로 남기도록 돕습니다.
+
+## 설치
+
+Claude Code 플러그인:
+
+```text
+/plugin marketplace add dotoricode/tink-harness
+/plugin install tink@tink-harness
+/reload-plugins
+/tink:setup
+```
+
+Standalone / Codex 호환 설치:
+
+```bash
+npx tink-harness@latest install
+```
+
+설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있습니다. Codex에서는 `$tink:cast <task>`로 시작합니다.
+
+## 업데이트
+
+Claude Code 플러그인:
+
+```text
+/plugin marketplace update tink-harness
+/plugin update tink@tink-harness
+/reload-plugins
+```
+
+Standalone / Codex:
+
+```bash
+npx tink-harness@latest update
+```
+
+업데이트가 정상인지 빠르게 확인하려면 `docs/update-verification-recipe.ko.md` 또는 `docs/update-verification-recipe.md`를 확인하세요.
+
+업데이트 후 Codex skill, schema, Windows 경고가 이상해 보이면 `docs/update-troubleshooting.ko.md` 또는 `docs/update-troubleshooting.md`를 확인하세요.
+
+## 1.2.0에서 달라진 점
+
+이번 릴리스는 Tink를 Claude Code와 Codex에서 같은 하네스 레이어로 쓰기 쉽게 정리합니다.
+
+- Codex에는 하나의 넓은 `tink` 스킬 대신 `$tink:cast`, `$tink:verify` 같은 action skill만 보이도록 설치됩니다.
+- 비단순 작업은 `context-pack.md`, `context-map.json`, `excluded-context.md`로 어떤 context를 썼고 뺐는지 남깁니다.
+- Repo Signal과 Context Graph Lite는 새 `tink index` 명령을 만들지 않고도 관련 테스트, 스키마, 동기화 파일, 검증 힌트를 고르는 데 쓰입니다.
+- context 효율 점수화를 위한 Context Budget Ledger는 `docs/context-budget-ledger.ko.md`와 `docs/context-budget-ledger.md`에서 확인할 수 있습니다.
+- `/tink:verify`와 `$tink:verify`는 같은 Verify Runner 모델을 쓰며 `.tink/current/verification.json`에 검증 증거를 남깁니다.
+- 외부 context는 MCP Safe Profile을 따릅니다. 가장 작은 source handle만 남기고, 신뢰도와 민감도를 표시하며, 위험하거나 너무 넓은 context는 `excluded-context.md`에 따로 기록합니다.
+
+## 명령
+
+Claude Code에서는 `/tink:*`, Codex에서는 `$tink:*`을 씁니다. 예전 `$tink cast` 형식도 호환되지만, 기본 안내와 자동완성 표면은 `$tink:*`입니다.
+
+### `/tink:cast` / `$tink:cast`
+
+작업을 읽고, 필요한 하네스만 고르고, `.tink/current/` 실행 상태를 만든 뒤 첫 번째 안전한 단계를 시작합니다.
+
+Tink는 이제 비단순 작업에 대해 `.tink/current/contract.json`도 만듭니다. 이 파일에는 작업 종류, 위험, 성공 조건, 금지 사항, 검증 명령이 들어갑니다.
+
+### `/tink:verify` / `$tink:verify`
+
+`contract.json`에 적힌 검증을 실제로 실행하고 증거를 남깁니다.
+
+릴리스, 배포, 공개 PR처럼 "된 것 같다"가 아니라 "확인했다"가 필요한 작업에서 씁니다.
+
+### `/tink:frog` / `$tink:frog`
+
+거의 쓰지 않거나 겹치거나 너무 무거운 하네스를 정리 후보로 제안합니다. 사용자 승인 없이는 삭제하지 않습니다.
+
+### `/tink:weave` / `$tink:weave`
+
+실제 실패, 반복 사용, 사용자 수정 내용을 바탕으로 하네스를 조금 더 정확하게 고칩니다. 필요한 경우 `.tink/rules/`의 rule graph나 opt-in hook guard 후보로 승격합니다.
+
+### 기타
+
+- `/tink:setup` / `$tink:setup`: 언어, 설치 범위, git 추적, hook 정책 설정
+- `/tink:list` / `$tink:list`: 사용 가능한 하네스와 사용 신호 확인
+- `/tink:update` / `$tink:update`: 설치 출처를 확인하고 안전한 업데이트 안내
+
+## 작동 방식
+
+Tink는 직접 볼 수 있는 파일을 씁니다.
+
+- `.tink/harnesses/`: 재사용 가능한 작업 하네스
+- `.tink/rules/`: 계약 내용에 맞춰 필요한 하네스, 체크, guard 후보만 고르는 작은 rule graph
+- `.tink/schemas/`: `contract.json` 같은 구조화 파일의 스키마
+- `.tink/current/`: 현재 실행 상태
+- `.tink/runs/`: 완료, 중단, 취소, 교체된 실행 기록
+- `.tink/maintenance/`: 검증, friction, weave 신호 기록
+- `.tink/memory/`: 승인된 실수, 선호, 교훈
+
+Rule graph는 작게 유지합니다. Tink는 먼저 필수 규칙을 고르고, 작업 사실이나 keyword에 맞는 선택 규칙만 가져오며, phase별로 이미 읽은 rule id를 기록해 같은 안내를 반복하지 않습니다.
+
+설계 메모는 `docs/`에 둡니다. 기본 호환성 기준은 `docs/compatibility-policy.md`에 있으며, 새 작업은 Claude Code와 Codex, macOS와 Windows를 함께 고려해야 합니다. Repo Signal 동작은 `docs/repo-signals.ko.md` 또는 `docs/repo-signals.md`에 정리되어 있고, 외부 context 안전 기준은 `docs/mcp-safe-profile.md`에 정리되어 있습니다. `.tink/current/` 상태를 읽거나 검토할 때는 `docs/work-state.ko.md` 또는 `docs/work-state.md`부터 보면 됩니다. 다음 업데이트 안정화 계획은 `docs/phase-5-update-confidence.ko.md`와 `docs/phase-5-update-confidence.md`에 정리되어 있습니다. 더 큰 아이디어 구현 점검과 로드맵은 `docs/tink-idea-implementation-plan.ko.md`에 정리되어 있습니다.
+
+중요한 원칙은 승인입니다. 현재 작업을 진행하는 승인과, 미래에도 재사용될 상태를 저장하는 승인은 별개입니다. 새 하네스, 메모리, rule graph, hook guard 저장은 항상 별도 승인이 필요합니다.
+
+## 계획된 작업 단위
+
+남은 계획은 번호가 붙은 단계보다 작업 단위 이름으로 관리합니다. 전체 목록은 `docs/planned-work-units.ko.md` 또는 `docs/planned-work-units.md`에 있으며, 세부 문서는 검증 증거 세분화, 외부 컨텍스트 정책, 하네스 생애주기 신호, 메모리 결정 계층, 컨텍스트 변화 리뷰, 업데이트 진단으로 나누어 둡니다.
+
+## Tink가 아닌 것
+
+Tink는 코딩 에이전트, 워크플로 엔진, 멀티 에이전트 런타임, 프롬프트 라이브러리가 아닙니다. Claude Code와 Codex 위에 얹는 작은 하네스 레이어입니다.
+
+## 라이선스
+
+MIT