# CLAUDE.md

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

## Quick Reference

This repository manages Fred's homelab infrastructure - a mix of deployment scripts, monitoring tools, and service integrations for a Proxmox-based network.

**When you need specific information, refer to these specialized docs:**

### Core Architecture

- [.claude/docs/ARCHITECTURE.md](.claude/docs/ARCHITECTURE.md) - Infrastructure components, network topology, WireGuard VPN
- [.claude/docs/SERVICES.md](.claude/docs/SERVICES.md) - Deployed services, container IDs, service-specific details
- [.claude/docs/SCRIPTS.md](.claude/docs/SCRIPTS.md) - Deployment scripts and automation tools

### Operations

- [.claude/docs/COMMON-TASKS.md](.claude/docs/COMMON-TASKS.md) - SSH access, Caddy management, container operations
- [.claude/docs/CERTIFICATES.md](.claude/docs/CERTIFICATES.md) - Step-CA setup, ACME provisioner, SSL configuration

### Detailed References (load when needed)

- Subdirectories have their own CLAUDE.md files (infrastructure/, n8n-workflows/, etc.)
- Service-specific deployment guides in respective directories
- Submodule documentation in submodule directories

## Essential Quick Facts

**Primary Infrastructure:**

- VPS: fred@66.63.182.168 (vps.nianticbooks.com) - Caddy reverse proxy
- Proxmox: root@10.0.10.3 (main-pve) - LXC container host
- Network: 10.0.10.0/24 (WireGuard tunnel: 10.0.8.0/24)

**Critical Services:**

- Uptime Kuma: 10.0.10.26 (CT 128)
- Home Assistant: 10.0.10.24
- CA Server: 10.0.10.15 (CT 115)

## Repository Structure

**Subdirectories:**

- `infrastructure/` - Core infrastructure docs and automation
- `n8n-workflows/` - n8n workflow JSON definitions
- `bible-reading-plan/` - Submodule (separate repo)

**Slash Commands:**

- `/eod`, `/push`, `/focus`, `/sidequest`, `/stuck`, `/reflect` (in `.claude/commands/`)

## Key Constraints

- Proxmox storage: `local` only (never `local-lvm`)
- SSH: Always use key-based auth
- Test on target system before committing
- VPS: 2 CPU / 4GB RAM - lightweight services only