Summary

Create a Claude Code hook that intercepts git commands (commit, push, reset) and verifies the current branch before allowing the operation.

Context

From retrospective analysis in PR #669, commits were made to wrong branches. A Claude Code hook could intercept git commands and validate branch state automatically.

Acceptance Criteria

• Hook defined in .claude/settings.json or equivalent
• Hook triggers on: git commit, git push, git reset
• Hook runs git branch --show-current and logs to context
• Hook provides warning if branch doesn't match expected pattern
• Documentation for hook configuration

Technical Notes

• Claude Code supports pre/post-command hooks
• Consider integration with session log for branch tracking
• May overlap with pre-commit hook (feat(git-hooks): add pre-commit hook for branch name validation #678) - evaluate if both needed

References

• PR docs(retrospective): PR co-mingling root cause analysis #669 - PR Co-Mingling Retrospective
• .agents/retrospective/2025-12-31-pr-co-mingling-analysis.md
• Claude Code hooks documentation