joerglohrer
/
joerglohrerde
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
joerglohrerde/.claude/skills/joerglohrerde-workflow.md

7.5 KiB
Raw Blame History

name description
joerglohrerde-workflow Repo-spezifischer Skill für joerglohrerde. Nutze ihn bei jedem Session-Start, um den aktuellen Zustand zu erfassen, Konventionen zu verstehen und wiederkehrende Workflows (Deploy, Publish, Tests, Multilingual) effizient auszuführen.

joerglohrerde — Session-Skill

Dieses Repo ist die persönliche Webseite von Jörg Lohrer: eine dezentrale Nostr-basierte SvelteKit-SPA, die NIP-23-Langform-Events live von Public- Relays rendert. Seit 2026-04-21 mehrsprachig (DE/EN) via svelte-i18n + NIP-33-a-Tags.

Beim Session-Start IMMER zuerst

  1. Lies CLAUDE.md — Agent-spezifische Konventionen (Commit-Stil, Deploy-Falle, Globbing-Hinweise).
  2. Lies docs/STATUS.md — aktueller Projektstand, Live-URLs.
  3. Lies docs/HANDOFF.md — nächste Schritte, Stolperfallen, Alltags-Workflow für neue Posts + Übersetzungen.
  4. Bei konkreten Aufgaben: zugehörige Spec unter docs/superpowers/specs/ oder Plan unter docs/superpowers/plans/.
  5. Branch-Check: git log --oneline -10 main.

Dann erst Rückfragen oder Vorschläge formulieren.

Live-URLs

URL Rolle
joerg-lohrer.de Produktion, SvelteKit-SPA (Cutover 2026-04-18, multilingual seit 2026-04-21)
staging.joerg-lohrer.de Pre-Prod-Build
svelte.joerg-lohrer.de Entwicklungs-Deploy-Target (historischer Default)
spa.joerg-lohrer.de Vanilla-HTML-Spike (historisch)

Wichtig: scripts/deploy-svelte.sh hat DEPLOY_TARGET=svelte als Default — das zielt auf svelte.joerg-lohrer.de, NICHT auf die Produktion. Für Prod-Deploy IMMER DEPLOY_TARGET=prod explizit setzen.

Git-Branches

  • main — kanonisch, alle Arbeit läuft hier direkt.
  • hugo-archive — Orphan, eingefrorener Hugo-Zustand (Rollback-Option).

spa aus der Pre-Cutover-Phase ist gemerged und historisch.

Sprache und Ton

  • Antworten und Commit-Messages auf Deutsch (Kundensprache).
  • Code-Identifier (Variablen, Funktionen, Typen) auf Englisch.
  • Kurz und konkret — Jörg ist technisch versiert, erwartet keine Grundlagen-Erklärungen.
  • Commit-Präfixe: feat, fix, chore, docs, test (conventional).
  • Co-Author: Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>.

Kernkonventionen

Content-Struktur

  • Markdown-Posts pro Sprache: content/posts/<lang>/<slug>/index.md.
  • Slug ist global eindeutig (also NICHT identisch zwischen Sprach-Varianten). Der Slug wird zum d-Tag des Events und zur URL (/<slug>/).
  • Sprach-Differenzierung über l-Tag (NIP-32), nicht über den Slug.
  • Bidirektionale Verlinkung zwischen Sprach-Varianten via a:-Frontmatter, wird als ['a', '<coord>', '', 'translation'] ins Event geschrieben.

URL-Schema

  • Post-URL: /<slug>/ (z. B. /bibel-selfies/, /bible-selfies/). Keine Sprach-Präfixe in der URL.
  • Legacy-Hugo-URLs /YYYY/MM/DD/<dtag>.html/ werden 301-redirected.
  • Tag-Route: /tag/<name>/.

Nostr-Konstanten

  • Pubkey (hex): 4fa5d1c413e2b45e10d40bf3562ab701a5331206e359c90baae0e99bfd6c6e41
  • npub: npub1f7jar3qnu269uyx5p0e4v24hqxjnxysxudvujza2ur5ehltvdeqsly2fx9
  • Bootstrap-Relay: wss://relay.damus.io
  • Relay-Liste: aus kind:10002 des Autors (zur Laufzeit geladen).
  • Blossom-Server: aus kind:10063 des Autors.
  • Zentralisiert in app/src/lib/nostr/config.ts bzw. .env.local.

Signing

  • Im Browser (Kommentare): NIP-07 via Extension (Alby, nos2x).
  • Aus der Kommandozeile (Publish): NIP-46 via Amber-Bunker.
  • Privater Schlüssel nie im Repo, nie in CI-Secrets direkt.

Wiederkehrende Kommandos

