Add comprehensive Proxmox infrastructure-as-code and developer documentation

[XessShare]

Description

This PR adds two major documentation and infrastructure components to the repository:

1. CLAUDE.md — A comprehensive guide for AI assistants working in this codebase, covering:

   • Project overview and architecture
   • Repository structure and file organization
   • Development commands and workflows
   • Tool registration patterns and how to add new tools
   • Authentication mechanisms
   • Code style conventions and linting requirements

2. Proxmox VE Infrastructure-as-Code — Complete setup scripts and documentation for a 2-host Proxmox cluster with GPU passthrough, VM management, and remote access:

   • docs/proxmox-setup.md — Network topology, directory structure, and phased setup guide
   • proxmox/network/ — NAT, firewall, SSH hardening, Fail2Ban, and network interface examples
   • proxmox/vm-windows/ — GPU passthrough setup and Windows VM creation with RX 6800 XT
   • proxmox/vm-linux-desktop/ — Linux Desktop VM with SPICE display
   • proxmox/vm-templates/ — Cloud-Init template creation and storage configuration
   • proxmox/remote-access/ — RDP and SPICE connection scripts, ThinkPad routing setup
   • proxmox/fileserver/ — Samba file server setup and share mounting
   • proxmox/backup/ — Automated VM backup scripts and cron job installation
   • proxmox/gpu/ — GPU passthrough readiness diagnostics

Motivation and Context

• CLAUDE.md provides essential context for AI assistants (like Claude) to understand the codebase structure, architecture patterns, and development workflows without requiring external documentation lookups.
• Proxmox infrastructure scripts enable reproducible, automated setup of a complete virtualization environment with GPU acceleration, file sharing, and backup capabilities. This supports the project's infrastructure needs and serves as reference documentation for similar deployments.

How Has This Been Tested?

• CLAUDE.md is a documentation artifact; no testing required.
• Proxmox scripts are infrastructure-as-code templates designed for manual execution in a Proxmox environment. They follow standard bash best practices (set -euo pipefail, error handling, idempotent operations where applicable).

Breaking Changes

None. These are purely additive changes (new files).

Types of changes

• Documentation update

Checklist

• My changes follow the repository's style guidelines
• I have documented all environment variables and configuration options (in CLAUDE.md and script headers)

Additional context

• CLAUDE.md is intended to be read by AI assistants and developers onboarding to the project.
• Proxmox scripts are provided as reference implementations and should be reviewed/tested in a staging environment before production use.
• Updated .gitignore to exclude Proxmox artifacts (ISO images, VM disks, secrets, certificates).

https://claude.ai/code/session_01Jv1eRAFKdmJ1bVG7w1Rhak