Zum Inhalt springen
Reality Graph

Für Teams

Freelance-Lieferungen überprüfbar machen

Zuletzt aktualisiert: 2026-10-19Lesezeit ca. 3 Min.

Ein Freelancer macht eine Lieferung mit einem begrenzten Übergabe-Eintrag überprüfbar: vereinbarter Scope, unveränderlicher Änderungsverweis, exakte Checks und beobachtete Ergebnisse, offene Grenzen und benannte Entscheidung. Er dokumentiert Arbeit; er garantiert weder Codequalität noch Abnahme, Bezahlung oder ein rechtliches Ergebnis.

Tests grünDiff gelesenauth.py geändertFreigabeblockiertgrüne Tests heben das nicht auf
Inhalt

Mit Vereinbarung und verantwortlichen Rollen beginnen

Die nützliche Einheit ist eine gelieferte Änderung, keine allgemeine Zusicherung über eine Person. Benennt vor Arbeitsbeginn, wer Auftrag und Ausschlüsse bestätigt, wer die Änderung erstellt, wer sie prüft und wer sie laut Vertrag abnehmen kann. Ein Auftragnehmer kann mehrere Aktivitäten ausführen; der Eintrag darf dann keine unabhängige Prüfung andeuten.

BSI/ANSSI empfiehlt, generierten Quellcode zu prüfen und durch Entwickelnde reproduzierbar zu halten. Diese technische Orientierung stützt das Erfassen von Checks; sie definiert keinen Kunden-Abnahmestandard und belegt keine Qualität. Akzeptanzkriterien bleiben auftrags- und vertragsspezifisch.

Eine Vorlage nutzen, die kein Ergebnis imitiert

Das Muster enthält Platzhalter einschließlich fehlgeschlagener und nicht ausgeführter Zustände. Kopiert seine Struktur und füllt sie dann aus echtem Commit, Befehlsausgabe und Review-Entscheidung. Verlinkt Receipts, statt sie durch „alles bestanden“ zu ersetzen.

Illustrative Übergabevorlage – kein Qualitätsnachweis

uebergabe-vorlage.mdtext/markdown

Illustratives Muster · kein Kundenergebnis
# Übergabe · <Änderungs-ID> · <Datum>

## Vereinbarter Auftrag
Ziel: <beobachtbares Ziel>
Scope: <vereinbarte Pfade und Ausschlüsse>
Kriterien: <prüfbare Kriterien>

## Beobachtete Änderung
Commit/Diff: <unveränderlicher Verweis>
Dateien: <beobachtete Liste>

## Ausgeführte Checks
Befehl: <exakter Befehl>
Ergebnis: <bestanden | fehlgeschlagen | nicht ausgeführt>
Receipt: <Verweis oder "nicht vorhanden">

## Grenzen und offene Punkte
- <nicht geprüft, Grund, verantwortliche Rolle>

## Übergabeentscheidung
Erstellt von: <Auftragnehmer/Rolle>
Geprüft von: <Name/Rolle oder "keine unabhängige Prüfung">
Entscheidung: <angenommen | Änderungen verlangt | offen>
Das Muster strukturiert eine Übergabe. Es enthält keine erfundene Ausführung, Kundenzustimmung oder Aussage über Fehlerfreiheit.Nur beobachtete Befehle, Ergebnisse und Entscheidungen eintragen; Auslassungen bleiben sichtbar.

Jedes Feld auf seinem tatsächlichen Stützniveau lesen

Scope dokumentiert die Vereinbarung, nicht ihre Vollständigkeit. Ein Commit identifiziert die gelieferte Version, nicht Autorschaft oder Korrektheit. Ein Check-Receipt deckt Befehl, Umgebung und Kriterien ab, nicht jede Qualitätseigenschaft. Eine Entscheidung dokumentiert Verantwortung, nicht Haftungsverzicht oder unabhängige Assurance.

Feld, verantwortliche Rolle und Aussagegrenze