SPA-Entwicklung

cd app
npm run dev                # Dev-Server localhost:5173
npm run check              # Type-Check (svelte-check)
npm run test:unit          # Vitest
npm run test:e2e           # Playwright
npm run build              # Prod-Build nach app/build/

Publish-Pipeline

cd publish
deno task check                                  # pre-flight (Bunker, Relays, Blossom)
deno task publish --dry-run                      # diff-modus simulation
deno task publish                                # diff-modus real
deno task publish --force-all                    # alle 27 Posts
deno task publish --post <slug>                  # einzelner Post
deno task delete --event-id <hex> --reason "…"   # NIP-09-Löschung
deno task validate-post ../content/posts/<lang>/<dir>/index.md
deno task test                                   # Tests (73)

Deploy

DEPLOY_TARGET=staging ./scripts/deploy-svelte.sh   # Pre-Prod
DEPLOY_TARGET=prod    ./scripts/deploy-svelte.sh   # Prod (joerg-lohrer.de)

Nostr-Status checken

# Alle publizierten kind:30023-Events des Autors (inkl. l-Tag + a-Tags)
nak req -k 30023 -a 4fa5d1c413e2b45e10d40bf3562ab701a5331206e359c90baae0e99bfd6c6e41 wss://relay.damus.io 2>/dev/null | jq -c '{d: (.tags[] | select(.[0]=="d") | .[1]), l: (.tags[] | select(.[0]=="l") | .[1]), title: (.tags[] | select(.[0]=="title") | .[1])}'

Tech-Stack-Eigenheiten, die man kennen muss

  1. Svelte 5 Runes: $props()-Werte via $derived() in lokale Variablen. $effect(() => { … event.id }) statt onMount, wenn bei Prop-Änderung neu geladen werden muss (siehe [...slug]/+page.svelte).

  2. applesauce-relay v5.x API: RxJS-basiert. pool.request(relays, filter) liefert Observable<NostrEvent>. Die Loader in app/src/lib/nostr/loaders.ts nutzen toArray() + lastValueFrom + timeout + catchError-Pattern.

  3. DOMPurify braucht DOM: Early-Fail-Guard für Node-Aufrufe im renderMarkdown-Helper. SSR ist ohnehin aus (ssr = false im Layout).

  4. All-Inkl-FTPS-Bug: Data-Connection bricht bei TLS 1.3 ab. --tls-max 1.2 im curl-Call. Sobald SSH auf All-Inkl verfügbar ist (Premium-Tarif angefragt), Umstellung auf rsync möglich.

  5. Amber-Bunker-Session: bei neuer Bunker-URL müssen globale Permissions in Amber auf „Allow + Always" für get_public_key und sign_event gesetzt werden.

  6. Forgejo→GitHub Push-Mirror: git push geht nach Forgejo, die Action läuft auf GitHub (nachdem Forgejo gespiegelt hat). Push → Mirror → Action braucht typisch 1–2 Minuten.

  7. svelte-i18n + activeLocale: $t('key') in Templates, get(t)('key') in imperativem Script-Code. activeLocale ist der projekteigene Store (persistiert via localStorage), locale aus svelte-i18n wird automatisch synchronisiert.

  8. zsh-Globbing: Pfade mit eckigen Klammern (z. B. app/src/routes/[...slug]/) müssen in git add in einfachen Anführungszeichen stehen, sonst interpretiert zsh das als Glob-Pattern.

Wie mit Jörg arbeiten

  • Kurze Antworten, konkrete Optionen, keine Grundlagen-Erklärungen.
  • Bei mehreren Wegen: 2–3 Varianten mit Empfehlung nennen, nicht alles aufzählen.
  • Spec-Updates auf main committen, dort läuft alle Arbeit.
  • Nach Feature-Commits: Build + Deploy, damit Jörg live sehen kann. UI-Feedback fängt Layout-Fragen ab, die Tests nicht entdecken.
  • Vor Subagent-Dispatch: kritische API-Details verifizieren (Plan-Annahmen können veraltet sein).

Credentials / Secrets

Alle in .env.local (gitignored):

  • BUNKER_URL — Amber-NIP-46-Pairing für Signaturen
  • CLIENT_SECRET_HEX — identisch mit GitHub-Secret (stabile App-ID in Amber)
  • AUTHOR_PUBKEY_HEX, BOOTSTRAP_RELAY
  • SVELTE_FTP_*, STAGING_FTP_* — FTPS-Credentials pro Deploy-Target

Falls neue Bunker-URL nötig (Amber-Session kaputt):

  • In Amber neue Bunker-URL generieren
  • In .env.local ersetzen
  • In Amber globale Permissions für die App löschen, sonst hängt der Request