Infrastruktur-Dokumentation: Neue Kunden-Organisation
- CLAUDE.md: Host-Troubleshooting → Infrastruktur-Dokumentationssystem - session-start.sh: Erkennt ~/Nextcloud/[kunde]/[repo]/ Struktur - Legacy-Support für ~/Nextcloud/hosts/ mit Migrations-Hinweis Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
root
373
plans/elegant-zooming-porcupine.md
Normal file
373
plans/elegant-zooming-porcupine.md
Normal file
@@ -0,0 +1,373 @@
|
||||
# Plan: Infrastruktur-Dokumentationssystem
|
||||
|
||||
## Ziel
|
||||
|
||||
Ein wachsendes Dokumentationssystem das:
|
||||
1. **Alle Verbindungen** zwischen Diensten, Hosts und Hardware aufzeigt
|
||||
2. **Impact-Analyse** ermöglicht ("Was geht kaputt wenn ich X ändere?")
|
||||
3. **Änderungshistorie** bietet (Git-Log = Changelog)
|
||||
4. **Troubleshooting** unterstützt
|
||||
|
||||
---
|
||||
|
||||
## Architektur: Organisation pro Kunde
|
||||
|
||||
```
|
||||
Gitea-Struktur:
|
||||
├── vinos/ ← Organisation für Kunde "vinos"
|
||||
│ ├── infrastructure.git ← Landkarte für vinos
|
||||
│ ├── zabbix.git ← System-Repo
|
||||
│ ├── pmg-mailgw.git ← System-Repo
|
||||
│ └── n8n.git ← Dienst-Repo
|
||||
│
|
||||
└── egonetix/ ← Organisation für Kunde "egonetix"
|
||||
├── infrastructure.git ← Landkarte für egonetix
|
||||
├── pfsense.git
|
||||
└── traefik.git
|
||||
```
|
||||
|
||||
```
|
||||
Lokal:
|
||||
~/Nextcloud/
|
||||
├── vinos/ ← Kunde vinos
|
||||
│ ├── infrastructure/ ← Landkarte
|
||||
│ ├── zabbix/ ← System-Repo
|
||||
│ ├── pmg-mailgw/ ← System-Repo
|
||||
│ └── n8n/ ← Dienst-Repo
|
||||
│
|
||||
└── egonetix/ ← Kunde egonetix
|
||||
├── infrastructure/
|
||||
├── pfsense/
|
||||
└── traefik/
|
||||
```
|
||||
|
||||
| Repo-Typ | Gitea-Ort | Inhalt |
|
||||
|----------|-----------|--------|
|
||||
| **Infrastructure** | `[kunde]/infrastructure.git` | Landkarte, Abhängigkeiten für diesen Kunden |
|
||||
| **System-Repo** | `[kunde]/[system].git` | Konfig-Dateien, README, Troubleshooting |
|
||||
| **Dienst-Repo** | `[kunde]/[dienst].git` | docker-compose.yml, Code, Workflows |
|
||||
|
||||
**Vorteile:**
|
||||
- Klare Kunden-Trennung
|
||||
- Jeder Kunde hat eigene Infrastruktur-Doku
|
||||
- Repos sind nach Kunde gruppiert auf Gitea
|
||||
- Zugriffsrechte pro Organisation möglich
|
||||
|
||||
---
|
||||
|
||||
## 1. Infrastructure-Repo (NEU) - SCHLANK
|
||||
|
||||
**Speicherort:** `~/Nextcloud/infrastructure/` → `ssh://git@gitea.egonetix.de:222/root/infrastructure.git`
|
||||
|
||||
**Prinzip:** Nur Landkarte und Links - KEINE Konfig-Dateien!
|
||||
|
||||
```
|
||||
infrastructure/
|
||||
├── README.md ← Einstieg + Gesamtübersicht
|
||||
├── hosts/
|
||||
│ ├── srvdocker02.md ← Übersicht + Links zu Dienst-Repos
|
||||
│ ├── srv-monitor02.md ← Übersicht + Link zu systems/zabbix.git
|
||||
│ └── pmg01.md ← Übersicht + Link zu systems/pmg-mailgw.git
|
||||
├── netzwerk/
|
||||
│ ├── vlans.md
|
||||
│ └── dns.md
|
||||
├── hardware/
|
||||
│ ├── switches.md
|
||||
│ ├── firewalls.md
|
||||
│ └── storage.md
|
||||
└── dependencies.md ← HERZSTÜCK: Mermaid-Diagramme
|
||||
```
|
||||
|
||||
**Beispiel hosts/pmg01.md:**
|
||||
```markdown
|
||||
# PMG01 - Proxmox Mail Gateway
|
||||
|
||||
| IP | Funktion | Repo |
|
||||
|----|----------|------|
|
||||
| 10.0.0.50 | Mail-Gateway | [systems/pmg-mailgw](https://gitea.egonetix.de/systems/pmg-mailgw) |
|
||||
|
||||
## Abhängigkeiten
|
||||
- **Betrifft:** mailsrv1, mailsrv2
|
||||
- **Benötigt:** DNS, Internet
|
||||
|
||||
→ Details und Konfig: siehe [Repo](https://gitea.egonetix.de/systems/pmg-mailgw)
|
||||
```
|
||||
|
||||
### dependencies.md Beispiel:
|
||||
|
||||
```markdown
|
||||
# Abhängigkeiten
|
||||
|
||||
## Mail-System
|
||||
```mermaid
|
||||
graph LR
|
||||
Internet --> pmg01[PMG Mailgateway]
|
||||
pmg01 --> mailsrv1[Mailserver 1]
|
||||
pmg01 --> mailsrv2[Mailserver 2]
|
||||
mailsrv1 --> storage[(NAS01)]
|
||||
mailsrv2 --> storage
|
||||
```
|
||||
|
||||
**Impact:** Änderung an PMG betrifft beide Mailserver!
|
||||
|
||||
## Monitoring
|
||||
```mermaid
|
||||
graph TD
|
||||
zabbix[Zabbix] -.überwacht.-> pmg01
|
||||
zabbix -.überwacht.-> srvdocker02
|
||||
zabbix -.überwacht.-> pfsense
|
||||
zabbix --> postgres[(PostgreSQL)]
|
||||
```
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Dienst-Repos (Docker) - BEHALTEN
|
||||
|
||||
**Beispiel:** n8n, trading-bot, traefik
|
||||
|
||||
**Struktur:**
|
||||
```
|
||||
n8n/
|
||||
├── docker-compose.yml
|
||||
├── Dockerfile (optional)
|
||||
├── .env.example
|
||||
├── README.md ← Deployment, Zugang, Quick Reference
|
||||
├── scripts/
|
||||
└── config/
|
||||
```
|
||||
|
||||
**Git-Log = Changelog:**
|
||||
```
|
||||
a3f2b1c Webhook-URL geändert (betrifft: Telegram-Bot)
|
||||
e7d4a9f PostgreSQL auf Version 15 aktualisiert
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. System-Repos (Appliances/VMs) - NEU
|
||||
|
||||
**Für:** PMG, pfSense, Mailserver, Zabbix-Server, etc.
|
||||
|
||||
**Struktur:**
|
||||
```
|
||||
pmg-mailgw/
|
||||
├── README.md ← Zugang, IP, Quick Reference
|
||||
├── config/ ← Konfig-Dateien direkt (Git = Backup!)
|
||||
│ ├── cluster.conf
|
||||
│ ├── relay_domains
|
||||
│ └── main.cf
|
||||
├── dependencies.md ← "betrifft: mailsrv1, mailsrv2"
|
||||
└── troubleshooting.md ← Bekannte Probleme & Lösungen
|
||||
```
|
||||
|
||||
**Workflow bei Änderungen:**
|
||||
1. Änderung am System durchführen
|
||||
2. Konfig-Dateien ins Repo kopieren
|
||||
3. `git commit -m "Relay-Domain hinzugefügt (betrifft: mailsrv1, mailsrv2)"`
|
||||
4. Bei Problem: `git log` → sofort sichtbar was sich geändert hat
|
||||
|
||||
---
|
||||
|
||||
## Was wird aus dem bisherigen Setup?
|
||||
|
||||
| Alt | Neu |
|
||||
|-----|-----|
|
||||
| `~/Nextcloud/hosts/` | → `~/Nextcloud/infrastructure/` |
|
||||
| `~/Nextcloud/hosts/_templates/` | → Templates pro Repo-Typ |
|
||||
| Host-Repos (vinos_srv-monitor02) | → System-Repos oder nur im Infrastructure-Repo |
|
||||
| Dienst-Repos (n8n) | Bleiben wie sie sind |
|
||||
|
||||
---
|
||||
|
||||
## Dateien zu erstellen/ändern
|
||||
|
||||
### Schritt 1: Gitea-Organisationen anlegen
|
||||
|
||||
```
|
||||
https://gitea.egonetix.de/org/create
|
||||
- "vinos" anlegen
|
||||
- "egonetix" anlegen
|
||||
```
|
||||
|
||||
### Schritt 2: Lokale Verzeichnisstruktur
|
||||
|
||||
```bash
|
||||
mkdir -p ~/Nextcloud/vinos
|
||||
mkdir -p ~/Nextcloud/egonetix
|
||||
```
|
||||
|
||||
### Schritt 3: Infrastructure-Repo für vinos
|
||||
|
||||
```bash
|
||||
cd ~/Nextcloud/vinos
|
||||
git init infrastructure
|
||||
cd infrastructure
|
||||
```
|
||||
|
||||
| Datei | Beschreibung |
|
||||
|-------|--------------|
|
||||
| `README.md` | Einstiegspunkt für vinos |
|
||||
| `dependencies.md` | Mermaid-Diagramme (Mail-System, Monitoring, etc.) |
|
||||
| `hosts/` | Host-Übersichten (kurz, mit Links zu Repos) |
|
||||
| `netzwerk/` | VLANs, DNS, Firewall-Regeln |
|
||||
| `hardware/` | Switches, Storage, Server-Hardware |
|
||||
| `_templates/` | Templates für neue Hosts/Systeme |
|
||||
|
||||
Remote: `ssh://git@gitea.egonetix.de:222/vinos/infrastructure.git`
|
||||
|
||||
### Schritt 4: Zabbix System-Repo (Migration)
|
||||
|
||||
```bash
|
||||
cd ~/Nextcloud/vinos
|
||||
git init zabbix
|
||||
cd zabbix
|
||||
```
|
||||
|
||||
| Datei | Beschreibung |
|
||||
|-------|--------------|
|
||||
| `README.md` | Zugang, Quick Reference (migriert von srv-monitor02) |
|
||||
| `config/` | Relevante Konfig-Dateien |
|
||||
| `troubleshooting.md` | Bekannte Probleme & Lösungen |
|
||||
| `dependencies.md` | "Überwacht: alle Hosts" |
|
||||
|
||||
Remote: `ssh://git@gitea.egonetix.de:222/vinos/zabbix.git`
|
||||
|
||||
### Schritt 5: Claude-Settings aktualisieren
|
||||
|
||||
| Datei | Änderung |
|
||||
|-------|----------|
|
||||
| `~/.claude/CLAUDE.md` | Neue Struktur mit Kunden-Organisationen |
|
||||
| `session-start.sh` Hook | `~/Nextcloud/[kunde]/` erkennen |
|
||||
| `troubleshoot.md` Skill | Anpassen auf neue Struktur |
|
||||
| NEU: `new-repo.md` Skill | Neues System-/Dienst-Repo für Kunden anlegen |
|
||||
|
||||
### Schritt 6: Aufräumen
|
||||
|
||||
| Datei | Aktion |
|
||||
|-------|--------|
|
||||
| `~/Nextcloud/hosts/` | Löschen nach Migration |
|
||||
| `root/vinos_srv-monitor02.git` | Optional: Archivieren (kann auch bleiben) |
|
||||
|
||||
**Nicht jetzt:** Bestehende Repos (n8n, etc.) bleiben unter `root/` - Migration zu egonetix später
|
||||
|
||||
---
|
||||
|
||||
## Templates
|
||||
|
||||
### Template: Dienst (Docker)
|
||||
|
||||
```markdown
|
||||
# [DIENST-NAME]
|
||||
|
||||
## Quick Start
|
||||
```bash
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
## Zugang
|
||||
- URL: https://[domain]
|
||||
- Port: [port]
|
||||
|
||||
## Abhängigkeiten
|
||||
- Benötigt: [PostgreSQL, Redis, etc.]
|
||||
- Wird genutzt von: [andere Dienste]
|
||||
|
||||
## Konfiguration
|
||||
[Wichtige Umgebungsvariablen, Volumes]
|
||||
|
||||
## Troubleshooting
|
||||
[Häufige Probleme]
|
||||
```
|
||||
|
||||
### Template: System (Appliance/VM)
|
||||
|
||||
```markdown
|
||||
# [SYSTEM-NAME]
|
||||
|
||||
## System Overview
|
||||
| Eigenschaft | Wert |
|
||||
|-------------|------|
|
||||
| **Host** | [hostname] |
|
||||
| **IP** | [ip] |
|
||||
| **Typ** | [Proxmox/VMware/Bare-Metal] |
|
||||
| **OS** | [Debian/FreeBSD/etc.] |
|
||||
| **Zugang** | [SSH/Web-UI] |
|
||||
|
||||
## Abhängigkeiten
|
||||
**Dieses System betrifft:**
|
||||
- [system1]
|
||||
- [system2]
|
||||
|
||||
**Dieses System benötigt:**
|
||||
- [dependency1]
|
||||
|
||||
## Konfig-Dateien
|
||||
| Datei | Beschreibung |
|
||||
|-------|--------------|
|
||||
| config/[file] | [was es tut] |
|
||||
|
||||
## Wichtige Befehle
|
||||
```bash
|
||||
# [Beschreibung]
|
||||
[befehl]
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
[Bekannte Probleme & Lösungen]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Verifikation
|
||||
|
||||
1. [ ] Gitea-Organisation "vinos" existiert
|
||||
2. [ ] `vinos/infrastructure.git` angelegt und gepusht
|
||||
3. [ ] `vinos/zabbix.git` angelegt (Inhalt von srv-monitor02)
|
||||
4. [ ] Mindestens ein Mermaid-Diagramm in `vinos/infrastructure/dependencies.md`
|
||||
5. [ ] Claude in `~/Nextcloud/vinos/zabbix/` starten → Lädt README
|
||||
6. [ ] `~/Nextcloud/hosts/` gelöscht
|
||||
7. [ ] CLAUDE.md und Hooks aktualisiert für neue Struktur
|
||||
|
||||
**Später:** egonetix Organisation + Migration bestehender Repos
|
||||
|
||||
---
|
||||
|
||||
## Entscheidungen (geklärt)
|
||||
|
||||
| Frage | Entscheidung |
|
||||
|-------|--------------|
|
||||
| Kunden-Trennung | Organisation pro Kunde (`vinos/`, `egonetix/`) |
|
||||
| Infrastructure-Repo | Schlank - nur Landkarte, keine Configs (pro Kunde) |
|
||||
| Namenskonvention | `[kunde]/[name].git` (z.B. `vinos/zabbix.git`) |
|
||||
| srv-monitor02 | Migrieren → `vinos/zabbix.git` |
|
||||
| Hardware | Im jeweiligen Kunden-Infrastructure-Repo |
|
||||
|
||||
---
|
||||
|
||||
## Migration
|
||||
|
||||
### Jetzt:
|
||||
|
||||
1. **Gitea-Organisationen anlegen**
|
||||
- `vinos` Organisation erstellen
|
||||
- `egonetix` Organisation erstellen (für später)
|
||||
|
||||
2. **vinos Infrastructure-Repo anlegen**
|
||||
- Neues Repo: `vinos/infrastructure.git`
|
||||
- Basis-Struktur mit hosts/, dependencies.md, etc.
|
||||
|
||||
3. **vinos/zabbix.git anlegen** (migriert von srv-monitor02)
|
||||
- Inhalt von `vinos_srv-monitor02` übernehmen
|
||||
- Altes Repo kann bleiben oder archiviert werden
|
||||
|
||||
4. **Lokale Struktur**
|
||||
- `~/Nextcloud/vinos/infrastructure/`
|
||||
- `~/Nextcloud/vinos/zabbix/`
|
||||
- `~/Nextcloud/hosts/` entfernen
|
||||
|
||||
### Später (nicht Teil dieses Plans):
|
||||
|
||||
- Bestehende Repos unter `root/` (n8n, etc.) → gehören zu egonetix
|
||||
- Migration in `egonetix/` Organisation wenn Zeit ist
|
||||
- Diese Repos bleiben erstmal wo sie sind
|
||||
269
plans/quirky-snacking-bunny.md
Normal file
269
plans/quirky-snacking-bunny.md
Normal file
@@ -0,0 +1,269 @@
|
||||
# Workflow-Plan: Multi-Machine Development Tracking
|
||||
|
||||
## Problem
|
||||
- 4+ Maschinen mit verschiedenen Projekten
|
||||
- Verliert Überblick "Wo war ich? Was war der Stand?"
|
||||
- Gitea = Haupt-Tracking (gitea.egonetix.de:222)
|
||||
|
||||
## Inspiriert von Boris Cherny (Claude Code Creator)
|
||||
|
||||
Quelle: [YouTube Video](https://www.youtube.com/watch?v=B-UXpneKw6M) | [Medium Summary](https://medium.com/@joe.njenga/boris-cherny-claude-code-creator-shares-these-22-tips-youre-probably-using-it-wrong-1b570aedefbe)
|
||||
|
||||
**Key Takeaways eingebaut:**
|
||||
1. **Learnings dokumentieren** → WORKLOG.md enthält "Learnings" Sektion für Fehler/Erkenntnisse
|
||||
2. **Plan Mode First** → `/session-start` aktiviert Plan Mode für strukturierte Arbeit
|
||||
3. **Verification Loops** → Skills enthalten Verifikationsschritte
|
||||
4. **Separate Checkouts** → Doku für parallele Sessions auf gleicher Maschine
|
||||
|
||||
---
|
||||
|
||||
## Lösung: "Session Context" Workflow mit Gitea
|
||||
|
||||
### Kernprinzip
|
||||
Jedes Projekt hat eine **WORKLOG.md** die:
|
||||
- Bei Session-Start automatisch angezeigt wird
|
||||
- Den aktuellen Stand + nächste Schritte + Entscheidungen dokumentiert
|
||||
- Mit Gitea Issues verlinkt ist
|
||||
- Bei Session-Ende aktualisiert und committet wird
|
||||
|
||||
---
|
||||
|
||||
## Komponenten
|
||||
|
||||
### 1. WORKLOG.md pro Projekt
|
||||
|
||||
```markdown
|
||||
# Worklog: [Projektname]
|
||||
|
||||
## Current State
|
||||
**Zuletzt:** 2025-01-26 auf `n2095` (Desktop)
|
||||
**Branch:** feature/new-thing
|
||||
**Issue:** [#42 - API Implementation](https://gitea.egonetix.de/user/repo/issues/42)
|
||||
**Status:** In Progress - API fertig, Frontend fehlt
|
||||
|
||||
## Next Steps
|
||||
- [ ] Frontend-Komponente für User-Liste
|
||||
- [ ] Tests für API-Endpoints
|
||||
- [ ] Dokumentation aktualisieren
|
||||
|
||||
## Key Decisions
|
||||
- **2025-01-26:** REST statt GraphQL wegen einfacherer Integration
|
||||
- **2025-01-25:** PostgreSQL statt SQLite für Multi-User
|
||||
|
||||
## Learnings (für Claude)
|
||||
<!-- Fehler und Erkenntnisse damit Claude sich verbessert -->
|
||||
- **2025-01-26:** API-Routen MÜSSEN mit /api/ prefix beginnen, sonst Konflikt mit Frontend-Routes
|
||||
- **2025-01-25:** TypeScript strict mode aktivieren BEVOR Code geschrieben wird
|
||||
|
||||
## Session History
|
||||
### 2025-01-26 | n2095 | Commits: `a3f2b1c`, `e7d4a9f`
|
||||
- API-Endpoints implementiert
|
||||
- Database-Schema angepasst
|
||||
- Issue #42 kommentiert
|
||||
|
||||
### 2025-01-25 | laptop | Commits: `b2c3d4e`
|
||||
- Projekt-Setup
|
||||
- Erste Analyse
|
||||
```
|
||||
|
||||
### 2. Tea CLI für Gitea
|
||||
|
||||
Installation und Konfiguration der offiziellen Gitea CLI:
|
||||
|
||||
```bash
|
||||
# Installation
|
||||
sudo curl -fsSL https://dl.gitea.io/tea/0.9.2/tea-0.9.2-linux-amd64 -o /usr/local/bin/tea
|
||||
sudo chmod +x /usr/local/bin/tea
|
||||
|
||||
# Login (einmalig pro Maschine)
|
||||
tea login add --url https://gitea.egonetix.de --token <TOKEN>
|
||||
```
|
||||
|
||||
Ermöglicht:
|
||||
- `tea issues` - Issues auflisten
|
||||
- `tea issues create` - Issue erstellen
|
||||
- `tea comment` - Issue kommentieren
|
||||
- `tea pr` - Pull Requests
|
||||
|
||||
### 3. Session-Start Hook
|
||||
|
||||
`~/dotfiles/claude_settings/hooks/session-start.sh` (erweitert):
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Zeigt WORKLOG.md wenn vorhanden
|
||||
if [[ -f "WORKLOG.md" ]]; then
|
||||
echo "=== PROJECT CONTEXT ==="
|
||||
# Zeige Current State und Next Steps
|
||||
sed -n '/## Current State/,/## Next Steps/p' WORKLOG.md
|
||||
sed -n '/## Next Steps/,/## Key Decisions/p' WORKLOG.md | head -10
|
||||
echo ""
|
||||
|
||||
# Letzte 3 Commits
|
||||
echo "=== RECENT COMMITS ==="
|
||||
git log --oneline -3 2>/dev/null
|
||||
echo ""
|
||||
|
||||
# Gitea Issues (wenn tea konfiguriert)
|
||||
if command -v tea &>/dev/null; then
|
||||
echo "=== OPEN ISSUES ==="
|
||||
tea issues --state open --limit 5 2>/dev/null || echo "(Gitea nicht erreichbar)"
|
||||
fi
|
||||
fi
|
||||
```
|
||||
|
||||
### 4. Skill: `/session-end`
|
||||
|
||||
Strukturiertes Session-Ende:
|
||||
|
||||
1. Sammelt aus Konversation was gemacht wurde
|
||||
2. Fragt nach nächsten Schritten
|
||||
3. Fragt nach wichtigen Entscheidungen
|
||||
4. Updated WORKLOG.md:
|
||||
- Current State
|
||||
- Next Steps
|
||||
- Neuer Session History Eintrag
|
||||
5. Committet WORKLOG.md
|
||||
6. Optional: Kommentiert verknüpftes Gitea Issue
|
||||
|
||||
### 5. Skill: `/session-start` (manuell)
|
||||
|
||||
Für expliziten Session-Start:
|
||||
1. Zeigt WORKLOG.md Kontext
|
||||
2. Zeigt offene Gitea Issues
|
||||
3. Fragt "Woran willst du arbeiten?"
|
||||
4. Aktualisiert "Current State" in WORKLOG.md
|
||||
|
||||
### 6. Skill: `/new-project`
|
||||
|
||||
Für neue Projekte:
|
||||
1. `git init` wenn nötig
|
||||
2. Erstellt WORKLOG.md aus Template
|
||||
3. Erstellt copilot-instructions.md aus Template
|
||||
4. Optional: Erstellt Gitea Issue für das Projekt
|
||||
5. Initial Commit
|
||||
|
||||
---
|
||||
|
||||
## Implementation Steps
|
||||
|
||||
### Phase 1: Grundlagen
|
||||
| # | Was | Dateien |
|
||||
|---|-----|---------|
|
||||
| 1 | Tea CLI installieren | System |
|
||||
| 2 | Tea Login konfigurieren | `~/.config/tea/config.yml` |
|
||||
| 3 | WORKLOG.md Template erstellen | `~/dotfiles/claude_settings/templates/WORKLOG.md` |
|
||||
| 4 | Session-Start Hook erweitern | `~/dotfiles/claude_settings/hooks/session-start.sh` |
|
||||
|
||||
### Phase 2: Skills
|
||||
| # | Was | Dateien |
|
||||
|---|-----|---------|
|
||||
| 5 | Skill `/session-end` erstellen | `~/dotfiles/claude_settings/skills/session-end.md` |
|
||||
| 6 | Skill `/session-start` erstellen | `~/dotfiles/claude_settings/skills/session-start.md` |
|
||||
| 7 | Skill `/new-project` erstellen | `~/dotfiles/claude_settings/skills/new-project.md` |
|
||||
|
||||
### Phase 3: Rollout
|
||||
| # | Was |
|
||||
|---|-----|
|
||||
| 8 | WORKLOG.md für 2-3 aktive Projekte anlegen |
|
||||
| 9 | Workflow auf anderen Maschinen einrichten (Settings-Repo pullen) |
|
||||
|
||||
---
|
||||
|
||||
## Beispiel-Workflow
|
||||
|
||||
```
|
||||
=== MONTAG, DESKTOP ===
|
||||
|
||||
$ cd ~/projects/smart-home
|
||||
$ claude
|
||||
|
||||
[Hook Output:]
|
||||
=== PROJECT CONTEXT ===
|
||||
**Zuletzt:** 2025-01-24 auf laptop
|
||||
**Issue:** #12 - MQTT Integration
|
||||
**Status:** MQTT-Subscription halb fertig
|
||||
|
||||
## Next Steps
|
||||
- [ ] Sensor-Subscriptions implementieren
|
||||
- [ ] Error-Handling
|
||||
|
||||
=== RECENT COMMITS ===
|
||||
a3f2b1c MQTT: Basic connection working
|
||||
b2c3d4e Initial MQTT setup
|
||||
|
||||
=== OPEN ISSUES ===
|
||||
#12 MQTT Integration (in progress)
|
||||
#15 Add temperature dashboard
|
||||
|
||||
Du: "weiter mit den subscriptions"
|
||||
... arbeiten ...
|
||||
|
||||
Du: "/session-end"
|
||||
|
||||
Claude: Ich sehe du hast heute:
|
||||
- Sensor-Subscriptions implementiert (commits e7d4a9f, f8g9h0i)
|
||||
- Error-Handling hinzugefügt
|
||||
|
||||
Was sind die nächsten Schritte?
|
||||
|
||||
Du: "tests und dann das dashboard aus issue 15"
|
||||
|
||||
Claude: Wichtige Entscheidungen heute?
|
||||
|
||||
Du: "ja, wir nutzen QoS level 1 für reliability"
|
||||
|
||||
[WORKLOG.md wird aktualisiert]
|
||||
[Commit: "worklog: session 2025-01-27"]
|
||||
[Issue #12 kommentiert: "Progress: Subscriptions + Error handling done"]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Bonus: Parallele Sessions (Boris Cherny Style)
|
||||
|
||||
Wenn du mehrere Claude-Sessions auf EINER Maschine für das GLEICHE Projekt brauchst:
|
||||
|
||||
```bash
|
||||
# Separate Checkouts statt Branches/Worktrees
|
||||
cd ~/projects
|
||||
git clone git@gitea.egonetix.de:user/repo.git repo-session1
|
||||
git clone git@gitea.egonetix.de:user/repo.git repo-session2
|
||||
|
||||
# Jede Session in eigenem Checkout
|
||||
# Terminal 1: cd ~/projects/repo-session1 && claude
|
||||
# Terminal 2: cd ~/projects/repo-session2 && claude
|
||||
```
|
||||
|
||||
Vorteile:
|
||||
- Keine Merge-Konflikte während der Arbeit
|
||||
- Volle Isolation
|
||||
- Am Ende: Cherry-Pick oder PR mergen
|
||||
|
||||
---
|
||||
|
||||
## Verification
|
||||
|
||||
Nach Implementation testen:
|
||||
|
||||
1. **Tea CLI:** `tea issues` in einem Gitea-Repo ausführen
|
||||
2. **Hook:** Neues Terminal in Projekt mit WORKLOG.md öffnen → Kontext wird angezeigt
|
||||
3. **Skills:** `/session-end` ausführen → WORKLOG.md wird korrekt aktualisiert
|
||||
4. **Cross-Machine:** Settings auf anderer Maschine pullen, gleicher Workflow funktioniert
|
||||
5. **Learnings Test:** Füge einen Fehler zu Learnings hinzu, starte neue Session → Claude sollte ihn berücksichtigen
|
||||
|
||||
---
|
||||
|
||||
## Dateien-Übersicht
|
||||
|
||||
```
|
||||
~/dotfiles/claude_settings/
|
||||
├── templates/
|
||||
│ └── WORKLOG.md # NEU: Template
|
||||
├── hooks/
|
||||
│ └── session-start.sh # ERWEITERN: WORKLOG + Gitea anzeigen
|
||||
└── skills/
|
||||
├── session-end.md # NEU: Session beenden
|
||||
├── session-start.md # NEU: Session starten (manuell)
|
||||
└── new-project.md # NEU: Projekt anlegen
|
||||
```
|
||||
Reference in New Issue
Block a user