ci: add automation workflows and CLAUDE.md

[greynewell]

These files were pushed after PR #6 was already merged, so they never landed on main.

Workflows

• claude-auto-assign.yml — posts @claude comment on every new issue, triggering auto-implementation
• claude-proactive.yml — runs hourly, scans for bugs/features, files up to 3 issues per run
• claude-pr-shepherd.yml — runs every 15 minutes, addresses CodeRabbit comments and merges clean PRs
• claude.yml — adds explicit allowed_tools including gh pr create so Claude stops posting compare links

CLAUDE.md

Standing instruction: always use gh pr create, never substitute a compare link.

Once this merges, the scheduled workflows activate and PRs #13–18 should get shepherded automatically.

Generated with Claude Code

Summary by CodeRabbit

Release Notes

• New Features

  • Added GitHub Actions workflow to trigger Claude automation on new issues.
  • Added GitHub Actions workflow for automated PR management and merging.
  • Added GitHub Actions workflow for periodic codebase analysis and automated issue creation.

• Documentation

  • Added Claude workflow guidance and development instructions.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3d7fe37 and 4e2b291.

📒 Files selected for processing (5)

• .github/workflows/claude-auto-assign.yml
• .github/workflows/claude-pr-shepherd.yml
• .github/workflows/claude-proactive.yml
• .github/workflows/claude.yml
• CLAUDE.md

---

Walkthrough

This PR establishes an automated Claude integration system via GitHub Actions workflows. It introduces three new workflows for auto-assigning issues, shepherding PRs through review and merge, and proactively scanning for code issues, while simplifying the base Claude workflow configuration and adding workflow documentation.

Changes

Cohort / File(s)	Summary
Claude Workflow Automation .github/workflows/claude-auto-assign.yml, .github/workflows/claude-pr-shepherd.yml, .github/workflows/claude-proactive.yml	Three new workflows enable Claude to auto-comment on issues, manage PR reviews/CI/merging with detailed decision logic, and hourly scan for bugs/features/performance issues.
Configuration Update .github/workflows/claude.yml	Simplified workflow configuration by replacing optional prompt and claude_args blocks with a single allowed_tools string.
Documentation CLAUDE.md	New guide detailing PR creation process (gh pr create), development setup (Go 1.22), build/lint commands, and branch naming conventions (claude/issue-{number}-{YYYYMMDD}-{HHMM}).

Sequence Diagram(s)

sequenceDiagram
    participant GH as GitHub<br/>(Event/API)
    participant Claude as Claude<br/>(PR Shepherd)
    participant Repo as Repository<br/>(Code/Branches)
    
    GH->>Claude: Periodic trigger (15 min) or manual dispatch
    Claude->>GH: Fetch open PRs (non-draft, ≤20)
    Claude->>GH: Get unresolved CodeRabbit comments
    Claude->>Repo: Checkout PR branch
    Claude->>Repo: Read targeted files
    Claude->>Claude: Analyze if comments addressed
    alt Comments Addressed
        Claude->>Repo: Apply fixes & commit
        Claude->>GH: Push commit to PR
    else Comments Unresolved
        Claude->>GH: Reply explaining resolution status
    end
    Claude->>GH: Check PR CI status
    alt CI Failing
        Claude->>Repo: Attempt fixes
        Claude->>Repo: Rebase if needed
    else CI Green & Ready
        Claude->>GH: Merge PR
    end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Possibly related PRs

• Add Claude Code GitHub Workflow #2: Introduces related Claude workflow changes including modifications to .github/workflows/claude.yml and integration patterns with Anthropic's Claude.

Poem

🤖 Claude arrives with workflows in tow,
Auto-assigning issues, watching PRs flow.
Bug-hunting hourly, merging with care,
Dev automation floating through the air! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch claude/workflows-and-claude-md

---

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