Skip to content

docs: reposition Tink around intent integrity#76

Merged
dotoricode merged 5 commits into
mainfrom
agent/reposition-tink-intent-integrity
Jul 15, 2026
Merged

docs: reposition Tink around intent integrity#76
dotoricode merged 5 commits into
mainfrom
agent/reposition-tink-intent-integrity

Conversation

@dotoricode

Copy link
Copy Markdown
Owner

문제

v1.19.0은 Intent Proof, Gauge, Contract Coverage를 추가했지만 저장소 첫 화면은 여전히 하네스 관리와 대시보드 중심으로 읽혔습니다. 처음 방문한 사람이 Tink가 어떤 에이전트 실패를 막는지, 어떤 설치 경로를 먼저 선택해야 하는지 빠르게 판단하기 어려웠습니다.

또한 초기 README 문구는 사소한 Lane 1 작업도 항상 Intent Proof와 승인 절차를 거치는 것처럼 읽혔습니다. 실제 구현은 위험이 낮은 작은 작업에서 빠른 경로를 유지하므로 이 차이를 문서에 반영할 필요가 있었습니다.

해결

  • 영어·한국어 README 첫 화면을 Intent Proof → Gauge → Evidence-based Verify 흐름으로 재구성했습니다.
  • npx tink-harness@latest install을 기본 Quick Start로 올리고 Claude Code 플러그인 설치는 보조 경로로 접었습니다.
  • 기능 목록 대신 오해, 이탈, 누락, 무증거 완료, 세션 간 문맥 손실을 어떻게 막는지 정리했습니다.
  • 기능을 설명하는 픽셀 터미널형 배너를 추가했습니다.
  • package 설명과 검색 키워드를 이해 무결성 포지셔닝에 맞췄습니다.
  • Lane 1 빠른 경로와 모순되지 않도록 Intent Proof 적용 범위를 사소하지 않은 작업으로 명시했습니다.

검증

사용자 로컬 변경의 영향을 피하기 위해 현재 커밋에서 별도 clean worktree를 만들고 의존성을 새로 설치한 뒤 확인했습니다.

  • npm test — 템플릿 테스트 47개, 문법 검사, 메타데이터 검사 통과
  • npm run test:pack — 패키지 155개 파일 검사 통과
  • npm run test:e2e — 설치 스모크, 업데이트 보존, Codex Home 검사 통과
  • git diff --check origin/main...HEAD — 통과
  • npm의 tink-harness@1.19.0 핵심 Intent Proof/Gauge/Verify 파일이 Git tag v1.19.0과 일치함을 확인

참고

  • 버전은 1.19.0 그대로 유지했습니다.
  • v1.19.0 GitHub Release와 npm 배포는 이미 완료되어 있어 같은 버전을 다시 게시하지 않습니다.
  • 롤백은 이 PR의 squash merge 커밋을 revert하면 됩니다. 머지 전 기준 SHA는 aaed289입니다.

@dotoricode
dotoricode merged commit 0d3befd into main Jul 15, 2026
4 checks passed
@dotoricode
dotoricode deleted the agent/reposition-tink-intent-integrity branch July 15, 2026 06:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant