Der Website-Plan

PLAN.md wird in dem Moment geschrieben, in dem der erste Build eines Projekts fertig ist, und soll immer die Website so beschreiben, wie sie gerade ist – nicht ein Protokoll alles, was je passiert ist (dafür gibt es den Tab Versionen und das Änderungsprotokoll). Der Website-Plan-Bildschirm verwandelt dieses Markdown in echte Oberflächenelemente: eine Tabelle für Seiten, eine Liste für Module, eine Checkliste für offene Fragen und einfachen Text für Geschäftsfakten, Marke und Entscheidungen.

Bevor ein Build abgeschlossen ist, gibt es noch nichts zu lesen: Der Bildschirm zeigt »Noch kein Plan«, erklärt klar, dass der Plan vom ersten Build des Projekts geschrieben wird, und verlinkt zurück zur Projektseite, statt eine leere Tabelle anzuzeigen.

Eine Website, deren Dateien ohne Plan eingegangen sind (über den Connector aus einem anderen KI-Tool veröffentlicht, importiert oder hochgeladen), erhält trotzdem einen Plan: Der Bildschirm beginnt den Plan mit dem Projektbriefing, den Auswahlen aus dem Kit und den gemessenen Seiten. Ein Banner »Dieser Plan wurde für dich begonnen« bietet »Diesen Plan speichern« an, wodurch er zum echten Plan des Projekts wird und jeder Abschnitt bearbeitet werden kann. »Vollständigen Website-Plan lesen« führt zurück zum Plan-Dokument im Tab Plan & Briefing.

Werkzeuge, die später über das Kit hinzugefügt werden (Zum Plan hinzufügen), erscheinen in der Modulliste als »Geplant« mit einem Link »Im Kit ansehen«, selbst wenn der Plantext vor dem Hinzufügen geschrieben wurde.

Unter dem Titel steht eine Zeile, die angibt, wann der Plan zuletzt aktualisiert wurde: »Plan aktualisiert 2. Okt., 15:04«. Diese Zeit stammt von der letzten Messung der echten Dateien der Website durch aiKit, die nach jeder Änderung erfolgt (eine Chat-Bearbeitung, ein Pin, ein Kit-Hinzufügen, eine Wiederherstellung, eine manuelle Änderung des Plans oder eine Veröffentlichung aus einem anderen KI-Tool).

Ganz oben, sobald ein Plan existiert: ein Gesamtfortschrittsbalken in Prozent und darunter drei Kacheln: Erstellte Seiten (von geplanten Seiten), Erstellte Module (von ausgewählten Modulen) und Beantwortete Fragen (von den offenen Fragen des Plans). Jede Kachel ist eine Schaltfläche, die zu dem Abschnitt scrollt, den sie zählt. Nichts davon wird vom Plantext selbst gemeldet: Eine Seite gilt nur dann als erstellt, wenn aiKit sie in den echten Dateien der Website gefunden hat; ein Modul gilt nur als erstellt, wenn es im verifizierten Build-Bericht steht oder in den Dateien gefunden wurde; und eine Frage gilt als beantwortet, wenn ihre Zeile im Plan abgehakt ist oder der Kunde sie auf seiner Fragenseite beantwortet hat.

Zwei Dinge sorgen dafür, dass der Plan veraltet, und der Bildschirm zeigt, welches: Der KI-Durchlauf, der den Plan nach einer Änderung neu schreibt, wurde nicht abgeschlossen ("Der geschriebene Plan wurde nach der letzten Änderung nicht aktualisiert", mit dem Grund), oder die Website hat eine neuere Version als die, mit der der Plan zuletzt abgeglichen wurde ("Die Website hat sich geändert, nachdem dieser Plan zuletzt aktualisiert wurde"). In beiden Fällen erscheint die Schaltfläche "Plan aktualisieren". Die Seite führt sie beim Öffnen nie von selbst aus (das Öffnen einer Seite nutzt nie KI); die Engine übernimmt jede Änderung ohnehin im Hintergrund in den Plan, und die Schaltfläche ist für den Fall da, dass das ins Hintertreffen geriet. "Plan aktualisieren" übernimmt die neueste Änderung in den geschriebenen Plan und misst die Website erneut. Klappt es immer noch nicht, bleibt der Hinweis mit der Fehlerbeschreibung stehen, und du kannst erneut auf "Plan aktualisieren" drücken oder den Plan von Hand bearbeiten.