Eine Übergabe macht begrenzte Fakten prüfbar; sie garantiert weder Qualität noch Kundenzufriedenheit.
AuftragÄnderungChecksEntscheidung
Verantwortliche RolleKunde/Arbeitgeber bestätigt Bedarf und Scope; Auftragnehmer dokumentiertRedaktionelle Kontrollzuordnung · 2026-07-16Rollen folgen Vertrag und Arbeitsmodell; das Muster weist keine Rechtsrolle zu.Auftragnehmer referenziert den gelieferten Commit/DiffRedaktionelle Kontrollzuordnung · 2026-07-16Rollen folgen Vertrag und Arbeitsmodell; das Muster weist keine Rechtsrolle zu.Ausführende Rolle erfasst; Reviewer prüft AngemessenheitRedaktionelle Kontrollzuordnung · 2026-07-16Rollen folgen Vertrag und Arbeitsmodell; das Muster weist keine Rechtsrolle zu.Vertraglich benannte Abnahme- oder ReviewrolleRedaktionelle Kontrollzuordnung · 2026-07-16Rollen folgen Vertrag und Arbeitsmodell; das Muster weist keine Rechtsrolle zu.
Kann belegenVereinbartes Ziel und GrenzenRedaktionelle Kontrollzuordnung · 2026-07-16Gilt nur für den konkret referenzierten Eintrag.Welche Version und Dateien übergeben wurdenRedaktionelle Kontrollzuordnung · 2026-07-16Gilt nur für den konkret referenzierten Eintrag.Welcher Befehl welches beobachtete Ergebnis lieferteBSI/ANSSI – Empfehlungen zu KI-Programmierassistenten (2024, englisch) · 2026-07-16Technische Empfehlung zur Prüfung generierten Codes; keine Kundenzusage oder Qualitätsgarantie.Wer welchen Status zu welchem Zeitpunkt dokumentierteRedaktionelle Kontrollzuordnung · 2026-07-16Gilt nur für den konkret referenzierten Eintrag.
Belegt nichtNicht, dass die Anforderung vollständig oder richtig istRedaktionelle Kontrollzuordnung · 2026-07-16Zusätzliche Prüfung oder vertragliche Bewertung bleibt erforderlich.Nicht Fehlerfreiheit oder Autorschaft jeder ZeileRedaktionelle Kontrollzuordnung · 2026-07-16Zusätzliche Prüfung oder vertragliche Bewertung bleibt erforderlich.Nicht vollständige Qualität, Security oder ComplianceRedaktionelle Kontrollzuordnung · 2026-07-16Zusätzliche Prüfung oder vertragliche Bewertung bleibt erforderlich.Nicht Haftungsausschluss, Rechtswirkung oder unabhängige AssuranceRedaktionelle Kontrollzuordnung · 2026-07-16Zusätzliche Prüfung oder vertragliche Bewertung bleibt erforderlich.
Eine Übergabe macht begrenzte Fakten prüfbar; sie garantiert weder Qualität noch Kundenzufriedenheit.

Eine belastbare Übergabe liefert

  • Vereinbarten Scope
  • Unveränderlichen Änderungsverweis
  • Beobachtete Check-Ergebnisse
  • Explizite Grenzen und Entscheidung

Sie verspricht nicht

  • Fehlerfreien Code
  • Schnellere Abnahme oder Bezahlung
  • Weniger Haftung oder Streit
  • Überlegene Qualität gegenüber Wettbewerbern
Beobachtete Fakten statt Positionierungsversprechen.

Wie macht ein Freelancer gelieferte Codequalität überprüfbar?

Wie ein Freelancer gelieferte Codequalität überprüfbar macht, lässt sich in einem Satz sagen: Er hängt an jede gelieferte Änderung einen begrenzten Übergabe-Eintrag, der vereinbarten Scope, den unveränderlichen Commit, die tatsächlich ausgeführten Checks mit ihren beobachteten Ergebnissen, die nicht geprüften Bereiche und die benannte Abnahmeentscheidung festhält. Überprüfbar heißt dabei: Der Kunde kann jede dieser Angaben selbst nachvollziehen, ohne dem Freelancer glauben zu müssen.

Der Eintrag ersetzt keine Qualität, er macht sie sichtbar oder ihr Fehlen. Ein fehlgeschlagener Test gehört deshalb genauso hinein wie ein bestandener, und ein ausgelassener Check steht als ausgelassen da. Wer nur Erfolge einträgt, liefert eine Behauptung, keine Übergabe.

