Skip to content

Make the hook trust trade-off explicit on the install card and in the README#17

Merged
claude[bot] merged 1 commit into
mainfrom
claude/enhancements-learnings-7ug5p0
Jul 4, 2026
Merged

Make the hook trust trade-off explicit on the install card and in the README#17
claude[bot] merged 1 commit into
mainfrom
claude/enhancements-learnings-7ug5p0

Conversation

@claude

@claude claude Bot commented Jul 4, 2026

Copy link
Copy Markdown

An enterprise evaluator reading "add it to the repo, every agent governed" deserves the precise distinction between the two layers, not a surprise on first run:

  • Context (the compiled rule files) — read automatically, truly zero setup for everyone who clones.
  • Enforcement hook — Claude Code asks each developer to approve the committed hook once, the first time it runs. That prompt is Claude Code's own safety gate (a cloned repo shouldn't run commands unattended) — the exact ambient-execution risk docket exists to catch.

Site: a muted "One honest detail" note at the foot of the install card — rules and record travel instantly; mechanical enforcement is one click per person.

README: the enforcement bullet is tagged (one-time approval per developer) with the same two-layer explanation co-located with the claim.

Turns a potential gotcha into a trust signal. Docs-only; 118 tests green.

🤖 Generated with Claude Code


Generated by Claude Code

… README

The context layer is truly zero-setup for anyone who clones, but the
enforcement hook asks each developer to approve it once (Claude Code's own
safety gate). State that plainly so an enterprise evaluator isn't surprised —
and frame it as the feature it is: a cloned repo shouldn't run commands
unattended, which is the exact ambient-execution risk docket exists to catch.

- Site: an "One honest detail" note at the foot of the install card,
  separating "rules and record travel instantly" from "mechanical
  enforcement is one click per person."
- README: the enforcement bullet is now tagged "(one-time approval per
  developer)" with the same precise two-layer explanation.

Docs-only; 118 tests green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Uc3rGARtDBoXkqMFgppaP4
@claude claude Bot merged commit 25bfe93 into main Jul 4, 2026
3 checks passed
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