Die Karte "Zustand" bewertet die Website mit einer Punktzahl von 100 anhand von Regeln, die aiKit in den echten Dateien prüft, nie anhand der Meinung der KI: ein fehlender oder doppelter Seitentitel oder doppelte Suchbeschreibung, eine Seite ohne oder mit mehr als einer Hauptüberschrift, ein Link zu einer nicht existierenden Seite, eine Seite, auf die nichts verlinkt und die im Menü fehlt, Bilder ohne Beschreibung für Screenreader, sehr kurze Seiten, ein Formular ohne Ziel für die Übermittlung sowie ein Modul, das im Briefing verlangt wird, aber nicht auf der Website ist. Jedes Problem nennt die Seite und erklärt, warum es wichtig ist, und hat eine Schaltfläche "Beheben": "Beheben" sendet die fertige Anweisung des Problems als Anfrage an die KI, die Schaltfläche zeigt während der Arbeit "Behebung angefordert", und die Punktzahl wird neu gemessen, sobald die Änderung übernommen ist. Filtere die Liste nach Schweregrad mit den Zählern Hoch, Mittel und Niedrig; "Alle anzeigen" hebt den Filter wieder auf.

Die Sitemap zeigt die Website als Baum: oben die Startseite, darunter das Menü in der Reihenfolge, dann Seiten, die von diesen Seiten aus erreicht werden. Seiten, auf die nichts verlinkt, stehen in einer eigenen Gruppe. Seiten, die der Plan auflistet, aber noch nicht erstellt sind, werden gestrichelt gezeichnet und als Geplant markiert. Erstellte Seiten, die der Plan nicht erwähnt, sind mit "Nicht im Plan" markiert und haben eine Schaltfläche "Zum Plan hinzufügen", die sie dem Abschnitt Seiten hinzufügt.

Tippe auf eine beliebige Seite (in der Sitemap oder der Seitenliste), um ihre Details neben dem Plan zu öffnen. Die Adressleiste wechselt zu ?page=/about, sodass der Link für jedes Teammitglied dieselbe Seite öffnet. Die Details zeigen, wie die Seite in Google aussieht (Titel, Adresse, Beschreibung), ihre Abschnitte und Hauptüberschriften, die Wortanzahl, Bilder und wie viele davon keine Beschreibung haben, ihre Formulare und welches Kit-Modul sie betreibt, ob der Kunde sie freigegeben hat, sowie die letzte Änderung: wann, wer sie angefordert hat und was angefordert wurde.

Der Verlauf listet die Versionen auf, die aiKit speichert (das Original und die neuesten 10), neueste zuerst: ihre Nummer, welche Art von Änderung es war (Erster Aufbau, Chat, Pin, Kit, Veröffentlicht, Wiederherstellen, Planbearbeitung), wann, was angefordert wurde, wer es angefordert hat und welche Seiten sich geändert haben (tippe auf eine Seite, um ihre Details zu öffnen). Die neueste ist als Aktuelle Version markiert; jede ältere hat "Diese Version wiederherstellen", was zuerst nachfragt und den aktuellen Stand speichert, bevor die Website zurückgesetzt wird, sodass eine Wiederherstellung rückgängig gemacht werden kann. Die ersten drei werden angezeigt; "Alle anzeigen" listet den Rest.

