KI-Anweisungen pflegen und erweitern, die aus einer Vorlage für mehrere KI-Tools entstehen

## Vor dem Ändern herausfinden, welcher Teil für etwas zuständig ist Behandeln Sie das Projektarchiv als Satz klar zugeordneter Schichten und nicht als lose Dateisammlung. Ermitteln Sie vor dem Bearbeiten, welche Schicht für das angeforderte Verhalten zuständig ist: - Quellanweisungen definieren wiederverwendbare, nutzerseitige Vorgänge; - gemeinsame Referenzen definieren schichtenübergreifende Verträge und Schemata; - Hilfsprogramme setzen wiederholbare Abläufe um; - Anpassungsmodule übersetzen maßgebliche Anweisungen in plattformspezifische Pakete; - erzeugte Auslieferungen enthalten erneut erstellbare Ergebnisse; - Prüfautomatismen setzen Regeln für das Projektarchiv und seine Ergebnisse durch; - Architektur- und Betriebshandbücher erklären das Zusammenspiel der Schichten; - Abhängigkeits- und Installationsdateien bestimmen die unterstützte Laufzeitumgebung. Verwenden Sie die maßgebliche Quellschicht als verbindliche Grundlage. Erzeugte Auslieferungen belegen, dass die Erstellung funktioniert, sind aber keine eigenständigen Wahrheitsquellen. Erzeugen Sie sie über den dokumentierten Erstellungsablauf neu, anstatt sie direkt zu bearbeiten. Ermitteln Sie die kleinste verbindliche Datei, die das angeforderte Verhalten steuert. Bestimmen Sie anschließend alle davon abhängigen Dokumente, Schemata, Prüfungen und erzeugten Artefakte, die synchron gehalten werden müssen. ## Nur ein Original führen und die Version je KI-Tool per Umwandler bauen Pflegen Sie wiederverwendbare Anweisungen in einem einzigen, plattformneutralen Quellformat. Lassen Sie die Anpassungsmodule die für jede unterstützte Umgebung erforderliche Paketierung und Syntaxübersetzung durchführen. Ein Anpassungsmodul kann: - eine kompatible Quelle ohne Bedeutungsänderung kopieren; - für jeden Vorgang ein natives Fähigkeitspaket erzeugen; - eine gemeinsame Ausführungsgrundlage mit mehreren Einstiegspunkten zusammensetzen; - ein Plattformpaket mit Eingabeanweisungen und unterstützenden Fähigkeiten erstellen; - aus den Quellmetadaten einen Verteiler und eine Weiterleitungstabelle erzeugen. Anpassungsmodule müssen das ursprüngliche Verhalten und alle Einschränkungen bewahren. Übersetzen Sie plattformspezifische Werkzeugnamen in neutrale Handlungen, wenn die Zielumgebung andere Werkzeuge verwendet. Erzeugen Sie Weiterleitungsmetadaten aus der maßgeblichen Beschreibung, anstatt einen zweiten handgeschriebenen Katalog zu pflegen. Bearbeiten Sie beim Hinzufügen eines Vorgangs dessen maßgebliche Quelle nur einmal. Verwenden Sie einen ausdrücklichen Plattformausschluss nur dann, wenn der Vorgang auf dieser Plattform nicht funktionieren kann. Erstellen Sie alle betroffenen Anpassungsmodule neu und prüfen Sie ihre Ergebnisse auf Bedeutungsverschiebungen. ## Jede gespeicherte Notiz mit Quellen und Sicherheitsgrad versehen Jeder Vorgang, der Wissensartefakte schreibt, muss dem maßgeblichen Schreibvertrag des Projektarchivs folgen. Gestalten Sie Artefakte für eine zuverlässige spätere Suche und Schlussfolgerung, nicht nur für die unmittelbare Lesbarkeit durch Menschen. Jedes Artefakt muss Folgendes enthalten: - eine kurze Vorbemerkung, die einem künftigen KI-Leser den Zweck erklärt; - strukturierte Metadaten wie Artefaktart, Datum, Kennzeichnungen und ein ausdrückliches `AI-first`-Kennzeichen; - beständige interne Verknüpfungen für erwähnte Personen, Projekte, Ideen und Entscheidungen; - Aktualitätsangaben für Aussagen, die veralten können; - unverändert neben externen Aussagen erhaltene Quelladressen; - Vertrauenskennzeichnungen, die festgestellte Tatsachen, starke Belege, mittlere Belege und Vermutungen unterscheiden. Entfernen Sie keine Metadaten, Verknüpfungen, Herkunftsangaben oder Vertrauenssignale, nur damit ein Artefakt aufgeräumter wirkt. Wenn ein Vorgang eine neue Artefaktart einführt, erweitern Sie vor ihrer Erzeugung das gemeinsame Schema. ## Schreibregeln nutzen, die automatische Prüfungen bestätigen können Verwenden Sie Konventionen, die Formatierungsprogramme und Prüfautomatismen einheitlich überprüfen können: - schreiben Sie Markdown-Überschriften in Satzschreibweise; - verwenden Sie in Anweisungsquellen keine schmückenden Bildsymbole; - verwenden Sie ASCII-Zeichen statt typografischer Ersatzzeichen, sofern ein Nicht-ASCII-Zeichen keine eigene Bedeutung trägt; - schreiben Sie Kennzeichnungswerte klein und setzen Sie mehrdeutige Metadatenzeichenfolgen in Anführungszeichen; - halten Sie die eingerichtete Sprachversion, das Formatierungsprogramm, die Zeilenlängengrenze und die Abhängigkeitsverwaltung ein; - formulieren Sie Betreffzeilen von Versionsänderungen im Imperativ und wenden Sie die Zuordnungsrichtlinie des Projektarchivs an. Behandeln Sie das maßgebliche Formatierungsprogramm und die Prüfautomatismen als letzte Instanz für mechanische Stilfragen. Umgehen Sie sie nicht und bewahren Sie keine von ihnen abgelehnte Formatierung von Hand. Begrenzen Sie Konventionen so eng, dass sie automatisch durchgesetzt werden können. Wenn eine Regel nicht mechanisch prüfbar ist, dokumentieren Sie die für ihre Bestätigung erforderlichen Prüfbelege. ## Bei einer neuen Aufgabe Anleitungen und Listen gleich mit anpassen Verwenden Sie beim Hinzufügen eines neuen Vorgangs diese Reihenfolge: 1. Erstellen Sie die maßgebliche Anweisungsquelle mit Weiterleitungsmetadaten und einer vollständigen Betriebsanleitung. 2. Fügen Sie nur dann ein Hilfsprogramm im vorgesehenen Programmbereich hinzu, wenn ausführbare Logik erforderlich ist. 3. Verweisen Sie von jedem Weg, der ein Artefakt erstellen oder ändern kann, auf den gemeinsamen Schreibvertrag. 4. Erweitern Sie das gemeinsame Metadatenschema, bevor Sie eine neue Artefaktart einführen. 5. Aktualisieren Sie Betriebshandbuch, Funktionsübersicht, Architekturhinweise und öffentliches Befehlsverzeichnis. 6. Tragen Sie die Änderung in den Abschnitt für noch nicht veröffentlichte Änderungen ein. 7. Führen Sie die Erstellung der Anpassungsmodule aus und prüfen Sie die Ergebnisse jeder betroffenen Plattform. Duplizieren Sie keinen Vorgang in erzeugten Plattformverzeichnissen. Eine synchronisierte Änderung aktualisiert Quelle, maßgebliche Referenzen, Prüfungen und Dokumentation gemeinsam, damit spätere Neuerstellungen sie weder auslöschen noch ihr widersprechen können. ## Die Anweisungen und den Bauablauf der Versionen getrennt testen Prüfen Sie das Quellverhalten und den Erzeugungsablauf getrennt. Verwenden Sie statt eines aktiven Wissensspeichers einen abgeschotteten Prüfarbeitsbereich oder eine verknüpfte lokale Arbeitskopie. Zur Verhaltensprüfung: - führen Sie den geänderten Vorgang mit repräsentativen Prüfdaten aus; - untersuchen Sie die entstandenen Artefakte; - prüfen Sie erforderliche Metadaten, Verknüpfungen, Herkunftsangaben, Vertrauenskennzeichnungen und weitere Felder des Schreibvertrags; - bestätigen Sie, dass unbekannte Tatsachen ausdrücklich als unbekannt gekennzeichnet bleiben. Zur Prüfung des Erzeugungsablaufs: - führen Sie die Kurzprüfungen des Projektarchivs mit dem eingerichteten Paketausführungsprogramm aus; - prüfen Sie die Ergebnisorte der Anpassungsmodule und die erzeugte Weiterleitung; - erproben Sie die Schnittstellen der Hilfsprogramme und maschinenlesbare Ergebnisse; - aktualisieren Sie bei einer beabsichtigten Änderung der Ergebnisanordnung die zugehörige Prüfaussage innerhalb derselben Änderung. Führen Sie zuerst die engste einschlägige Prüfung und danach die betroffenen Kurzprüfungen aus. Manuelle Verhaltensprüfungen ergänzen automatische Prüfungen; sie ersetzen sie nicht. ## Neue Versionen nur nach bestandenen Prüfungen und mit Erlaubnis veröffentlichen Veröffentlichen Sie nur, wenn alle Prüfungen der kontinuierlichen Integration erfolgreich sind und der maschinenorientierte Schreibvertrag weiterhin erfüllt ist. Verwenden Sie eine kontrollierte Veröffentlichungsreihenfolge: 1. Verschieben Sie noch nicht veröffentlichte Einträge des Änderungsprotokolls unter eine datierte Versionsüberschrift. 2. Aktualisieren Sie die Version in der Hauptpaketdatei sowie in jeder gespiegelten Manifest- oder Zitierdatei. 3. Führen Sie Abweichungsprüfungen aus, die alle Versionsangaben vergleichen. 4. Erstellen Sie erzeugte Auslieferungen neu und führen Sie die betroffenen Prüfungen aus. 5. Bestätigen Sie vor dem Kennzeichnen oder Übertragen die Veröffentlichungsrolle und die Zweigrichtlinie. 6. Veröffentlichen Sie Versionshinweise aus dem genehmigten Eintrag des Änderungsprotokolls. Schützen Sie gemeinsam genutzte Standardzweige. Beitragende müssen den vorgeschriebenen Prüfweg verwenden. Verantwortliche dürfen nur dann direkt veröffentlichen, wenn die Richtlinie des Projektarchivs diese Befugnis ausdrücklich erteilt und dieselben Prüfschranken bestanden wurden. ## Fehlende Fakten nicht erfinden und erzeugte Dateien nicht von Hand ändern Schwächen Sie den Suchvertrag des Systems niemals aus ästhetischen Gründen. Entfernen Sie keine erforderlichen Vorbemerkungen oder Metadaten, formulieren Sie maschinenorientierte Artefakte nicht nur für einen menschlicheren Klang um und fügen Sie keine nach den Quellkonventionen verbotenen Schmuckelemente hinzu. Erfinden Sie keine Quoten, Daten, Eigentumsverhältnisse, Beziehungen oder sonstigen fehlenden Tatsachen. Kennzeichnen Sie unbekannte Werte mit `TBD` oder dem gleichwertigen ausdrücklichen Unbekannt-Marker des Projektarchivs. Bearbeiten Sie niemals erzeugte Ergebnisse, wenn sie von einem Erzeugungsprogramm verwaltet werden. Umgehen Sie keine Prüfautomatismen, veröffentlichen Sie nicht über einen unbefugten Zweig und behaupten Sie Erfolg nicht allein aufgrund einer Prüfung der Quelle. Vor der Abschlussmeldung: - prüfen Sie den gesamten beabsichtigten Änderungsvergleich auf sachfremde Änderungen; - bestätigen Sie, dass maßgebliche Quellen und erzeugte Ergebnisse übereinstimmen; - führen Sie das einschlägige Formatierungsprogramm, die Prüfautomatismen, die Prüfungen und die Erstellung der Anpassungsmodule aus; - prüfen Sie synchronisierte Schemata, Handbücher, Verzeichnisse und Einträge des Änderungsprotokolls; - halten Sie jede manuelle Prüfung und jede nicht ausführbare Prüfung fest; - bestätigen Sie, dass die abschließende Veröffentlichungsaktion der befugten Rolle entsprach. Melden Sie das geänderte Verhalten, die Prüfbelege, verbleibende Einschränkungen und alle noch erforderlichen Entscheidungen.