Add branch-guard snippet + global-packages doc + remote-notify friction note#6
Merged
Merged
Conversation
…tion note - scripts/branch-guard: local pre-commit + pre-push hooks that refuse commits/pushes to main — the real guard when a remote ruleset lets the repo owner (and thus an AI session on their credentials) bypass it. README documents Husky and plain core.hooksPath install plus the deny-list pairing that makes it a hard lock for an assistant. - docs/global-packages.md: global npm CLIs used as occasional sanity checks (ccusage, devlove, devrage), with a note on why /usage can't aggregate token usage across git worktrees and ccusage can. - docs/ai-collaboration.md: friction entry for questions buried in a summary not firing a notification over remote-control/loop, with a Stop-hook and AskUserQuestion handle. - README.md + docs/INDEX.md: register the new snippet and doc. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SKEr4FwR8c3qz2WRDqgLHu
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Three additions to the library, all on the docs/tooling theme of this branch.
scripts/branch-guard/(new snippet)Local pre-commit + pre-push hooks that refuse commits/pushes to
main. When a remote ruleset grants the repo owner a bypass, a push made with the owner's credentials (including an AI session acting as them) sails through server-side — so a local hook is the real guard. README covers Husky and plaincore.hooksPathinstall, and the--no-verifydeny-list pairing that turns the speed-bump into a hard lock for an assistant while leaving the owner bypass intact. Pairs with the existingsecret-guard.docs/global-packages.md(new doc)Global npm CLIs kept around as occasional sanity checks:
ccusage,devlove,devrage. Includes why/usagecan't aggregate token usage across git worktrees — it's computed from local session history for the current directory, and each worktree is its own~/.claude/projects/<path>/(andwt … -claunches a freshclaudeper worktree) — whereasccusagesums across every project directory.docs/ai-collaboration.md(friction entry)New Open entry: over remote-control/
/loop, a question buried in a prose summary doesn't fire a notification, because pings are triggered by action-required events (permission prompts /AskUserQuestion), not free text. Handles noted: aStophook that pings on every turn-end, and instructing Claude to ask structurally.Maps
README.mdlayout anddocs/INDEX.mdupdated to register the new snippet and doc.🤖 Generated with Claude Code