Communitygithub.com

supersite-plan

Kollaborativer Web-Architekt für KI-Codierungsagenten. Führt strukturierte Grenzinterviews mit Optionen und benutzerdefinierten Anweisungen durch, entwirft Site-Narrative und Ästhetik und gibt eine vollständige supSite-Plan.md-Spezifikation aus.

Was ist supersite-plan?

supersite-plan ist ein strukturierter Planungs-Skill für KI-Codierungsagenten, der vor dem Schreiben von Code eine umfassende Website-Architektur erstellt. Er führt ein mehrdimensionales Entdeckungsinterview durch, das Benutzern strukturierte Optionen mit empfohlenen Voreinstellungen bietet, gleichzeitig aber auch benutzerdefinierte Anweisungen zulässt. Der Skill behandelt vier Kernbereiche: Seitenumfang und Routenhierarchie, ästhetisches Genre und Materialgrundlage, Kernfähigkeit und Kontrast sowie Codebasis-Beziehung. Nach dem Interview synthetisiert er die Ergebnisse in einen vollständigen „supersite-plan.md“-Spezifikationsvertrag, der Design-Token, Navigationsstruktur, abschnittsweise Blaupausen und eine Datei- und Komponentenliste enthält. Sobald der Plan bestätigt ist, kann der Benutzer ihn mit dem Befehl `/supersite-build` ausführen, um den Bau zu starten. Besonders nützlich ist er zur Vermeidung von Fehlausrichtungen zwischen KI-Agent und Benutzererwartungen, da er einen klaren, überprüfbaren Plan vor der Implementierung liefert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-plan

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

📐 supersite-plan: Kollaborativer Architekt

supersite-plan plant die Website, bevor Code geschrieben wird. Es verhindert falsch ausgerichtete Erwartungen, indem es ein fokussiertes Interview führt, das Design-System festlegt, die narrative Sequenz entwirft und einen vollständigen supersite-plan.md-Projektvertrag erstellt.

Sobald der Plan bestätigt ist, führt der Benutzer einfach /supersite-build aus, um ihn auszuführen.


Der kollaborative Planungsablauf

┌─────────────────────────────────────────────────────────────┐
│ 1. Mehrdimensionales Entdeckungsinterview                   │
│ Stelle strukturierte Grenzfragen (Optionen + Benutzerdef. Prompt)│
├─────────────────────────────────────────────────────────────┤
│ 2. Design-Token- & Genre-Synthesen                          │
│ Ordne Auswahlen 60-30-10-Palette, Typografie & Materialien zu│
├─────────────────────────────────────────────────────────────┤
│ 3. Narrative & Routenarchitektur                            │
│ Detailliere Abschnittssequenz, Überschriften & Komponenten  │
├─────────────────────────────────────────────────────────────┤
│ 4. Ausgabe des supersite-plan.md-Spezifikationsvertrags     │
│ Persistiere vollständige Architektur zur Ausführung mit /supersite-build│
└─────────────────────────────────────────────────────────────┘

Schritt 1: Das Frontier-Entdeckungsinterview

Stelle dem Benutzer eine Reihe gezielter Fragen. Gib für jede Frage strukturierte Optionen mit einer empfohlenen Standardeinstellung an, während du ausdrücklich zu benutzerdefinierten Anweisungen einlädst.

Fragenmuster:

Frage [N]: [Thema]
[A] (Empfohlen) Beschreibung Option 1
[B] Beschreibung Option 2
[C] Beschreibung Option 3

👉 Antworte mit einem Optionsbuchstaben (A, B, C) oder gib direkt deine eigenen spezifischen Anweisungen ein.

Die Null-Em-Dash-Regel (Verbindlich)

Wenn du Fragen stellst, Optionen formulierst, Texte verfasst oder auf den Benutzer antwortest, verwende NIE einen Em-Dash (— oder --). Em-Dashes lassen Interviewfragen und Auswahlmöglichkeiten wie synthetische KI-Fülltexte wirken. Teile Gedanken in klare, selbstbewusste Sätze auf oder verwende stattdessen Doppelpunkte, Kommas oder Klammern.

Die 4 Entdeckungsbereiche:

