tink-harness 1.0.0 → 1.1.1

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
-{
-  "name": "tink",
-  "description": "A small harness layer for Claude Code.",
-  "version": "1.0.0",
-  "author": {
-    "name": "dotori"
-  }
-}
+{
+  "name": "tink",
+  "description": "A small harness layer for Claude Code.",
+  "version": "1.1.1",
+  "author": {
+    "name": "dotori"
+  }
+}

package/CHANGELOG.md

@@ -1,109 +1,141 @@
-# Changelog
-
-All notable changes to Tink are tracked here.
-
-## [Unreleased]
-
-### Planned (v1.1)
-
-- 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
-
-First stable release. All hardening gates passed.
-
-### Added
-
-- `pre-publish-multi-agent-verify` harness: 5-agent parallel verification harness for npm publish readiness. Agents cover install matrix, UX walkthrough, doc consistency, secret leak audit, and slash/contract coverage.
-
-### Fixed
-
-- `update` subcommand never propagated template changes to existing installs. Commands, skills, and maintenance files now always overwrite on update; harnesses, hooks, memory, and config are preserved when user-modified (respects `weave` customizations).
-- `VERSIONING.md` update command used `npx tink-harness@latest update` (npm registry form, fails before first publish). Changed to `npx github:dotoricode/tink-harness update` (GitHub form, always works).
-
-### Removed
-
-- Remaining phantom references to `context-habit-calibration` in `cast.md`, `list.md`, and `SKILL.md` (harness was merged into `harness-curation` in v0.1.5).
-
-
-## [0.1.5] - 2026-05-24
-
-### Added
-
-- `tink-feedback-apply` harness: classify user feedback about Tink into the correct layer (behavioral, UX, preference, harness procedure, or new harness) and apply the minimum viable change.
-- `/tink:list` output redesign: multi-line per harness, header field description, three categories (작업용 / 메타 / 이 저장소 전용), assessment section, and next-command suggestions.
-
-### Changed
-
-- Built-in harness `## Checks` sections replaced generic boilerplate with domain-specific checks:
-  - `research`: decision named, options compared, facts/guesses labeled, recommendation follows evidence.
-  - `review`: correctness/security/data/UX risk addressed, severity labeled, no speculative blockers.
-  - `ship`: CI checks pass or reason stated, rollback documented, artifacts listed, risks explicit.
-- `ship` Plan step 3: "Prepare notes for humans" → "Draft PR or release summary: what changed, what risks, what rollback."
-- `harness-curation` now includes context habit calibration (signals, 6 habit types, calibration procedure) as an inline section. No separate harness needed.
-- `index.json`: `harness-synthesis` and `harness-curation` classified as `kind: "meta"` to distinguish from work harnesses.
-
-### Removed
-
-- `context-habit-calibration` standalone harness. Its content is now part of `harness-curation`.
-
-
-## [0.1.4] - 2026-05-23
-
-### Added
-
-- `/tink:update` slash command: detects install source, diagnoses user-modified files, and shows the safe update command.
-- `npx tink-harness update` subcommand: data-preserving update that keeps user-modified files. Use `--force` to overwrite everything (data loss risk).
-- HARNESS.md harness catalog for fast human scanning.
-- Hard-gate behavior for `ship` harness (release/publish/deploy/PR) — runs the safety gate at initial approval, not just at the first risky step.
-
-### Changed
-
-- Default installer language now auto-detects from `LANG`/`LANGUAGE`/`LC_ALL`, falling back to English; previously hardcoded to Korean.
-- README Update section recommends `npx ... update` only. The `install --force` path is no longer documented as a user-facing option (the `--force` flag remains in the code for emergency use but is not advertised).
-- `/tink:cast` approval format uses plain language for the soft-gate review block; internal labels are kept in code/docs but not shown to the user.
-- `/tink:cast` UX overhauls: shorter prompts, fewer approval gates for trivial tasks, single consolidated approval for soft-gate cases.
-
-### Fixed
-
-- Restored the README hero image after the previous fix targeted the wrong surface.
-- Increased the installer TINK banner contrast for dark terminal themes.
-
-
-## [0.1.3]
-
-Skipped during pre-v1 sequencing.
-
-
-## [0.1.2] - 2026-05-22
-
-### Changed
-
-- Added a synthesis probe so `/tink:cast` can detect when a built-in harness is only a generic fit.
-- Made run-only draft harnesses the default path for generic-fit cases, with saving still requiring separate approval.
-- Clarified that `harness-synthesis` should handle both `no fit` and `generic fit` cases.
-
-## [0.1.1] - 2026-05-22
-
-### Added
-
-- Existing-user update instructions for Claude Code plugin installs.
-- Standalone compatibility installer refresh command using `--force`.
-- Maintenance evidence structure: approval ledger and weave queue templates.
-- Run record fields for selected, rejected, actually loaded, and maintenance evidence.
-
-### Changed
-
-- Bumped the Claude Code plugin version to make `/plugin update` detect the latest release.
-- Clarified `unknown` evidence handling for `/tink:list`.
-- Added evidence grades for `/tink:frog` and evidence handles for `/tink:weave`.
-
-## [0.1.0] - 2026-05-22
-
-### Added
-
-- Initial pre-v1 plugin shape for Tink.
-- Plugin-first `/tink:*` command surface.
-- Standalone compatibility installer.
-- Built-in harnesses, setup flow, optional hook recommendation, and visible `.tink/` state model.
+# Changelog
+
+All notable changes to Tink are tracked here.
+
+## [Unreleased]
+
+No unreleased changes yet.
+
+
+## [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
+
+First stable release. All hardening gates passed.
+
+### Added
+
+- `pre-publish-multi-agent-verify` harness: 5-agent parallel verification harness for npm publish readiness. Agents cover install matrix, UX walkthrough, doc consistency, secret leak audit, and slash/contract coverage.
+
+### Fixed
+
+- `update` subcommand never propagated template changes to existing installs. Commands, skills, and maintenance files now always overwrite on update; harnesses, hooks, memory, and config are preserved when user-modified (respects `weave` customizations).
+- `VERSIONING.md` update command used `npx tink-harness@latest update` (npm registry form, fails before first publish). Changed to `npx github:dotoricode/tink-harness update` (GitHub form, always works).
+
+### Removed
+
+- Remaining phantom references to `context-habit-calibration` in `cast.md`, `list.md`, and `SKILL.md` (harness was merged into `harness-curation` in v0.1.5).
+
+
+## [0.1.5] - 2026-05-24
+
+### Added
+
+- `tink-feedback-apply` harness: classify user feedback about Tink into the correct layer (behavioral, UX, preference, harness procedure, or new harness) and apply the minimum viable change.
+- `/tink:list` output redesign: multi-line per harness, header field description, three categories (작업용 / 메타 / 이 저장소 전용), assessment section, and next-command suggestions.
+
+### Changed
+
+- Built-in harness `## Checks` sections replaced generic boilerplate with domain-specific checks:
+  - `research`: decision named, options compared, facts/guesses labeled, recommendation follows evidence.
+  - `review`: correctness/security/data/UX risk addressed, severity labeled, no speculative blockers.
+  - `ship`: CI checks pass or reason stated, rollback documented, artifacts listed, risks explicit.
+- `ship` Plan step 3: "Prepare notes for humans" → "Draft PR or release summary: what changed, what risks, what rollback."
+- `harness-curation` now includes context habit calibration (signals, 6 habit types, calibration procedure) as an inline section. No separate harness needed.
+- `index.json`: `harness-synthesis` and `harness-curation` classified as `kind: "meta"` to distinguish from work harnesses.
+
+### Removed
+
+- `context-habit-calibration` standalone harness. Its content is now part of `harness-curation`.
+
+
+## [0.1.4] - 2026-05-23
+
+### Added
+
+- `/tink:update` slash command: detects install source, diagnoses user-modified files, and shows the safe update command.
+- `npx tink-harness update` subcommand: data-preserving update that keeps user-modified files. Use `--force` to overwrite everything (data loss risk).
+- HARNESS.md harness catalog for fast human scanning.
+- Hard-gate behavior for `ship` harness (release/publish/deploy/PR) — runs the safety gate at initial approval, not just at the first risky step.
+
+### Changed
+
+- Default installer language now auto-detects from `LANG`/`LANGUAGE`/`LC_ALL`, falling back to English; previously hardcoded to Korean.
+- README Update section recommends `npx ... update` only. The `install --force` path is no longer documented as a user-facing option (the `--force` flag remains in the code for emergency use but is not advertised).
+- `/tink:cast` approval format uses plain language for the soft-gate review block; internal labels are kept in code/docs but not shown to the user.
+- `/tink:cast` UX overhauls: shorter prompts, fewer approval gates for trivial tasks, single consolidated approval for soft-gate cases.
+
+### Fixed
+
+- Restored the README hero image after the previous fix targeted the wrong surface.
+- Increased the installer TINK banner contrast for dark terminal themes.
+
+
+## [0.1.3]
+
+Skipped during pre-v1 sequencing.
+
+
+## [0.1.2] - 2026-05-22
+
+### Changed
+
+- Added a synthesis probe so `/tink:cast` can detect when a built-in harness is only a generic fit.
+- Made run-only draft harnesses the default path for generic-fit cases, with saving still requiring separate approval.
+- Clarified that `harness-synthesis` should handle both `no fit` and `generic fit` cases.
+
+## [0.1.1] - 2026-05-22
+
+### Added
+
+- Existing-user update instructions for Claude Code plugin installs.
+- Standalone compatibility installer refresh command using `--force`.
+- Maintenance evidence structure: approval ledger and weave queue templates.
+- Run record fields for selected, rejected, actually loaded, and maintenance evidence.
+
+### Changed
+
+- Bumped the Claude Code plugin version to make `/plugin update` detect the latest release.
+- Clarified `unknown` evidence handling for `/tink:list`.
+- Added evidence grades for `/tink:frog` and evidence handles for `/tink:weave`.
+
+## [0.1.0] - 2026-05-22
+
+### Added
+
+- Initial pre-v1 plugin shape for Tink.
+- Plugin-first `/tink:*` command surface.
+- Standalone compatibility installer.
+- Built-in harnesses, setup flow, optional hook recommendation, and visible `.tink/` state model.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 dotori
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 dotori
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -2,25 +2,11 @@
   <img src=".github/assets/hero.gif" alt="Tink Hero Banner" width="100%">
 </p>
 
