# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a Go project named `gh-download-proxy` which appears to be a GitHub download proxy service. The project is currently in initial setup phase with only a `go.mod` file present.

## Development Setup

### Go Environment
- Go version: 1.25.3
- Module name: `gh-download-proxy`

### Common Commands

#### Building the project
```bash
go build ./...
```

#### Running tests
```bash
go test ./...
```

#### Running a specific test
```bash
go test -run <TestName> ./...
```

#### Managing dependencies
```bash
go mod tidy    # Clean up dependencies
go mod download # Download dependencies
```

#### Running the application (once main.go exists)
```bash
go run main.go
```

## Project Structure

Currently minimal structure:
- `go.mod` - Go module definition

As the project develops, typical Go project structure would include:
- `main.go` - Main application entry point
- `cmd/` - Command-line applications
- `internal/` - Internal application code
- `pkg/` - Public library code
- `go.sum` - Dependency checksums

## Architecture Notes

Since this is intended to be a GitHub download proxy, the architecture will likely involve:
- HTTP server to handle download requests
- GitHub API integration
- File caching mechanisms
- Proxy functionality to intercept and serve GitHub downloads

## Development Notes

- This is a new repository with no commit history yet
- No Go source files exist yet - development is just beginning
- Consider adding a `README.md` with project documentation
- Consider adding `.gitignore` for Go-specific files