Lucian1u/material-to-deliverable

Von Material zum Arbeitsergebnis

Die realen Materialien in 00_input/ in überprüfbare, nachvollziehbare und lieferbare Textdateien verwandeln.

Startbedingungen

Nur ausführen, wenn alle folgenden Bedingungen erfüllt sind.

• Der Benutzer hat ein lokales Projektverzeichnis bereitgestellt oder angegeben.
• Es befindet sich mindestens ein reales Material in 00_input/.
• Der Benutzer wünscht eine Berichterstattung, ein Konzept, eine Retrospektive, eine Recherche oder eine Kurspräsentation.

Ist das Verzeichnis nicht klar, nur nach dem Projektverzeichnis fragen. Ist der Liefertyp nicht klar, nur nach dem Liefertyp fragen. Sind keine realen Materialien vorhanden, abbrechen. Keine Beispiele oder Ersatzmaterialien generieren.

Jedes Mal zu lesen

Vor Beginn der Verarbeitung vollständig lesen:

• Nachweis- und Sicherheitsregeln
• Dateikontrakt

Nach Bestätigung des Liefertyps den entsprechenden Abschnitt in den Liefertypregeeln lesen.

Arbeitsablauf

1. Projekt bestätigen und initialisieren

Wenn das Projekt noch nicht initialisiert ist, das Skript aus dem Installationsverzeichnis dieses Skills aufrufen und den absoluten Projektpfad übergeben:

python3 <skill-directory>/scripts/init_project.py /absoluter/pfad/zum/projekt

Nicht davon ausgehen, dass scripts/ im aktuellen Verzeichnis des Benutzerprojekts existiert. Zuerst <skill-directory> basierend auf dem Speicherort dieser Datei auflösen, dann das Skript ausführen.

Wenn 01_working/ bereits existiert, den vorhandenen Status auslesen und fortfahren. Nicht neu initialisieren. Keine Dateien überschreiben.

2. Eingabe und vertrauliche Informationen prüfen

Alle Dateien in 00_input/ auflisten. Nicht lesbare oder Quellen-unbekannte Dateien protokollieren. Die Originalmaterialien nicht ändern, verschieben oder umbenennen.

Zuerst eine Prüfung auf vertrauliche Informationen durchführen. Werden Namen, persönliche Kontaktdaten, Konten, Kundendaten, Verträge, Finanzdaten, Gesundheitsdaten, Bildungsdaten, Zugangsdaten, interne Pfade oder andere möglicherweise eingeschränkte Informationen gefunden:

1. Nur den Risikotyp und die Dateiposition in 02_material-index.md protokollieren. Keine vertraulichen Werte kopieren.
2. Sofort anhalten.
3. Den Benutzer bitten zu bestätigen, dass er berechtigt ist, diese Materialien zu verarbeiten, oder ihn bitten, eine entschärfte Kopie bereitzustellen.

Ohne Benutzerbestätigung nicht mit Gliederung, Schreiben oder Lieferung fortfahren.

3. Aufgabe klären

Nur eine Frage pro Schritt stellen, die das Endergebnis ändert, maximal sieben. Priorität haben die Klärung von: Empfänger, Nutzungsszenario, gewünschte Entscheidung, Frist, Liefertyp, zwingend zu erhaltende und verbotene Inhalte.

Antwortet der Benutzer mit „weiß ich nicht“, dies als zu klärenden Punkt protokollieren. Keine Antworten für den Benutzer erfinden. Das Ergebnis in 01_task-brief.md schreiben, eine Zusammenfassung anzeigen und auf Bestätigung durch den Benutzer warten.

4. Materialverzeichnis und -lücken erstellen

Für jedes Material die 02_material-index.md ausfüllen und unterscheiden zwischen:

• Fakten, die direkt durch die Quelle gestützt werden
• Aussagen der betroffenen Personen oder Organisationen
• Interviews, Feedback oder lokale Beobachtungen
• Eigene Einschätzungen des Benutzers
• Noch zu bestätigende Informationen

