claude-home/CLAUDE.md
Cal Corum 3737c7dda5 docs: expand monitoring coverage, update Proxmox upgrade plan, remove decommissioned tdarr scripts
- Update monitoring CONTEXT.md with 6-server inventory table, per-server
  SSH user support, and pre-escalation Discord notification docs
- Remove tdarr local monitoring scripts (decommissioned per prior decision)
- Update Proxmox upgrade plan with Phase 1 completion and Phase 2 prep
- Update vm-management CONTEXT.md with current PVE 8 state
- CLAUDE.md: auto-run /save-memories at 25% context instead of asking

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 11:08:48 -06:00

45 lines
2.1 KiB
Markdown

# Home Lab Documentation System
## Core Instructions
- Always have permission to run tests
- Check imports when writing code (prevent NameErrors)
- Temp files go in `.claude/tmp/`, clean up after
- Prefer editing existing files over creating new ones
- After complex tasks, prompt to save learnings to cognitive memory
- At session end, ask: "Should I update our documentation?"
- At 25% context remaining, automatically run `/save-memories` before compaction loses detail
## Context Loading
When a topic comes up, load `{tech}/CONTEXT.md` + `{tech}/troubleshooting.md`. For scripts, also load `{tech}/scripts/CONTEXT.md`.
| Keywords | Directory |
|----------|-----------|
| tdarr, transcode, ffmpeg, nvenc | `tdarr/` |
| docker, container, compose, dockerfile | `docker/` |
| vm, proxmox, kvm, hypervisor | `vm-management/` |
| nginx, proxy, dns, firewall, ssh, ssl, pihole | `networking/` |
| monitoring, alert, uptime kuma, discord health check | `monitoring/` |
| productivity,
n8n, workflow, automation, ko-fi | `productivity/` |
| openclaw, ai assistant, autonomous agent | `productivity/openclaw/` |
| jellyfin, plex, media server, watchstate | `media-servers/` |
| yt-dlp, playwright, media download, web scraping | `media-tools/` |
| steam, proton, steam tinker launch, gaming | `gaming/` |
| server config, gitea config, infrastructure | `server-configs/` |
| database, postgres, redis, sql | `databases/` |
| backup, restic, snapshot, restore, retention | `backups/` |
**Special loads:**
- Pi-hole → also `networking/pihole-ha-setup.md`
- n8n → also `productivity/n8n/CONTEXT.md`
- Ko-fi → also `productivity/n8n/workflows/kofi-paper-dynasty.md`
- Jellyfin → also `media-servers/jellyfin-ubuntu-manticore.md`
- `.py` files → `development/python-CONTEXT.md`
- `.js/.ts` files → `development/nodejs-CONTEXT.md`
- `.sh/.bash` files → `development/bash-CONTEXT.md`
## Documentation Maintenance
- New tech without a directory → offer to create `/{tech}/` structure
- New error solved → offer to add to `{tech}/troubleshooting.md`
- New scripts created → offer to update `{tech}/scripts/CONTEXT.md`