CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

Development Tools

Runtime: Bun 1.2.11

Common Development Tasks

Available npm/bun scripts from package.json:

# Test
bun test

# Formatting
bun run format          # Format code with prettier
bun run format:check    # Check code formatting

Architecture Overview

This is a GitHub Action that enables Claude to interact with GitHub PRs and issues. The action:

Trigger Detection: Uses check-trigger.ts to determine if Claude should respond based on comment/issue content
Context Gathering: Fetches GitHub data (PRs, issues, comments) via github-data-fetcher.ts and formats it using github-data-formatter.ts
AI Integration: Supports multiple Claude providers (Anthropic API, AWS Bedrock, Google Vertex AI)
Prompt Creation: Generates context-rich prompts using create-prompt.ts
MCP Server Integration: Installs and configures GitHub MCP server for extended functionality

Key Components

Trigger System: Responds to /claude comments or issue assignments
Authentication: OIDC-based token exchange for secure GitHub interactions
Cloud Integration: Supports direct Anthropic API, AWS Bedrock, and Google Vertex AI
GitHub Operations: Creates branches, posts comments, and manages PRs/issues

Project Structure

src/
├── check-trigger.ts        # Determines if Claude should respond
├── create-prompt.ts        # Generates contextual prompts
├── github-data-fetcher.ts  # Retrieves GitHub data
├── github-data-formatter.ts # Formats GitHub data for prompts
├── install-mcp-server.ts  # Sets up GitHub MCP server
├── update-comment-with-link.ts # Updates comments with job links
└── types/
    └── github.ts          # TypeScript types for GitHub data

Important Notes

Actions are triggered by @claude comments or issue assignment unless a different trigger_phrase is specified
The action creates branches for issues and pushes to PR branches directly
All actions create OIDC tokens for secure authentication
Progress is tracked through dynamic comment updates with checkboxes

MCP Tool Development

When adding new MCP tools:

Add to MCP Server: Implement the tool in the appropriate MCP server file (e.g., src/mcp/local-git-ops-server.ts)
Expose to Claude: Add the tool name to BASE_ALLOWED_TOOLS array in src/create-prompt/index.ts
Tool Naming: Follow the pattern mcp__server_name__tool_name (e.g., mcp__local_git_ops__checkout_branch)
Documentation: Update the prompt's "What You CAN Do" section if the tool adds new capabilities

2.7 KiB Raw Blame History