mesh-configs/skills/devops/projekt-planung/SKILL.md

name, description, version, author, platforms

name	description	version	author	platforms
projekt-planung	Neues Webprojekt konzipieren: Domain, Landingpage, Konzept-Markdown, PDF-Export, iterative Verfeinerung mit User	1.0.0	Agent A	linux

Projekt-Planung — Vom Brainstorming zur Landingpage

Workflow für neue Webprojekte auf dem netcup VPS: Konzept im Chat entwickeln, als Markdown speichern, Landingpage aufsetzen, bei Bedarf PDF generieren.

---

Schritt 1: Brainstorming IM CHAT

• Alles direkt im Telegram-Chat besprechen — nicht in Dateien verstecken
• User gibt Ideen, ich strukturiere und mache Gegenvorschläge
• Architektur-Skizzen als ASCII-Art im Chat
• Tabellen für Vergleiche (z.B. Tech-Stack-Entscheidungen)
• User-Feedback sofort einarbeiten

---

Schritt 2: Konzept-Dokument

Sobald die Richtung klar ist: /root/<projekt>-konzept.md anlegen mit:

# Projektname

> Domain, Preis, Repo, Stand

## Vision
## Datenquellen / Architektur
## Tech-Stack
## Features
## Roadmap (Phasen)
## Offene Punkte (Checkliste mit [ ] und [x])

---

Schritt 3: Landingpage aufsetzen

mkdir -p /var/www/<domain>/html
chown -R www-data:www-data /var/www/<domain>

# nginx VHost
cat > /etc/nginx/sites-available/<domain> << 'EOF'
server {
    server_name <domain>;
    root /var/www/<domain>/html;
    index index.html;
    location / { try_files $uri $uri/ =404; }
    listen 80;
}
EOF
ln -sf /etc/nginx/sites-available/<domain> /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

# SSL
certbot --nginx -d <domain> --non-interactive --agree-tos --email admin@<hauptdomain> --redirect

Landingpage-Inhalt: Projektname, Slogan, Kern-Features (Grid), Roadmap, Footer mit Links zu verwandten Projekten.

Stil: Dark-Theme, grüne Akzente (#10b981), responsive, auf Deutsch.

---

Schritt 4: PDF bei Bedarf

User will manchmal PDF zum Mitnehmen. PDF ist BONUS, nicht Ersatz für Chat-Inhalt.

wkhtmltopdf /tmp/<projekt>.html /tmp/<Projekt>_Konzept.pdf

• HTML aus Markdown generieren mit deutschem CSS
• Als MEDIA:/pfad senden
• Vorher IMMER den Inhalt im Chat präsentieren

---

Schritt 5: Iteratives Verfeinern

• User-Feedback → Konzept-Markdown patchen → PDF neu generieren
• Version hochzählen (v1, v2, v3...)
• Offene Punkte als Checkliste pflegen ([x] wenn erledigt)
• Tech-Entscheidungen mit Pro/Contra-Tabelle dokumentieren

---

Redesign bestehender Website (Live-Prototyp-Workflow, 2026-08-04)

Wenn ein User eine bestehende Live-Site „langweilig" findet und ein neues Look & Feel will:

1. Aktuelle Site zuerst ansehen (curl auf die URL, vhost ansehen) — verstehen, was JETZT da ist, bevor man irgendwas ändert.
2. 3–4 klar unterschiedliche Design-Richtungen im Chat anbieten (je ein Name + kurzes Look-&-Feel + Wirkung), z.B.:
   • Glassmorphism/Frost (Milk-Glass, Blur, sanfte Farbverläufe)
   • Arcade/Retro-Pixel (CRT, Pixel-Font, LCD-Score)
   • Minimal/Swiss (riesige Typografie, 2 Farben)
   • Upgrade des aktuellen Stils (gleiche Richtung, aber Lebendigkeit) Nutzer wählt eine — nicht alle gleichzeitig umsetzen.
3. Vor dem Übernehmen des Originals sichern:

   cp /var/www/<site>/html/index.html /var/www/<site>/html/index-original.html.bak
   

   ⚠️ Pitfall (Grundregel „nicht destruktiv"): NIE ohne Backup über die laufende index.html schreiben. Backup zuerst, Prototyp danach.
4. Spiel-/App-Logik unangetastet lassen, nur CSS + Farben tauschen. Welche Richtung auch gewählt wird — das JS (Engine, KI, Score) 1:1 übernehmen, damit der Prototyp voll funktioniert.
5. Live deployen auf /var/www, danach echt verifizieren: curl (HTTP 200) + Browser öffnen und klicken (ein Feld → KI antwortet) statt nur auf Curl zu vertrauen. Nach write_file chown www-data:www-data + chmod 644 nicht vergessen (sonst 403).
6. Wenn dabei ein SSL-Zert-Mismatch auffällt → siehe web-hosting-deployment-Skill (ERR_CERT_COMMON_NAME_INVALID / eigenes Subdomain-Zert).

---

Häufige User-Präferenzen

Präferenz	Umsetzung
Alles auf Deutsch	Prompt, UI, Doku — nie Englisch
Keine Rohdaten im Chat	Terminal-Outputs verarbeiten, nicht roh zeigen
PDF nur als Bonus	Erst Chat-Inhalt, dann Datei
Keine „Premium"-Features	100% kostenlos erwähnen
Dark-Theme für Landingpages	#0a0a14 Hintergrund, grüne Akzente

---

Verzeichnisse auf dem VPS

/var/www/<domain>/html/          — Landingpage
/root/<projekt>-konzept.md       — Konzept-Dokument
/etc/nginx/sites-available/<domain> — nginx VHost