-<h1>
-  <strong>Tink</strong>
-</h1>
+# Tink
 
-<p>사람과 함께 일하며 함께 자라는 하네스</p>
+Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
 
-<p>
-  Tink는 작업에 맞는 하네스를 고르고, 작업에 맞는 하네스를 만들기도 하며, 하네스를 개선 및 제거도 합니다.
-</p>
-
-<p>
-  <em>Tink는 <strong>knit(뜨개질)</strong>을 거꾸로 한 이름입니다. 엉킨 작업 흐름을 풀고, 더 나은 흐름으로 다시 뜨개질해 묶어준다는 뜻입니다. 동시에 곁에 있는 작은 조력자 팅커벨에 대한 오마주이기도 합니다.</em>
-</p>
-
-<p>
-  <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>
+Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
 
 [English](README.md) · **한국어**
 
@@ -28,196 +14,94 @@
 
 ## 왜 만들었나
 
-요즘 새로운 AI 하네스가 거의 매일 등장합니다. 그중 상당수는 저에게 정말 유용했습니다.
-
-처음에는 하나씩 써보면서 저에게 맞는 것만 남겼습니다. 그런데 여러 개를 섞을수록 환경이 점점 엉켜갔습니다. 매번 처음부터 다시 정리하기가 지쳐서, 결국 제가 이해하고 통제할 수 있는 skill 기반 흐름으로 돌아갔습니다.
-
-그 뒤로 한동안 Hermes Agent를 썼습니다. 그때 마음에 남은 것은, 쓸수록 시스템이 나아진다는 점이었습니다. 반복되는 작업이 다시 쓸 수 있는 skill이 되고, 실수가 기억이 되며, 시스템이 사용하는 사람에게 천천히 맞춰져 갔습니다.
-
-Tink는 단순한 질문에서 시작됐습니다:
+새로운 AI 코딩 하네스와 워크플로는 계속 늘어납니다. 좋은 것도 많지만, 여러 개를 섞다 보면 환경이 무거워지고 매번 다시 정리해야 합니다.
 