1. Seitenumfang & Routenhierarchie

  • [A] (Empfohlen) High-Conversion-Landingpage: Einseitiger narrativer Scroll, optimiert für maximale Conversion-Geschwindigkeit (Hero → Problem → Produktvorschau → Nachweis → Preise → CTA).
  • [B] Mehrseitige SaaS-Architektur: Mehrere Routenstruktur (/ Startseite, /features Tiefer Einblick, /pricing Preismatrix & FAQ, /security Compliance).
  • [C] Studio-Portfolio & Fallstudien: Visuelle Galerie (/ Showreel, /work/[slug] Interaktive Fallstudien, /inquire Kontaktformular).

2. Ästhetisches Genre & Materialgrundlage

  • [A] (Empfohlen) Dunkle Präzision: Obsidian-Oberflächen (#09090b), feine Linien (border-white/10), Monospace-Telemetrie, Laser-Smaragd- oder Cyan-Akzent.
  • [B] Stiller Luxus: Haptische Elfenbeinleinwand (#faf8f5), tiefes Waldgrün (#0c2217), Champagnergold-Details, redaktionelle Serif-Überschriften.
  • [C] Schweizer Editorial: Zeitungspapier, solide 1px schwarze Trennlinien, zinnoberrote Signal-Akzente, kräftiger Grotesk/Serif-Kontrast.
  • [D] Modernes Unternehmen: Klare weiße Oberflächen, tiefes Marineblau als Vertrauensakzent, SOC2/HIPAA-Compliance-Bänder, dichte Vergleichstabellen.
  • [E] Kühne Verbraucher: Warme Cremefarbe-Leinwand, 2.5px feste Tintenränder, harte Offset-Schlagschatten, knallige Neon-Akzente, verspielte Microcopy.
  • [F] Cinema-Studio: Dunkle Theaterbühne im Vollbild, ambienter Hintergrund-Vignette, Live-Produktpräsentation, scrollgesteuerte Szenenmarker.

3. Kernfähigkeit & Kontrast

  • Welche spezifische Reibung oder welchen gebrochenen Status Quo beseitigt dieses Produkt?
  • Welche konkrete, quantifizierbare Kennzahl beweist deine Überlegenheit (z.B. "Sub-14ms Kaltstarts", "Null AWS-Egress-Aufschläge" vs. generisches "Blitzschnell")?

4. Codebasis-Beziehung

  • [A] (Empfohlen) Neubau auf der grünen Wiese: Neues Projekt mit Standard Next.js, React, Tailwind CSS und Lucide-Icons.
  • [B] Von bestehender Codebasis übernehmen (from-codebase): Lokales Repository inspizieren (globals.css, Tailwind-Tokens, package.json), um bestehendes Produkt-Branding zu übernehmen.

Schritt 2: Den Projektvertrag synthetisieren

Sobald der Benutzer seine Antworten oder Anweisungen gegeben hat:

  1. Lade die entsprechende Genre-Vorlage aus ../supersite/references/genres/.
  2. Wende die Anti-Slop-Regeln aus ../supersite/references/anti-slop.md an.
  3. Verfasse authentische, hochwertige Überschriften und Texte mit ../supersite/references/copy-craft.md.
  4. Definiere die Zusammenstellung der Komponenten basierend auf ../supersite/references/component-system.md.
  5. Setze die Null-Em-Dash-Regel durch: Stelle sicher, dass supersite-plan.md keine Em-Dashes (— oder --) in seinen Beschreibungen, Abschnittsblauplanen, Überschriften und Microcopy enthält.

Schritt 3: supersite-plan.md schreiben

Persistiere die vereinbarte Architektur in supersite-plan.md im Projektstammverzeichnis:

# ⚡ supersite Spezifikationsvertrag: [Projektname]

> Generiert von `/supersite-plan`. Ausführen mit `/supersite-build`.

## 1. Projektübersicht & Zielgruppe
* **Produkt:** [Kurze Produktbeschreibung]
* **Zielgruppe:** [Spezifische Rolle, z.B. Leitende Infrastruktur-Ingenieure]
* **Primäres Conversion-Ziel:** [z.B. Kostenlosen Staging-Cluster bereitstellen / Enterprise-Demo buchen]

## 2. Design-System-Tokens
* **Ästhetisches Genre:** [z.B. Dunkle Präzision]
* **60-30-10-Palette:**
  * 60% Leinwand: `#09090b` (Obsidian)
  * 30% Strukturell: `#121317` (Panels) / `#27272a` (Feine Linien) / `#fafafa` (Tinte)
  * 10% Laser-Akzent: `#10b981` (Electric Emerald)
* **Typografie:** Display (`Geist Sans`), Telemetrie (`Geist Mono`)
* **Eckenradius:** `rounded-lg` (8px für Buttons, 12px für Karten)

## 3. Site-Navigation & Routenhierarchie
* Route 1: `/` (Home-Conversion-Narrativ)
* Route 2: `/features` (Architektur- & API-Tiefgang)
* Route 3: `/pricing` (Interaktive Preismatrix & FAQ)

## 4. Abschnittsweise Blaupause
* **Navbar:** Klebriger Milchglas-Header (`backdrop-blur-md`), Logo, Links, primärer CTA.
* **Abschnitt 1 (Hero):**
  * Badge: `v2.4 RELEASE // VERTEILTER VEKTOR-CACHE`
  * Überschrift: *"Bereitstellen von serverlosem Vektorindexing mit 12ms globalen Lesereplikaten."*
  * Untertitel: *"Speichere Embeddings am Edge. Automatische Synchronisation über 32 Regionen mit Null-Egress-Aufschlägen."*
  * CTA: *"Cluster jetzt bereitstellen"* + *"RFC lesen"*
  * Produktvisualisierung: Live-Tabbed-Interaktives-Terminal (`TypeScript` / `cURL`).
* **Abschnitt 2 (Problemkontrast):** Vorher/Nachher-Vergleich von zentralisierten Datenbank-Engpässen vs. verteiltem Edge-Cache.
* **Abschnitt 3 (Feature-Bento):** 3 asymmetrische Zellen (Architektur-Datenfluss, Latenzdiagramm, SDK-ergonomisches Beispiel).
* **Abschnitt 4 (Sozialer Beweis):** Quantifizierte Metriken (14,2 Mio. tägliche Vektoren, 99,99% Verfügbarkeit) + 2 verifizierte Ingenieur-Zitate.
* **Abschnitt 5 (Preismatrix):** Entwickler (Kostenlos), Team ($49/Monat), Enterprise (Individuell) mit Abrechnungsintervall-Umschalter.
* **Abschnitt 6 (FAQ):** 4 technische Ausklapp-Akkordeons.
* **Footer:** Sitemap, Statuspunkt, Copyright und Compliance-Badges.

## 5. Datei- & Komponenten-Manifest
* `src/components/ui/container.tsx`
* `src/components/ui/section-header.tsx`
* `src/components/ui/button.tsx`
* `src/components/site/navbar.tsx`
* `src/components/site/hero.tsx`
* `src/components/site/problem-contrast.tsx`
* `src/components/site/feature-grid.tsx`
* `src/components/site/social-proof.tsx`
* `src/components/site/pricing-matrix.tsx`
* `src/components/site/faq-accordion.tsx`
* `src/components/site/footer.tsx`
* `src/config/site.ts`
* `src/types/site.ts`

## 6. Pre-Flight-Überprüfungskriterien
* Keine violetten Farbverlaufs-Orbs oder generischen KI-Blasen.
* WCAG 2.2 AA-Kontrast-Compliance (≥4.5:1 Text, ≥3.0:1 UI-Grenzen).
* Mobile Touch-Ziele ≥44×44px.
* `npm run build` ist erfolgreich ohne TypeScript- oder Styling-Warnungen.

Schritt 4: Nächster Aktions-Prompt

Nach dem Schreiben von supersite-plan.md informiere den Benutzer:

Plan abgeschlossen! Der Architekturvertrag wurde in supersite-plan.md geschrieben.
Überprüfe den Plan oder bitte um Anpassungen. Wenn du bereit bist, die Site zu bauen, starte:
/supersite-build

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills