Skip to content

feat: add Gauge understanding integrity#75

Merged
dotoricode merged 1 commit into
mainfrom
agent/understanding-engineering-1.19.0
Jul 14, 2026
Merged

feat: add Gauge understanding integrity#75
dotoricode merged 1 commit into
mainfrom
agent/understanding-engineering-1.19.0

Conversation

@dotoricode

Copy link
Copy Markdown
Owner

문제

Tink의 실행 계약은 성공 조건과 검증 명령을 기록했지만, Agent가 사용자의 목표와 우선순위를 어떻게 이해했는지, 작업 중 새 가정이나 범위 이탈이 생겼는지, 성공 조건 자체가 빠졌는지를 구조적으로 다루지 못했습니다. 이 때문에 command check가 모두 통과해도 원래 요구사항 일부가 누락된 결과를 완료로 판단할 수 있었습니다.

해결

  • non-trivial cast에 optional Understanding Contract와 Intent Proof를 추가했습니다. 기존 contract는 legacy 형식으로 계속 지원합니다.
  • 승인된 goal, priority, scope, success conditions, forbidden은 revision 승인 없이 바뀌지 않도록 규칙을 명시했습니다.
  • Gauge를 새 명령이나 Harness가 아닌 Base-run habit으로 추가해 의미 있는 작업 경계에서 drift, missing coverage, unapproved assumption, priority inversion을 확인합니다.
  • verify에 Phase 0 Contract Coverage를 추가해 command check 전에 success condition별 계획·구현·검사·증거와 forbidden review를 확인합니다.
  • omission, drift, assumption, quick, resume fixture와 Claude/Codex 동기화 테스트를 추가했습니다.

새 공개 /tink:* 명령이나 standalone Understanding Harness는 추가하지 않았습니다.

검증

  • npm run check — template test 47개, syntax, metadata, 155-file pack 검사 통과
  • git diff --check 통과
  • claude plugin validate .claude-plugin/plugin.json 통과(기존 root CLAUDE.md 안내 warning 1개)
  • claude plugin validate .claude-plugin/marketplace.json 통과
  • npm whoami로 publish 계정 확인

참고

  • 버전: 1.19.0
  • 설계 결정: docs/adr/0004-add-gauge-intent-integrity.md
  • working tree에 있던 관련 없는 bin/install.js, 로컬 설정, report 파일은 이 PR에 포함하지 않았습니다.
  • merge 후 tag와 GitHub Release를 만든 뒤 npm publish를 진행합니다.

@dotoricode
dotoricode marked this pull request as ready for review July 14, 2026 05:05
@dotoricode
dotoricode merged commit aaed289 into main Jul 14, 2026
4 checks passed
@dotoricode
dotoricode deleted the agent/understanding-engineering-1.19.0 branch July 14, 2026 05:05
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