Lokale Änderungsprüfung
Changeproof bindet Anforderung, Ausgangspunkt und Verantwortung, bevor die Arbeit beginnt. Nach der Änderung verbindet die CLI Diff, Tests und offene Risiken zu einem signierten Change Passport. Bereits vorhandene Änderungen lassen sich rückblickend prüfen.
Zwei Wege zum Nachweis
Beide Wege erzeugen einen Change Passport. Sie machen jedoch unterschiedliche Aussagen darüber, was tatsächlich während der Änderung beobachtet wurde.
start → finishStärkster NachweisChangeproof wird vor der ersten Änderung gestartet. Intent, Git-Baseline, eingesetzter Agent und verantwortlicher Mensch werden zu diesem Zeitpunkt gebunden.
Der Passport kann belegen, womit der Lauf begonnen hat und welche Änderung bis zu seinem Abschluss entstanden ist.
inspectRückblickendEin vorhandener Commit oder Git-Bereich wird mit Ticket oder Spezifikation analysiert. Dateien, Tests, Abhängigkeiten und Risiken werden nachträglich verknüpft.
Der Passport beschreibt den sichtbaren Stand, behauptet aber keine zuvor nicht beobachtete KI-Urheberschaft.
Beobachteter Lauf
Ein vollständiger Lauf spannt eine überprüfbare Kette vom fachlichen Auftrag bis zum versiegelten Ergebnis – ohne die eigentliche Entwicklungsarbeit zu ersetzen.
Ein Ticket oder eine Spezifikation beschreibt die beabsichtigte Änderung und ihre überprüfbaren Teilziele.
Changeproof hasht die Anforderung und hält Baseline, Agent und verantwortlichen Sponsor vor der Änderung fest.
changeproof start --intent ticket.md --agent codex --sponsor youMensch und Agent arbeiten im Repository. Git bleibt die Quelle für Dateien und Struktur; Aussagen behalten ihren Evidenzstatus.
Diff und Tests werden ausgewertet, offene Risiken sichtbar gemacht und der Change Passport signiert.
changeproof finish --test "npm test" --openSchema, Digest und Signatur lassen sich unabhängig von der HTML-Darstellung erneut prüfen.
changeproof verify passport.jsonDer Change Passport
Der Passport sammelt nicht einfach Messwerte. Er hält fest, woher jede Aussage stammt und welche fachlichen Teilziele bereits Nachweise besitzen.
intentQuelle, Hash, Zusammenfassung und extrahierte Prüfkriterien.
changeGit-Bereich, Dateien, Zeilenzahlen, Kategorien und Strukturbeziehungen.
testAusgeführter Befehl, Ergebnis, Testdateien und Digest der Ausgabe.
riskHinweise auf Migrationen, APIs, Datenschutz oder Automatisierung mit ihren Quellen.
integrityMaschinenlesbares JSON, SHA-256-Digest und Ed25519-Signatur.
Wo es hilft
Intent und menschliche Verantwortung bleiben mit dem entstandenen Diff verbunden.
Datenmodell, API-Flächen, Tests und offene Risiken werden in einem Übergabeartefakt sichtbar.
Ein bestehender Git-Bereich lässt sich rückblickend gegen Ticket oder Spezifikation prüfen.
Reviewer erhalten einen Einstieg in Umfang, Nachweise und Lücken, bevor sie in einzelne Dateien springen.
Lokal ausgeführt
Quellcode und Prompts bleiben auf dem eigenen Rechner. Nach lokalem Build stehen beide Arbeitsweisen über dieselbe CLI bereit.
Einmalig einrichten
git clone https://github.com/entwicklerherz/changeproof.gitcd changeproof && npm install && npm run buildBeobachteter Lauf
npm exec changeproof -- start --intent ticket.md --agent codex --sponsor younpm exec changeproof -- finish --test "npm test" --openBestehende Änderung
npm exec changeproof -- inspect HEAD~1..HEAD --intent ticket.md --test "npm test" --openLab-Prototyp · Noch nicht im öffentlichen npm-Register veröffentlicht · Aufruf nach lokalem Build über npm exec.
Quellcode und Anleitung auf GitHub