Für die erste Lieferung reicht eine Markdown-Datei neben dem Commit; die Struktur steht unter erster Prüfbericht. Was der Eintrag nicht leisten kann, bleibt ausdrücklich offen: Er beweist weder Fehlerfreiheit noch Security, und er entscheidet weder über Abnahme noch über Bezahlung. Das bleibt beim Vertrag und bei den Personen, die darin benannt sind.

Den Eintrag in den Lieferworkflow einpassen

Speichert die Übergabe bei der unveränderlichen Änderung oder im freigegebenen Liefersystem. Haltet technische Details über Receipts verfügbar und Scope sowie offene Punkte lesbar. Die tiefere Prüfbericht-Struktur erklärt, wie Auftrag, Änderung, Validierung und Entscheidung zusammenhängen, ohne ein Artefakt zum Beweis des ganzen Systems zu machen.

Reality Graph kann diese Einträge als Teil eines Runs aufbewahren und jeden Run eines Projekts in einem lokalen Workspace halten, damit ihr eine Lieferung Monate später nicht aus dem Gedächtnis rekonstruieren müsst. Dieselbe Grenze gilt: Generierter Output ist nur nützlich, wenn er reale Ausführung referenziert, Fehler erhält und die entscheidende Person oder Rolle benennt.

FAQ

Wie macht ein Freelancer gelieferte Codequalität überprüfbar?
Hängt an eine echte Änderung einen begrenzten Übergabe-Eintrag: vereinbarter Auftrag und Ausschlüsse, unveränderlicher Commit oder Diff, exakte Checks und beobachtete Ergebnisse, nicht geprüfte Bereiche sowie benannte Review- oder Abnahmeentscheidung. Der Eintrag macht diese Fakten prüfbar; er beweist weder Fehlerfreiheit noch ersetzt er die Kundenabnahme.
Wer verantwortet welchen Teil der Übergabe?
Kunde oder Arbeitgeber bestätigt Bedarf, Scope und vertragliche Abnahmerolle. Der Auftragnehmer erfasst die gelieferte Änderung und tatsächlich ausgeführte Checks. Die benannte Review- oder Abnahmerolle dokumentiert die Entscheidung. Die genaue Zuordnung folgt Vertrag und Arbeitsmodell, nicht dieser Vorlage.
Beweist ein bestandener Test-Eintrag Codequalität?
Nein. Er belegt, dass benannte Befehle für eine referenzierte Version und Umgebung erfasste Ergebnisse lieferten. Er belegt nicht vollständige Korrektheit, Security, Wartbarkeit, Compliance, Autorschaft oder Eignung außerhalb der abgedeckten Kriterien.
Soll die Übergabe nur bestandene Checks enthalten?
Nein. Fehlgeschlagene, ausgelassene und nicht verfügbare Checks sind wesentliche Fakten. Erfolgswerte vorab einzutragen oder Auslassungen zu verbergen macht aus einer nützlichen Übergabe eine unzuverlässige Behauptung.
Reduziert ein Übergabe-Eintrag Haftung oder Zahlungsstreit?
Das lässt sich nicht versprechen. Er kann vereinbarten Scope und beobachtete Arbeit erhalten. Vertragswirkung, Abnahme, Haftung und Zahlung hängen jedoch von Vereinbarung, geltendem Recht und Tatsachen ab. Dafür ist Rechtsberatung erforderlich.
Brauchen Freelancer dafür besondere Software?
Nein. Ein Markdown-Eintrag und unveränderliche Repository-Verweise können genügen. Automatisierung ist nur nützlich, wenn sie denselben Wahrheitsstandard erhält: reale Ausführung, sichtbare Fehler, explizite Auslassungen und benannte Entscheidung.
Wie zeige ich dem Kunden, was an einer gelieferten Änderung geprüft wurde?
Mit dem Check-Teil des Übergabe-Eintrags: exakter Befehl, Umgebung, referenzierte Version und das beobachtete Ergebnis, verlinkt auf die Ausgabe statt auf eine Zusammenfassung. Daneben steht, was nicht geprüft wurde, damit der Kunde die Lücke sieht, bevor er sie findet. So prüft der Kunde Fakten statt Zusicherungen; eine Qualitätsgarantie entsteht daraus nicht.

Weiterlesen

Quellen

Wollt ihr sehen, wie euer letzter Agenten-Run ausgesehen hätte?

Zugang anfragen