1Warum das Kit vollständig eingespielt wird
Dieses Dokument ist eine sinngemäße Übersetzung. Maßgeblich ist das Originaldokument auf Französisch; Erweiterungen und Änderungen werden stets dort eingepflegt.
Dieser Leitfaden ist für Sie, nicht für die KI. Er beschreibt, wie ein neues Projekt aus dem Kit heraus gestartet wird.
Vor dem Vorgehen ein wichtiger Punkt: das Kit ist ein zusammenhängendes System. Seine Dateien sind keine unabhängigen Bausteine, die man einzeln auswählen könnte — sie hängen voneinander ab. Jedes Stylesheet hat ein zugehöriges Reference-Dokument, das seinen Gebrauch beschreibt. Das Registry nennt die aktiven Versionen. Der technische Prompt und die gemeinsame Struktur legen den verbindlichen Vertrag fest, den alle Ihre Projektdateien anwenden.
Das Kit teilweise einzuspielen — eine Reference vergessen, ein Stylesheet ohne seine Registry-Angabe ersetzen, einen alten Prompt stehen lassen — erzeugt stille Unstimmigkeiten, die sich erst beim Erzeugen eines Dokuments zeigen. Das Symptom ist dann eine zerbrochene Darstellung oder, schlimmer, verlorener Inhalt.
Einfache Regel: das Kit wird vollständig hochgeladen, so wie es geliefert wird. Alle in §3 aufgeführten Dateien gehen in einem Zug in den Arbeitsbaum. Keine Auswahl nach Belieben, kein Ersetzen Datei für Datei. Diese Regel gilt für die Einrichtung wie für spätere Aktualisierungen.
2Die vorzubereitenden Angaben
Bereiten Sie vor dem Öffnen einer Sitzung die folgenden Angaben vor.
| Angabe | Beispiel | Anmerkung |
|---|---|---|
| Ein kurzes Präfix | Arrosage | Ein Wort, ohne Sonderzeichen. Dieses Präfix erscheint in allen Dateinamen. |
| Der vollständige Projektname | Système d'arrosage | Der Name, der auf den Deckblättern der Dokumente erscheint. |
| Ihr Name | Norbert Weber | Ihr Name erscheint in der Fußzeile jedes Dokuments. |
| Die gewünschte Sprache | FR, EN, DE oder LU | Französisch, Englisch, Deutsch oder Luxemburgisch. Standard ist Englisch für Verbraucherprojekte; das Kit bleibt als dokumentierte Ausnahme auf Französisch. |
3Das Projekt anlegen und das Kit einspielen
Legen Sie ein neues Projekt an. Der Name ist frei. Laden Sie dann sämtliche unten aufgeführten Kit-Dateien ohne Ausnahme in seinen Kontext hoch.
Diese Dateien werden von Ihrem Projekt nicht verändert — sie sind für alle Projekte gleich, die dieses Kit verwenden. Sie liefern die Formatregeln, die dauerhaften Anweisungen und die visuellen Referenzen.
Die projekteigenen Dateien — Registry, Projekt-Prompt, Glossar, angepasstes Deckblatt, etwaige Datenmodule — werden zu diesem Zeitpunkt nicht hochgeladen: sie werden in der ersten Sitzung from scratch aus den verbindlichen Gerüsten von Gemeinsame Struktur erzeugt.
| Kit-Datei | Rolle |
|---|---|
| Kit - Registry.js | Wahrheitsquelle der aktiven Stylesheet-Versionen und der Zeitstempel der Kit-Dokumente. |
| Kit - Projet - Prompt - LANG (TS).docx | Dauerhafte technische Anweisungen — zu Beginn jeder Sitzung gelesen. |
| Kit - Projet - Structure commune - LANG (TS).docx | Verbindlicher Vertrag der Projektdateien und Gerüste der Datenmodule. |
| Kit - Projet - Convention de nommage (TS).docx | Benennungsregeln der Projektdateien, Sprachkürzel eingeschlossen. |
| Kit - Projet - Guide d'initialisation - LANG (TS).docx | Dieser Leitfaden. |
| Kit - Projet - Guide de mise à jour - LANG (TS).docx | Verfahren zur Aktualisierung des Kits. |
| Kit - Documentation - Reading Guide - LANG (TS).docx | Leseleitfaden für den Papierordner. |
| Kit - Documentation - Cover Sheet (TS).docx | Referenz der Darstellungskonstanten des Deckblatts. |
| Kit - Documentation - Cover Sheet - LANG (TS).png | Erzeugtes Deckblatt des Kits — erste Seite des Ordners. |
| Kit - Documentation - Pipeline HTML - LANG (TS).docx | Aufbau der Website, Veröffentlichungsumfang, Regeln des Deployments. |
| Kit - Documentation - Quality Control - LANG (TS).docx | Einzige Referenz der Mechanismen der Qualitätssicherung und der Sitzungsvoraussetzungen. |
| Kit - Documentation - Prompts de dialogue - LANG (TS).docx | Gesprächsbefehle zum Kopieren in den Chat. |
| Kit - Documentation - Comment documenter ses projets - LANG (TS).docx | Anhaltspunkte für die Entscheidungen vor der ersten geschriebenen Zeile. |
| Kit - Documentation - Étendre le Kit - LANG (TS).docx | Anleitung, eigene Darstellungen hinzuzufügen, ohne die des Kits zu ändern. |
| Kit - Glossaire - Termes - LANG (TS).docx | Glossar des Kits — Paar mit dem Begriffsmodul. |
| Kit - Glossary - Terms (TS).js | Begriffsmodul des Kit-Glossars — setzt die Begriffe in allen Dokumenten kursiv in Petrol. |
| Kit - Brands (TS).js | Markenmodul des Kits — setzt die Marken in fette Kapitälchen. |
| Kit - Text Highlights (TS).js | Modul der hervorgehobenen Textstellen — stellt die vom Projekt erklärten Einheiten kursiv dar. |
| Kit - Document Titles (TS).js | Modul der Anzeigebezeichnungen — lesbarer Name jedes Dokuments, Rubriktitel und Kategoriebezeichnungen, in der Sprache des Lesers. |
| Kit - Stylesheet - General - Code (TS).js | Allgemeines Stylesheet — Formatierungsmotor aller Dokumente. |
| Kit - Stylesheet - General - Reference (TS).docx | Referenzdokument des allgemeinen Stylesheets. |
| Kit - Stylesheet - Glossary - Code (TS).js | Stylesheet des Glossars. |
| Kit - Stylesheet - Glossary - Reference (TS).docx | Referenzdokument des Glossar-Stylesheets. |
| Kit - Stylesheet - YAML - Code (TS).js | Stylesheet der Code- und YAML-Blöcke. |
| Kit - Stylesheet - YAML - Reference (TS).docx | Referenzdokument des YAML-Stylesheets. |
| Kit - Stylesheet - HTML - Code (TS).js | HTML-Spiegel-Stylesheet — erzeugt die Seiten der Subsite. |
| Kit - Stylesheet - HTML - Reference (TS).docx | Referenzdokument des HTML-Stylesheets. |
| kit_check_markup.py | Prüfung der Auszeichnung zwischen einer Quelldatei und dem erzeugten Dokument, und Prüfung der Übereinstimmung der Breiten der Hinweis-Etiketten zwischen den Artefakten, die sie erklären. |
| kit_check_ossature.py | Gerüstprüfung zwischen den Sprachvarianten eines Dokuments — Blockfolge, Ebenen, Tabellenmaße. |
| kit_extract_map.py | Strukturkarte eines bestehenden Dokuments — erster Schritt jeder Neuerzeugung. |
| kit_gen_document.js | Neuaufbau eines Dokuments aus seiner Strukturkarte — stabiles Artefakt, Quality Control §3.16. |
| kit_check_fidelite.py | Treueprüfung der Extraktion — Hin- und Rückweg, byte-genau verglichen. |
| kit_check_registry.py | Prüfung des Umfangs des Projekt-Registry — vor jeder Erzeugung aufgerufen. Ein Schlüssel außerhalb des Umfangs geht bei der nächsten Aktualisierung verloren, ohne dass der Verlust sichtbar wird. |
| kit_check_setters.py | Linter der Setter-Disziplin — vor jeder Erzeugung aufgerufen. Fehlt er, lässt sich eine Pflichtregel nicht anwenden. |
| kit_check_couplets.py | Prüfung des gemeinsamen Zeitstempels der Glieder eines Paars. Ein fehlendes Glied wird gemeldet, ohne zu scheitern. |
| kit_validate_docx.js | Validator der erzeugten Dokumente — nach jeder Erzeugung aufgerufen, vor der Lieferung. |
| kit_validate_xlsx.py | Validator der Tabellendateien, die von den Pipelines erzeugt werden, die solche anlegen. |
| kit_render_cover_sheet.py | Deterministischer Renderer des Deckblatts, gesteuert von den Darstellungskonstanten des Dokuments Cover Sheet. |
| fonts/ | Poppins-Schriften des Deckblatt-Renderers, mit ihrer OFL-Lizenz. |
| kit_patch_helpers.py | Helper zum Bau von Fragmenten für chirurgische Patches — vorgeschrieben, um einen Hinweis oder einen Kasten in ein bestehendes Dokument einzufügen. |
| kit_gen_glossaire_docx.js | Helper zur Erzeugung der Glossar-.docx aus dem Begriffsmodul. Gegenstück zu kit_gen_glossaire_html.js — eine Quelle, zwei Darstellungen. |
| kit_gen_glossaire_html.js | Helper zur Erzeugung der Glossarseite der Website aus dem Begriffsmodul. Pflicht in jedem Projekt, das ein Glossar veröffentlicht. |
| package.json | Erklärung der npm-Module der Kette und ihrer Mindestversion — Neuinstallation mit npm install. |
| favicon.svg, favicon.ico, apple-touch-icon.png, index-icon.svg | Symbole der Subsite, von der Elternseite gezeichnet und vom Projekt getragen. Der Durchlauf kopiert sie in die Ressourcen der Website; index-icon.svg wird nur erwartet, wenn rendering.indexIcon es erklärt; seine Zeichnung zentriert sich in ihrer Anzeigefläche und füllt sie ganz aus, da das Stylesheet nur den Rahmen zentriert. |
4Die erste Sitzung starten
Sobald alle Kit-Dateien im Arbeitsbaum liegen, öffnen Sie ein Gespräch und fügen den folgenden Text als erste Nachricht ein.
Dieser Text ist ein Wegbereiter: er erzwingt das Lesen aller Wahrheitsquellen in der richtigen Reihenfolge, einen ausdrücklichen Lesebericht, die Bestätigung Ihrer Konfiguration und das Warten auf Ihr Startsignal, bevor auch nur eine Datei entsteht. Das Ergebnis ist stimmig, weil kein Schritt übersprungen werden kann.
EINRICHTUNG EINES NEUEN PROJEKTS — VOLLSTÄNDIGE KIT-EINSPIELUNG ============================== PROJEKTKONFIGURATION : ------------------------------ Projektpräfix : [IHR PRÄFIX] Vollständiger Name : [PROJEKTNAME] Mein Name : [IHR NAME] Sprache : [FR / EN / DE / LU] PFLICHTLEKTÜRE — STRENGE REIHENFOLGE : ------------------------------ Vor jeder Erstellung einer Projektdatei in dieser Reihenfolge lesen : 1. Kit - Projet - Prompt (TS).docx — dauerhafte technische Anweisungen. 2. Kit - Stylesheet - General - Code.js + Reference.docx — Formatmotor aller Dokumente. 3. Kit - Stylesheet - Glossary - Code.js + Reference.docx — Stylesheet des Projektglossars. 4. Kit - Stylesheet - YAML - Code.js + Reference.docx — Codeblöcke und YAML in der Dokumentation. 5. Kit - Stylesheet - HTML - Code.js + Reference.docx — spiegelndes HTML-Stylesheet. 6. Kit - Projet - Structure commune (TS).docx — verbindlicher Vertrag der Projektdateien und Gerüste. 7. Kit - Projet - Convention de nommage (TS).docx — Benennungsregeln. 8. Kit - Documentation - Quality Control (TS).docx — verbindliche Prüfkette und Sitzungsvoraussetzungen. 9. Kit - Projet - Guide d'initialisation (TS).docx — dieser Leitfaden. LESEBERICHT — VOR DEM WEITERMACHEN ANTWORTEN : ------------------------------ Für jedes Dokument der obigen Liste : − vollständig gelesen : ja / nein − festgestellte Version oder Zeitstempel Dann bestätigen : − die vier Konfigurationsangaben − die Liste der gewünschten optionalen Datenmodule (Marken, Variablennamen, Hausautomations-Entitäten, Reading Guide, Projekt-Deckblatt) und ihren Wert ABBRUCHBEDINGUNGEN : ------------------------------ Ist eine dieser Bedingungen erfüllt, vollständiger Halt und ausdrückliche Meldung vor jeder Erstellung : − eine Kit-Datei fehlt im Arbeitsbaum − eine im Registry angegebene Versionsnummer stimmt nicht mit der tatsächlichen Version der Datei überein − zwei Dateien desselben Paars tragen verschiedene Zeitstempel − eine Konfigurationsangabe fehlt oder ist mehrdeutig NACH BERICHT UND BESTÄTIGUNGEN — AUF DAS GO WARTEN : ------------------------------ Keine Projektdatei erzeugen, bevor ein ausdrückliches « go » im Chat eingegangen ist. Zuerst den vollständigen Plan ankündigen : Reihenfolge der zu erzeugenden Dateien, vorgesehener Inhalt, sequentielle Lieferung nach Kit - Projet - Prompt §9.
Nach dem Lesebericht und der Bestätigung Ihrer optionalen Module antworten Sie einfach “go” im Chat, um die Erzeugung der Projektdateien auszulösen.
5Was danach geschieht
Die gesamte technische Arbeit wird übernommen. Sie haben nichts Technisches zu entscheiden über die vier Angaben aus §2 und die in Schritt 2 bestätigten optionalen Module hinaus.
| # | Was getan wird | Was Sie tun |
|---|---|---|
| 1 | Liest alle Kit-Dateien der Reihe nach und bestätigt sein Verständnis: Präfix, Name, Sprache. | Prüfen, dass die Konfiguration richtig verstanden wurde. |
| 2 | Fragt, welche optionalen Module zu aktivieren sind und ob Sie den Reading Guide und das Projekt-Deckblatt wünschen. | Nach Bedarf antworten. Ohne Angabe dokumentieren die Vorgaben ein Standardprojekt. |
| 3 | Erzeugt die Projektdateien from scratch aus den Gerüsten von Structure commune: Projekt-Registry, Projekt-Prompt, Glossar, angepasstes Deckblatt, aktivierte Module. Wird das Deckblatt gewünscht, werden Sie im Dialog nach den projekteigenen Werten gefragt — den zwei Kopfzeilen, der Liste der Rubriken, den Dokumenten jeder Rubrik. | Abwarten. |
| 4 | Liefert die Dateien einzeln nach dem Protokoll der sequentiellen Lieferung. | Jede gelieferte Datei herunterladen. |
| 5 | Bestätigt, dass das Projekt bereit ist, und listet die in den Kontext hochzuladenden Dateien auf. | Die neuen Dateien in den Arbeitsbaum legen. |
6Der tägliche Umgang
6.1Sitzungsbeginn
Jedes Gespräch steht für sich — aus der vorigen Sitzung wird nichts behalten. Die Kontinuität sichern die Dateien des Projekts. Zu Beginn jeder Sitzung prüft die KI, dass alles in Ordnung ist, bevor sie anfängt.
Fehlt eine Datei, meldet sie es Ihnen. Laden Sie sie hoch und fahren Sie fort.
6.2Sitzungsende
Um eine Sitzung zu beenden, sagen Sie einfach:
Und nun bitte zum Sitzungsende.
Sie erhalten selbsttätig eine Sitzungszusammenfassung, ein Dateiverzeichnis und, falls nötig, einen aktualisierten Projekt-Prompt. Die Liste der vor der nächsten Sitzung hochzuladenden Dateien wird Ihnen ebenfalls gegeben.
6.3Die aktuellen Dateien
Die wichtigste Regel: laden Sie nach jeder Sitzung die gelieferten aktualisierten Dateien in das Projekt hoch. Ohne diesen Schritt startet die nächste Sitzung von alten Dateien aus.
Je nach den in Ihrem Registry gesetzten Flags sind nicht zwingend alle Dateien der folgenden Tabelle in Ihrem Projekt vorhanden. Laden Sie nur die tatsächlich vorhandenen hoch.
| Datei | Wann ersetzen |
|---|---|
| Projekt-Registry | Sobald ein Dokument-Zeitstempel oder ein Flag sich ändert. |
| Aktualisierter Projekt-Prompt | Sobald in einer Sitzung eine neue Konvention beschlossen wurde. |
| Dateiverzeichnis | Nach jedem Sitzungsende. |
| Glossarbegriff-Modul | Sobald neue Begriffe hinzugekommen sind. |
| Markenmodul | Sobald ein neuer Markenname erkannt wurde — wenn das zugehörige Flag aktiv ist. |
| Variablenmodul | Sobald ein neuer Variablenname erkannt wurde — wenn das zugehörige Flag aktiv ist. |
| Hausautomations-Entitätenmodul | Sobald eine neue Entität erkannt wurde — wenn das zugehörige Flag aktiv ist. |
| Inhaltsdokumente | Nach jeder Sitzung, in der sie geändert wurden. |
7Das Deckblatt in Ihren Dokumenten
Jedes von diesem Kit erzeugte Dokument beginnt mit einem Deckblatt, das Titel, Untertitel und Datum trägt. Kopf- und Fußzeile werden auf dieser ersten Seite selbsttätig unterdrückt, damit die Darstellung sauber bleibt — sie erscheinen erst ab Seite 2.
Dieses Verhalten steuert das Kit selbsttätig, ohne Ihr Zutun.