docs: 0.13.0 의 81.5% 주장을 정정하고, 살아남는 근거를 대신 적는다

[ictechgy]

무엇이 틀렸나

CHANGELOG.md 의 0.13.0 항목은 Bash escrow 를 기본 래퍼로 만든 근거로 "새 토큰의 81.5% 가 Bash 결과 직후에 온다" 를 든다. 그 표에 결함이 둘 있었고 #376 에서 고쳤다.

• last_result 가 파일 단위로만 초기화돼, 새 도구 결과가 없는 턴이 앞 턴의 라벨을 물려받았다.
• 스냅샷은 accepted 행마다 찍히고 비워지는데 reducer 는 응답 그룹의 마지막 행을 고른다. 여러 행으로 나뉜 응답은 이미 비워진 스냅샷을 읽었다.

교정하면 no_tool_result 약 72%, Bash 약 18%. multi_result_turns 는 약 108 에서 약 2,150 으로 간다.

결정 자체는 살아남는다 — 다른 근거로

턴은 두 번째 축으로도 갈린다. 캐시 접두사를 다시 썼는가, 이어 붙였는가. 도구가 돌려준 양에 비례해 과금되는 것은 incremental 턴뿐이고, 그 안에서는 Bash 가 여전히 약 69% 를 선행한다.

접두사를 쓴 턴은 cache_creation 의 약 77% 인데 어떤 도구 훅도 줄일 수 없다. audit 이 이제 cold_start / cache_rewrite / incremental 필드로 따로 보고하고 권고에서도 그 사실을 말한다.

발행된 항목은 다시 쓰지 않았다

0.13.0 본문은 그대로 두고 정정을 가리키는 한 줄만 덧붙였다. 이미 나간 릴리스 노트를 조용히 고치지 않기 위해서다. 정정 내용은 [Unreleased] 에 있다.

수치를 반올림한 이유

살아 있는 디렉터리에서 나오는 값이라 이 세션 안에서도 같은 스크립트가 76.7 에서 76.9 로 움직였다. 변경 로그에는 정정의 모양만 적고 방법은 docs/safety-reference.md 를 가리킨다. #374 에서 같은 교훈을 얻었다.

스킬 문서도 고쳤다

plugins/context-guard/skills/audit/SKILL.md 가 "가장 많이 선행한 도구를 앞세우라" 고 지시했는데, 접두사 쓰기가 우세한 코퍼스에서는 틀린 곳을 가리킨다. 세 필드를 먼저 읽고 incremental 턴이 도구를 가리킬 때만 도구를 앞세우도록 바꿨다.

검증

인용한 네 수치를 병합된 main 에서 다시 측정해 확인했다.

문서	재측정
no_tool_result 약 72%	71.8%
Bash 약 18%	17.7%
multi_result_turns 약 2,150	2,150
접두사 쓰기 약 77%	76.9%
incremental 중 Bash 약 69%	69.4%

tests.test_contextguard_stage2_feasibility + standing_cost   Ran 13 OK, exit 0
scripts/ci_test_gate.py fast                                 Ran 76 OK, exit 0
scripts/prepublish_check.py --skip-tests                     prepublish check: OK
scripts/release_preflight.py                                 경고 없음

문서만 바뀌므로 squash 로 병합해도 된다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DE3AupXcyv64SEuQeTckSh

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 0ef00760-9922-4a74-b0b8-87a670d8c119

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}