-> Claude Code나 Codex도 저와 함께 이렇게 자랄 수 있을까요?
-
-큰 프레임워크를 더 얹지 않고도, 에이전트를 더 늘리지 않고도. 그저 Claude나 Codex가 지금 작업에 맞는 하네스를 고르고, 맞는 게 없으면 새로 만들고, 시간이 지나며 그 모음을 더 좋게 다듬도록 돕는 방식으로요.
+Tink는 큰 프레임워크가 아닙니다. Claude Code나 Codex가 지금 작업에 필요한 절차만 고르고, 없으면 작은 임시 하네스를 만들고, 반복되는 실수만 승인 후 재사용 지식으로 남기도록 돕습니다.
 
 ## 설치
 
-Claude Code 플러그인 설치:
+Claude Code 플러그인:
 
 ```text
 /plugin marketplace add dotoricode/tink-harness
-```
-
-```text
 /plugin install tink@tink-harness
-```
-
-```text
 /reload-plugins
-```
-
-```text
 /tink:setup
 ```
 
-독립형(Standalone) 호환 설치 프로그램:
+Standalone / Codex 호환 설치:
 
 ```bash
-npx github:dotoricode/tink-harness install
+npx tink-harness@latest install
 ```
 
-독립형 설치 프로그램은 `LANG` 환경 변수를 자동으로 감지합니다(감지 실패 시 영어 기본값). 강제로 지정하려면 `--lang=en|ko|zh`를 넘기세요.
+설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있습니다. Codex에서는 `$tink cast <task>`로 시작합니다.
 
 ## 업데이트
 
