Pi-hole-Optimized-Blocklists

# CLAUDE.md

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

## Project Overview

Pre-optimized, deduplicated blocklists for Pi-hole. Lists are built weekly from 59 upstream sources using the [Pi-hole-Blocklist-Optimizer](https://github.com/zachlagden/Pi-hole-Blocklist-Optimizer) Rust binary, then committed and served via GitHub + Git LFS.

## How It Works

A GitHub Actions workflow (`.github/workflows/update-blocklists.yml`) runs every Sunday at midnight UTC:

1. Downloads the latest `pihole-optimizer` binary from GitHub Releases
2. Runs it against `blocklists.conf` (source URLs) and `whitelist.txt` (false-positive exclusions)
3. Produces deduplicated, categorized blocklists in `pihole_blocklists_prod/`
4. Copies changed files into `lists/`, updates README statistics, and commits

## Project Structure

```
Pi-hole-Optimized-Blocklists/
├── .github/
│   ├── workflows/
│   │   ├── update-blocklists.yml   # Weekly blocklist update automation
│   │   ├── claude-code-review.yml  # Claude Code PR reviews
│   │   └── claude.yml              # Automated issue processing + @claude assistant
│   ├── ISSUE_TEMPLATE/             # Bug report, block domain, false positive, feature request
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── dependabot.yml
├── custom/                         # Community-reported domains (fed to optimizer via URL)
│   ├── malicious.txt               # Fake shops, scams, phishing
│   ├── advertising.txt             # Ad-serving domains
│   ├── tracking.txt                # Tracking and telemetry
│   ├── suspicious.txt   …