moritz/infrapuzzle
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
4d30c654e9109ceb11dd3f9e835041c6e2b9b60c
infrapuzzle/AGENTS.md
T
Moritz Graf d2dac3470f feat(moritzgrafde): rewrite personal website with Vue 3, Vite, and Tailwind CSS 
- Replace legacy Hugo static site generator and hugo-goa theme with a modern Vue 3 + Vite + TypeScript application
- Implement Clean Enterprise design system using Tailwind CSS with light/dark mode support
- Position website around Cloud Platform & Infrastructure Leadership (GCP & AWS central platforms, Kubernetes at scale, enterprise spin-off governance, and systems depth) without chronological resumes
- Add 6 comprehensive capability dossiers and verified credential badges (CKA, PSM II, M.Sc.)
- Implement interactive skill matrix with real-time text search and category filtering
- Add engineering philosophy section, contact channels with one-click email copying, and Impressum modal
- Configure multi-stage Dockerfile (Node builder to Nginx runtime) with custom gzip, caching, and security headers
- Update build scripts (Makefile, build.sh), .gitignore, and AGENTS.md documentation across the monorepo
2026-09-26 20:37:53 +02:00

5.4 KiB
Raw Blame History

AGENTS.md

Note

Infrapuzzle is the monorepo for my personal infrastructure, encompassing Kubernetes cluster provisioning, workload deployment, DNS management, and IoT monitoring.

Repository Structure & Documentation

This repository is divided into distinct domains, each with its own AGENTS.md or specialized documentation.

1. Bootstrap (bootstrap/)

  • Purpose: Provisioning the single-node Kubernetes cluster (Haumdaucher).
  • Tool: Kubespray (Ansible).
  • Key File: init.sh (Source of Truth for versioning).
  • Read: bootstrap/AGENTS.md

2. Kubernetes Workloads (k8s/)

  • Purpose: Deploying applications and services to the cluster.
  • Method: GitOps-style directory structure (Namespace = Folder).
  • Constraints: Enforces ingress-nginx, cert-manager (Let's Encrypt), and git-crypt for secrets.
  • OpenClaw: For OpenClaw AI agent deployment and troubleshooting, see k8s/openclaw/AGENTS.md and k8s/openclaw/TROUBLESHOOTING.md.
  • Read: k8s/AGENTS.md

3. Terraform (terraform/)

  • Purpose: Infrastructure as Code for external resources, primarily DNS.
  • Provider: OVH (ovh/ovh).
  • Scope:
    • DNS Zones: haumdaucher.de, moritzgraf.de, ameliegraf.de, and others.
    • Mail Config: Google Workspace MX/SPF/DKIM records.
    • Cluster IP: Points domains to the Haumdaucher node IP (136.243.23.215).
  • Usage: 
    cd terraform
terraform init
terraform apply

4. Monitoring (monitoring/)

  • Purpose: IoT and physical device monitoring, separate from K8s metrics.
  • Tool: ESPHome.
  • Devices: Temperature sensors, plant monitors (Xiaomi/BLE), ESP32 bridges.
  • Usage: 
    cd monitoring
# Flash or update a device
esphome run config/<device>.secret.yml
  • Network: Devices typically operate on static IPs in the 192.168.x.x range.

5. Knowledge Wiki & OpenClaw Tasks (knowledge-wiki/)

  • Purpose: Shared personal knowledge wiki and task dispatch between OpenClaw (mobile/Telegram concierge) and Antigravity (local pair programming agent).
  • Location: Git submodule knowledge-wiki/ at root of infrapuzzle (Git repo: https://git.moritzgraf.de/moritz/knowledge-wiki.git, branch main).
  • Queue File: knowledge-wiki/tasks/antigravity.md.
  • Workflow for Antigravity:
    • When the user asks to check tasks or pick up work from OpenClaw:
      1. Pull latest: git submodule update --remote knowledge-wiki (or git -C knowledge-wiki pull --rebase origin main)
      2. Read knowledge-wiki/tasks/antigravity.md to see pending items.
      3. Implement the chosen task in the appropriate repository files.
      4. Move the task to ## ✅ Completed Tasks with completion details and commit info.
      5. Push back: git -C knowledge-wiki commit -am "chore(tasks): complete <task>" && git -C knowledge-wiki push origin main.
    • When Antigravity needs knowledge about family, home, servers, or setup:

6. Architecture Decision Records (docs/adr/)

7. Saschas Kronkorken Kreuzzug (projects/sasch40/)

  • Purpose: Mobile-first 2.5D retro birthday adventure game for King Sascha's 40th jubilee (https://sasch40.haumdaucher.de).
  • Key Rules: Prequel landing screen for QR codes, dynamic GameBoy arcade vs RPG layouts, real-photo character portraits, pure Web Audio synthesizer, competitive certificate scoring.
  • Read: projects/sasch40/AGENTS.md

8. Moritz Graf Personal Website (projects/moritzgrafde/)

  • Purpose: Personal homepage and portfolio for Moritz Graf (https://moritzgraf.de).
  • Manifest: k8s/web/moritzgrafde.yaml (Namespace: web).
  • Image: registry.haumdaucher.de/moritzgrafde:latest.
  • Key Rules: Executive portfolio built with Vue 3, Vite, TypeScript, and Tailwind CSS served via Nginx in Docker. Migrated from legacy Hugo to a modern reactive platform showcase.
  • Read: projects/moritzgrafde/AGENTS.md

Global Constraints

  • Secrets: git-crypt is used extensively. Ensure you have the unlock key before editing *.secret files.
  • Identity:
    • Cluster: haumdaucher
    • Primary Domain: haumdaucher.de
    • User Identity: moritzgraf.de
Reference in New Issue View Git Blame Copy Permalink