-Claude Code 플러그인 사용자:
+Claude Code 플러그인:
 
 ```text
 /plugin marketplace update tink-harness
-```
-
-```text
 /plugin update tink@tink-harness
-```
-
-```text
 /reload-plugins
 ```
 
-업데이트 명령으로 최신 버전을 찾지 못하면, 제거 후 다시 설치하세요:
-
-```text
-/plugin uninstall tink@tink-harness
-```
-
-```text
-/plugin install tink@tink-harness
-```
-
-기존 독립형 설치를 업데이트하려면(사용자 수정 파일은 유지됩니다):
+Standalone / Codex:
 
 ```bash
-npx github:dotoricode/tink-harness update
+npx tink-harness@latest update
 ```
 
 ## 명령
 
-Tink는 명령 체계를 최소한으로 유지합니다.
-
-Tink는 플러그인 우선 구조이며, 모든 명령은 `tink` 네임스페이스를 사용합니다. 따라서 공개되는 명령은 `/tink:*`로 한정되고 일반 명령과의 충돌을 피할 수 있습니다.
+Claude Code에서는 `/tink:*`, Codex에서는 `$tink <action>`을 씁니다.
 
 ### `/tink:cast`
 
-**cast**는 뜨개질에서 첫 코를 잡는 동작입니다. 모든 작업의 시작점이 됩니다.
-
-Tink에서 `cast`는 기본 실행 흐름입니다. 작업을 읽고, 적절한 하네스를 선택하거나 초안을 만들고, 짧은 내부 검토를 거친 뒤 `.tink/current/`에 현재 작업 상태를 구성합니다. 이후 사용자 승인을 받고 안전한 첫 단계를 실행합니다.
+작업을 읽고, 필요한 하네스만 고르고, `.tink/current/` 실행 상태를 만든 뒤 첫 번째 안전한 단계를 시작합니다.
 
-단순한 질의응답을 넘어서는 작업이라면 보통 `cast`로 시작합니다.
+Tink는 이제 비단순 작업에 대해 `.tink/current/contract.json`도 만듭니다. 이 파일에는 작업 종류, 위험, 성공 조건, 금지 사항, 검증 명령이 들어갑니다.
 
-### `/tink:frog`
-
-**frog**는 잘못 뜬 부분을 풀어내는 뜨개질 용어입니다. 실을 푸는 소리인 "rip it, rip it"에서 이름이 왔습니다.
+### `/tink:verify`
 
-Tink에서 `frog`는:
+`contract.json`에 적힌 검증을 실제로 실행하고 증거를 남깁니다.
 
-- 더 이상 사용하지 않는 하네스
-- 다른 하네스와 역할이 겹치는 항목
-- 범위가 지나치게 넓은 하네스
-- 유지 비용 대비 효율이 낮은 하네스
+릴리스, 배포, 공개 PR처럼 "된 것 같다"가 아니라 "확인했다"가 필요한 작업에서 씁니다.
 
-를 찾아 정리를 제안합니다.
-
-삭제는 항상 사용자 승인 이후에만 수행됩니다.
+### `/tink:frog`
 
-하네스 구성이 복잡하거나 정리가 필요할 때 사용합니다.
+거의 쓰지 않거나 겹치거나 너무 무거운 하네스를 정리 후보로 제안합니다. 사용자 승인 없이는 삭제하지 않습니다.
 
 ### `/tink:weave`
 