Der Abschnitt Geschäftsdaten vergleicht Telefon, E-Mail, Adresse und Öffnungszeiten in der Kundenakte mit dem Text der erstellten Seiten (zuerst Startseite und Kontakt). Jeder Wert zeigt "Auf der Website" oder "Auf der Website nicht gefunden" (mit der Anzahl geprüfter Seiten, da die Website möglicherweise einen alten Wert zeigt), und ein Link "In der Kundenakte bearbeiten" stellt sicher, dass die Kundenakte die maßgebliche Quelle bleibt.

• Seiten — eine Tabelle mit Seite, Pfad, Zweck und Status (Erstellt oder Geplant), mit einem echten Link "Ansehen" zur Live-Seite, sobald sie erstellt und die Website online ist.
• Module und Werkzeuge — jedes Modul, das der Plan auflistet, mit einem Etikett Erstellt oder Geplant und eigenem Hinweis.
• Geschäftsdaten — Öffnungszeiten, Adresse, Leistungen, Preise und alles andere Sachliche über das Unternehmen, als einfacher Text geschrieben.
• Marke — die Farbpalette, der Tonfall und alle Stilhinweise, die der Plan festgehalten hat.
• Entscheidungen — echte Festlegungen, die getroffen wurden und bei der nächsten Bearbeitung nicht erneut infrage gestellt werden sollten.
• Offene Fragen — eine Checkliste mit Dingen, die wirklich noch nicht entschieden sind, jeweils mit der Anzeige beantwortet oder noch offen.

Jede Abschnittskarte hat dieselben zwei Schaltflächen. "Bearbeiten" öffnet das Markdown des Abschnitts in einem einfachen Textfeld und speichert es direkt zurück in PLAN.md. Das ist ein echtes, sofortiges Schreiben (über den eigenen PUT-Endpunkt des Projekts), löst aber bewusst keinen Build und kein Deployment aus; es ändert nur, was das Plandokument sagt, so wie das Bearbeiten jeder anderen Notiz.

"Änderung anfragen" funktioniert bewusst anders: Es öffnet ein kleines Formular ("Was soll in <section> geändert werden?"), und beim Senden landet eine echte Anfrage im Feedback-Tab des Projekts – beschriftet mit "Seitenplan — <Section>: …" – genau wie jede Markierung oder Schnellbearbeitung. Sie hat einen eigenen Statusverlauf, und sobald sie gesendet ist, erscheint ein Link "Anfrage ansehen". Nutze Bearbeiten, wenn du den Text des Plans selbst korrigieren oder umschreiben möchtest. Nutze Änderung anfragen, wenn die eigentliche Website (und damit auch der Plan) an den neuen Stand angepasst werden soll.

Der Plan hat zwei Ebenen. Die Messwerte (Seiten, Titel, Abschnitte, Links, Formulare, Module, Zustand) werden nach jeder Änderung vom Code aus den echten Dateien erfasst, sodass sie nicht auseinanderlaufen können. Der geschriebene Plan (Ziele, Geschäftsdaten, Marke, Entscheidungen, offene Fragen) wird von einem KI-Durchlauf aktuell gehalten, der nach jeder Änderung läuft und nur die Teile neu schreibt, die die Änderung betroffen hat. Er fügt nie ein Änderungsprotokoll oder datierte Einträge hinzu; der Verlauf ist der Ort, an dem die Änderungen festgehalten werden.

Wenn dieser KI-Durchlauf fehlschlägt, bleibt der geschriebene Plan so, wie er war, statt halb überschrieben zu werden, der Fehler wird protokolliert, und der Bildschirm zeigt stattdessen Plan aktualisieren (siehe oben) an, anstatt stillschweigend einen veralteten Plan anzuzeigen.

