claude-git-hooks/templates/config.github.example.json

Git hooks with Claude CLI for code analysis and automatic commit messages

{
    "$schema": "Configuration example for GitHub integration (v2.5.0+)",
    "_comment": "GitHub PR creation via Octokit - Claude generates metadata, Octokit creates PR deterministically",
    "github": {
        "enabled": true,
        "pr": {
            "defaultBase": "develop",

            "_comment_reviewers": "Reviewers to add to PRs. Use GitHub usernames (without @). Also auto-detected from CODEOWNERS if exists.",
            "reviewers": ["teammate1-username", "teammate2-username"],

            "_comment_reviewers_advanced": "For preset-based or conditional reviewers, use arrays keyed by preset name",
            "reviewers_by_preset": {
                "backend": ["backend-dev", "tech-lead"],
                "frontend": ["frontend-dev", "ux-designer"],
                "fullstack": ["fullstack-dev"]
            },

            "_comment_reviewerRules": "Pattern-based reviewer assignment. Matches file paths in the PR diff.",
            "reviewerRules": [
                {
                    "pattern": ".*\\.java$",
                    "reviewers": ["backend-dev"]
                },
                {
                    "pattern": ".*\\.sql$",
                    "reviewers": ["dba-team"]
                },
                {
                    "pattern": ".*\\.(tsx|jsx)$",
                    "reviewers": ["frontend-dev"]
                }
            ],

            "_comment_labelRules": "Labels added automatically based on active preset. Also detects breaking-change automatically.",
            "labelRules": {
                "backend": ["backend", "java", "spring-boot"],
                "frontend": ["frontend", "react", "typescript"],
                "fullstack": ["fullstack"],
                "database": ["database", "sql"],
                "ai": ["ai", "nodejs", "tooling"],
                "default": []
            }
        }
    },

    "_usage": "Copy relevant sections to .claude/config.json in your project",
    "_token_setup": "Run 'claude-hooks setup-github' to configure GitHub token",
    "_token_location": "Token stored in .claude/settings.local.json (gitignored) or env var GITHUB_TOKEN",
    "_codeowners": "CODEOWNERS file auto-detected from: CODEOWNERS, .github/CODEOWNERS, docs/CODEOWNERS"
}