-**weave**는 뜨개질을 마친 뒤 남은 실을 안쪽으로 정리해 마감하는 과정(**weave in**)에서 따온 이름입니다.
-
-Tink에서 `weave`는 실제 사용 기록, 실패 사례, 사용자 수정 내용을 바탕으로 기존 하네스를 다듬습니다.
-
-목표는 다음 실행이:
-
-- 더 명확하고
-- 더 안전하며
-- 더 검증 가능하도록
-
-개선하는 것입니다.
-
-하네스가 거의 맞지만 조금씩 어긋나기 시작할 때 사용합니다.
-
-### 기타 명령
-
-- `/tink:setup`
-  - 언어, 설치 범위, Git 추적, Hook 정책을 설정합니다.
-
-- `/tink:list`
-  - 사용 가능한 하네스와 최근 사용 내역을 확인합니다.
-
-- `/tink:update`
-  - 설치 경로를 감지하고 안전한 업데이트 방법을 안내합니다.
-
-## 동작 방식
-
-Tink는 사용자가 직접 확인할 수 있는 파일 구조를 사용합니다.
-
-- `.tink/harnesses/`
-  - 재사용 가능한 작업 하네스
-
-- `.tink/current/`
-  - 현재 실행 상태
-
-- `.tink/runs/`
-  - 완료·중단·취소·교체된 실행 기록
-
-- `.tink/memory/`
-  - 승인된 실수, 선호 설정, 작업 중 얻은 교훈
-
-가장 중요한 원칙은 **승인(approval)** 입니다.
-
-Tink는:
-
-- 하네스 생성
-- 메모리 저장
-- 정리 작업
-- 개선 제안
-
-을 수행할 수 있지만, 실제 적용 전에는 항상 사용자 확인을 거칩니다.
-
-실행 전에는 짧은 점검 단계를 수행하며, 중요한 변경이 있을 때만 별도 제안을 표시합니다.
-
-위험이 낮은 작업은 기록된 가정을 바탕으로 계속 진행할 수 있습니다. 하지만:
-
-- 공개
-- 배포
-- 삭제
-- 대규모 수정
-- 되돌리기 어려운 변경
+실제 실패, 반복 사용, 사용자 수정 내용을 바탕으로 하네스를 조금 더 정확하게 고칩니다. 필요한 경우 `.tink/rules/`의 rule graph나 opt-in hook guard 후보로 승격합니다.
 
-처럼 외부 영향이 큰 작업은 반드시 명시적 승인이 필요합니다.
+### 기타
 
-또한:
+- `/tink:setup`: 언어, 설치 범위, git 추적, hook 정책 설정
+- `/tink:list`: 사용 가능한 하네스와 사용 신호 확인
+- `/tink:update`: 설치 출처를 확인하고 안전한 업데이트 안내
 
-- 새 하네스
-- 메모리 항목
-- `.claude/` 워크플로 파일
+## 작동 방식
 
-같은 재사용 가능한 자산을 저장할 때는 항상 별도의 승인을 다시 받습니다.
+Tink는 직접 볼 수 있는 파일을 씁니다.
 
-현재 실행을 승인했다고 해서, 이후 설치나 영구 저장까지 자동으로 승인되는 것은 아닙니다.
+- `.tink/harnesses/`: 재사용 가능한 작업 하네스
+- `.tink/rules/`: 계약 내용에 맞춰 필요한 하네스, 체크, guard 후보만 고르는 작은 rule graph
+- `.tink/schemas/`: `contract.json` 같은 구조화 파일의 스키마
+- `.tink/current/`: 현재 실행 상태
+- `.tink/runs/`: 완료, 중단, 취소, 교체된 실행 기록
+- `.tink/maintenance/`: 검증, friction, weave 신호 기록
+- `.tink/memory/`: 승인된 실수, 선호, 교훈
 
-## Tink가 하지 않는 것
+Rule graph는 작게 유지합니다. Tink는 먼저 필수 규칙을 고르고, 작업 사실이나 keyword에 맞는 선택 규칙만 가져오며, phase별로 이미 읽은 rule id를 기록해 같은 안내를 반복하지 않습니다.
 
-Tink는 다음을 목표로 하지 않습니다.
+중요한 원칙은 승인입니다. 현재 작업을 진행하는 승인과, 미래에도 재사용될 상태를 저장하는 승인은 별개입니다. 새 하네스, 메모리, rule graph, hook guard 저장은 항상 별도 승인이 필요합니다.
 
-- 코딩 에이전트
-- 워크플로 엔진
-- 멀티 에이전트 런타임
-- 프롬프트 라이브러리
-- Claude Code나 Codex 대체 도구
+## Tink가 아닌 것
 
-Tink는 Claude Code나 Codex 위에 얹는 작은 하네스 레이어입니다.
+Tink는 코딩 에이전트, 워크플로 엔진, 멀티 에이전트 런타임, 프롬프트 라이브러리가 아닙니다. Claude Code와 Codex 위에 얹는 작은 하네스 레이어입니다.
 
 ## 라이선스