Zum Inhalt springen

homenet

homenet — Administration des Heimnetzes

Feld Wert
Version 0.1.0
Benötigt Template >=2.6.0
Werkzeuge claude-code
Lizenz MIT
Enthält Code ja

Regeln, Rollen und Skills, um ein Heimnetz oder Homelab aus einem Projekt auf dem Template zu betreiben: LAN und WLAN, Router und Netzwerk-Controller, Hypervisor, Raspberry Pi und andere Server, DNS-Filter, Geräte, Firewall und Home Assistant. Das Package enthält keine Netzwerkdaten (keine Adressen, Hostnamen oder Zugangsdaten); die Einrichtung hält sie im Projekt unter docs/project/homenet/ fest. Es baut auf R-safe-approval und .act/rules/topics/live-systems.md auf und wiederholt beides nicht.

  • Regeln: R-homenet-access (eine Rechtetabelle je System und Weg; ein datierter Eintrag dort ist die dauerhafte Freigabe für eine benannte Klasse von Aktionen), R-homenet-never (der harte Kern, den keine dauerhafte Freigabe abdeckt), R-homenet-ssh, R-homenet-rename, R-homenet-names, R-homenet-exports, R-homenet-handoff; eine Erweiterung von R-safe-approval, die auf die Rechtetabelle verweist.
  • Rollen: homenet-reader (liest nur, scannt nie, prüft jeden Schreibvorgang über seinen eigenen Weg gegen) und homenet-writer (sichert zuerst, löscht nie, ein Schreibvorgang gilt erst nach der Gegenprüfung des Readers als erledigt).
  • Skills: homenet-inventory (erste Bestandsaufnahme und Prüfung der Doku gegen den Live-Stand) und homenet-add-device.
  • Topic: homenet-mcp (MCP-Server und APIs für Home Assistant, Netzwerk-Controller, Hypervisor, Monitoring und NAS, Lesen und Schreiben getrennt gehalten).
  • Code: install.py meldet nur, welche Werkzeuge vorhanden sind (ssh, Python, Interpreter-Fallen unter Windows); es öffnet keine Verbindung und schreibt nichts. Das Prüfmodul homenet_no_scan verweigert Port-Scanner (nmap, masscan, zmap und ähnliche, nc -z über mehr als einen Port) in Shell-Aufrufen von Claude Code.

Die Installation stellt diese Fragen einmal; die Antworten stehen in docs/ai/config.md.

  • homenet-home-assistant: Gehört Home Assistant zu diesem Netz (ja oder nein)?

Namen, wie die Ordner des Packages sie tragen. pre-template lädt vor den eigenen Dateien des Templates: Ein Skill, eine Rolle oder ein Topic mit dem Namen einer Einheit des Templates ersetzt diese. Regeln und Coding-Sätze werden nur erweitert: Eine Regel-Id oder ein Coding-Satz-Name des Templates in pre-template wird abgelehnt. post-template lädt nach den Dateien des Templates und erweitert eine Einheit gleichen Namens.

  • R-homenet-access (post-template)
  • R-homenet-exports (post-template)
  • R-homenet-handoff (post-template)
  • R-homenet-names (post-template)
  • R-homenet-never (post-template)
  • R-homenet-rename (post-template)
  • R-homenet-ssh (post-template)
  • R-safe-approval (post-template)
  • homenet-add-device (post-template)
  • homenet-inventory (post-template)
  • homenet-reader (post-template)
  • homenet-writer (post-template)
  • homenet_no_scan (post-template)
  • homenet-mcp (post-template)
  • install.md: ja
  • install.py: ja

In einem Projekt auf dem Template:

Terminal-Fenster
python .act/scripts/packages.py fetch homenet

danach im Assistenten:

/act-packages add homenet