docs: add CLAUDE.md with full project context for samurai sessions

This commit is contained in:
kenpat 2026-06-12 00:08:49 -05:00
parent b013bef372
commit 9bf3795630

65
CLAUDE.md Normal file
View file

@ -0,0 +1,65 @@
# KiteStacks — Claude Context
You are working with kenpat on the KiteStacks homelab project on samurai (Windows 11 gaming desktop).
## Who kenpat is
- Building the KiteStacks homelab (kitestacks.com) — live production multi-host platform
- Currently studying CompTIA A+ Core 2, exam goal before July 4th week (hard deadline July 12 2026)
- Passed A+ Core 1 with highest score in class of 22
- Cert path: A+ Core 2 → CCNA → AWS SAA → AWS SysOps → CKA → AI
- Career goal: Cloud Engineering
- Class schedule: Mon/Wed in-person 9am3/4pm, Tue/Thu/Fri remote
- Uses Uber to earn money short-term (parking fees and bills)
## This Device
- **samurai** — Windows 11 gaming desktop, AMD Ryzen 7 7800X3D, 31GB RAM
- Tailscale IP: 100.74.0.109
- Connected to monk (primary homelab host) over Tailscale
## Key Devices
| Device | OS | Tailscale IP | Role |
|--------|-----|-------------|------|
| monk | Linux (Debian) | 100.85.209.116 | Primary homelab host, T14s travel laptop |
| samurai | Windows 11 | 100.74.0.109 | Gaming desktop, study machine |
| kscloud1 | Linux (Hetzner VPS) | 100.123.254.52 | Cloud replica, shared Authentik DB |
## Private Repos on Forgejo (ssh://git@100.85.209.116:2222/kenpat/)
| Repo | Purpose |
|------|---------|
| kitestacks-homelab | Main homelab RUNBOOK, docs, architecture |
| homelab-mastery | Complete learning guide — concepts, certs, interview prep |
| study-tracker | A+ Core 2 study log, practice test scores, cert roadmap |
| obsidian-vault | Personal notes, commands, study log (synced across devices) |
| device-setup | Setup scripts for all devices (this repo) |
## Pull full context
```bash
# Clone all repos for full picture
git clone ssh://git@100.85.209.116:2222/kenpat/homelab-mastery.git ~/homelab-mastery
git clone ssh://git@100.85.209.116:2222/kenpat/study-tracker.git ~/study-tracker
git clone ssh://git@100.85.209.116:2222/kenpat/obsidian-vault.git ~/obsidian-vault
```
## Homelab Quick Facts
- 9 public subdomains at kitestacks.com behind Cloudflare Tunnel
- Active-active failover: monk + kscloud1 both serve all 9 services
- SSO via Authentik (shared Postgres+Redis on kscloud1 over Tailscale)
- Portal (www.kitestacks.com) is custom nginx static site with Python metrics API
- Forgejo runs on monk at gitforge.kitestacks.com (SSH port 2222)
## Current In-Progress Tasks
- samurai Obsidian setup: vault cloned, plugins (Git + Pomodoro Timer) still need to be installed manually
- Portainer SSO: Authentik side done, pending Cloudflare tunnel hostname + Portainer OAuth UI config
- Oracle Cloud migration: kscloud1 (Hetzner) to be replaced by Oracle VPS (no firm date)
- Phase 2: Obsidian mind map → HTML mind map sync for homelab portal
## Study Log (A+ Core 2)
- Started: 2026-06-11 9:15 PM
- Diagnostic: 50% on Sybex (cold, no prior study)
- Next test: CompTIA CertMaster (week of 2026-06-16)
- Full log: ~/study-tracker/certifications/a-plus-core2.md
## Security Rules
- Never commit IPs, ports, or passwords to any Forgejo repo
- Use placeholders: <IP_REDACTED>, <port>, <REDACTED>
- .env files never committed