Konflikte, Fehlstellen, nicht lesbare, entschärfungsbedürftige und nicht ausreichend belegte Inhalte in 03_gaps-and-conflicts.md eintragen. Wenige Materialien nicht zu allgemeingültigen Schlussfolgerungen aufblähen.

Sind blockierende Lücken weiterhin vorhanden, weiterfragen oder abbrechen. Kein Hauptprodukt erstellen.

5. Quellengestützte Gliederung erstellen

Basierend auf dem Liefertyp eine 04_source-backed-outline.md erstellen. Jeder Abschnitt muss klar benennen: die zu beantwortenden Fragen, die verwendeten Materialien, die zulässigen Schlussfolgerungen, Benutzereinschätzungen, zu klärende Punkte und die Abnahmekriterien.

Eine Zusammenfassung der Gliederung und die Quellenabdeckung anzeigen. Auf Bestätigung durch den Benutzer warten. Ohne Bestätigung kein Hauptprodukt schreiben.

6. Endprodukt und Quellenverzeichnis generieren

Basierend auf der bestätigten Gliederung generieren:

• 05_main-deliverable.md
• 06_one-page-summary.md
• 07_source-index.md

Jeder wichtige Fakt muss im Quellenverzeichnis auf die spezifische Datei und Position verweisen. Keine Zahlen, Personen, Fälle, Zitate oder Ergebnisse, die nicht im Material vorhanden sind, hinzuerfinden. Eigene Einschätzungen müssen klar von Quellenfakten getrennt werden.

7. Zurück zu den Originalmaterialien prüfen

00_input/ erneut lesen. Keine reine Selbstprüfung anhand des gerade erstellten Endprodukts durchführen. Probleme mit Fakten, Umfang, Logik, Datenschutz, Aufgabenkonsistenz und Ausdrucksweise in 08_audit-report.md eintragen.

Nur Probleme beheben, die durch vorhandenes Material eindeutig korrigiert werden können. Punkte, die eine Benutzerentscheidung erfordern, als zu klärend belassen.

8. Lieferpaket zusammenstellen

Nur wenn die Prüfung keine blockierenden Probleme ergeben hat, die geprüften Inhalte in folgende Dateien schreiben:

02_delivery/
  main-deliverable.md
  one-page-summary.md
  source-index.md
  readme.md

02_delivery/ darf keine Originalmaterialien, Prompts, Chatverläufe, interne Entwürfe oder vertraulichen Werte enthalten. Abschließend das Skript aus dem Installationsverzeichnis dieses Skills ausführen:

python3 <skill-directory>/scripts/validate_project.py /absoluter/pfad/zum/projekt --stage delivery

Nach erfolgreichem Skript-Durchlauf den Benutzer dennoch an die endgültige manuelle Freigabe erinnern. Das Skript prüft nur Dateistruktur und offensichtliche Überbleibsel, nicht die sachliche Richtigkeit.

Abbruchbedingungen

In den folgenden Fällen abbrechen und angeben, was fehlt.

• 00_input/ ist leer oder Materialien können nicht gelesen werden.
• Der Benutzer hat nicht bestätigt, dass sensible Materialien verarbeitet werden dürfen.
• Empfänger, Liefertyp oder Kernziel sind noch unklar.
• Die vorhandenen Materialien können die Hauptschlussfolgerung nicht stützen.
• Der Benutzer hat die Aufgabenbeschreibung oder Gliederung noch nicht bestätigt.

Keine fiktiven Materialien, Internetrecherchen oder Allgemeinwissen nutzen, um Abbruchbedingungen zu umgehen, es sei denn, der Benutzer autorisiert ausdrücklich eine neue Quelle.

Ausgabesprache

Standardmäßig der aktuell vom Benutzer verwendeten Sprache folgen. Dateinamen auf Englisch halten, um die Nutzung über verschiedene Umgebungen hinweg zu ermöglichen; Dateiinhalte in der Benutzersprache verfassen.