---
name: projekt-planung
description: "Neues Webprojekt konzipieren: Domain, Landingpage, Konzept-Markdown, PDF-Export, iterative Verfeinerung mit User"
version: 1.0.0
author: Agent A
platforms: [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:

```markdown
# Projektname

> Domain, Preis, Repo, Stand

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

---

## Schritt 3: Landingpage aufsetzen

```bash
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.**

```bash
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:**
   ```bash
   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
```