Eine Leiste neben dem Plan enthält die Aktionen (auf dem Handy wird die Leiste zu einer volle Breite einnehmenden Schaltfläche "Kundenlink kopieren" direkt unter dem Fortschrittsbalken, der Rest ist unter "Weitere Aktionen (3)" eingeklappt). "Mit dem Kunden teilen" kopiert einen schreibgeschützten Link (aikit.ai/p/<project>/plan) – ohne Mitarbeiterwerkzeuge, ohne Bearbeitungsschaltflächen, ohne interne Inhalte. "Live-Seite öffnen" ist ein direkter Link zur Live-Seite, oder die Leiste zeigt klar "Noch nicht live", falls sie es nicht ist. "Dateien" zeigt die echte Dateianzahl mit einer aufklappbaren Liste aller Dateipfade und Größen. "Plan herunterladen" lädt die tatsächliche aktuelle PLAN.md als echte .md-Datei herunter, Byte für Byte das, was der Bildschirm liest – keine neu erzeugte Zusammenfassung.

Die Seite des Kunden öffnet sich auf dem Tab Plan: dasselbe Website-Plandokument, das Mitarbeitende auf dem Tab Plan & Briefing sehen (Überblick und Ziele, Zielgruppe, Strategie, Sitemap, jedes Werkzeug mit seinem Nutzen für das Geschäft und seinem Status, Inhaltsplan, Zeitplan, Entscheidungen und offene Fragen), ohne die nur für Mitarbeitende bestimmten Teile: keine Notizen, die beim Hinzufügen eines Werkzeugs getippt wurden, keine Namen, wer was hinzugefügt hat, keine Links in das Kit von aiKit und keine Schaltfläche Plan schreiben. Ein zweiter Tab, Seiten & Freigaben, zeigt die Ansicht Seite für Seite weiter unten.

Auf Seiten & Freigaben, geschützt durch denselben Zugangscode, den Kunden bereits für Feedback nutzen (kein separater Login), sieht ein Kunde dasselbe Fortschrittsband, eine Sitemap seiner Seiten, die Seitenliste mit den Links "Ansehen", die Module, Geschäftsdaten, Marke, Entscheidungen und offenen Fragen sowie eine Zeile "Plan aktualisiert". Er bekommt keinen Zustand, keine Korrekturanweisungen, keinen Verlauf, keine Angaben, wer was angefragt hat, keine Dateiliste und keine Schaltfläche Bearbeiten oder Änderung anfragen.

Alles, was Mitarbeitende nur für sich markieren, wird auf dem Server entfernt, bevor die Seite gesendet wird, in jedem Abschnitt: eine Zeile mit "(internal)", "[internal]" oder "(staff only)", eine Zeile, die mit "Internal:" oder "Staff only:" beginnt, jeder Abschnitt, dessen Überschrift Internal oder Staff only sagt, sowie versteckte Kommentare. Diese Zeilen erreichen den Browser des Kunden niemals, auch nicht in den Netzwerkdaten der Seite.

Jede fertige Seite hat eine Schaltfläche Freigeben. Der Kunde tippt seinen Namen (und optional eine Notiz) und gibt frei; die Freigabe ist an den genauen Inhalt dieser Seite gebunden. Ändert sich die Seite später, zeigt sie "Seit Ihrer Freigabe geändert" und fragt erneut. Nur wer den Zugangscode des Kunden verwendet, kann freigeben. Wenn Sie den Kundenlink öffnen, während Sie als Mitarbeitende angemeldet sind, sehen Sie den Freigabestatus jeder Seite, aber keine Schaltfläche Freigeben, damit niemand im Namen des Kunden freigeben kann. Auf dem Mitarbeiter-Sitemap-Plan zeigen freigegebene Seiten "Vom Kunden freigegeben" und geänderte "Seit Freigabe geändert".

Unten sitzt eine Schaltfläche "Feedback senden": Ist die Seite live, öffnet sie die echte Live-Seite mit bereits aktivierter Feedback-Ebene (mit dem eigenen Zugangscode des Kunden); ist sie noch nicht live, führt sie stattdessen zur Seite Neueste Updates des Kunden.