Anpassung an Harness-Updates
Der grundlegende Test des Pakets: das Harness ergänzen und verbessern und es niemals duplizieren oder mit ihm in Konflikt geraten, es sei denn, dies ist absichtlich deklariert und die native Grundlage wird benannt. Ein Harness-Release kann diesen Test auf drei Arten verletzen. Es kann nativ das liefern, was eine Regel oder ein Mechanismus tut, sodass die Regel zu einem Duplikat wird. Es kann ein Verhalten ändern, das eine Regel beschreibt, sodass die Regel zu einem Konflikt wird. Oder es kann eine Grundlage hinzufügen, die eine Regel zitieren sollte. Auch ein neues Modell kann den Prompting-Stil einer Regel veralten lassen, selbst wenn jede darin enthaltene Tatsache noch gültig ist. Diese Fähigkeit findet alle vier Fälle und behebt sie.
Standardpfad
- Vor allem anderen einen Worktree von
origin/mainaus erstellen. Die Umfrage-Workflows lesen einen sauberen Checkout und sollten daher auf einen zweiten Worktree verweisen, den niemand bearbeitet. - Die Basislinie finden. Die letzte überprüfte Version und das entsprechende Datum stehen im letzten datierten Abschnitt von
docs/handbook/sources/harness-survey.md. Der neueste Neu-Umfrage-Abschnitt dort benennt das Forschungsbankverzeichnis. Die erfassten Modellfakten stehen in den „Leiter“-Absätzen vondocs/handbook/claude-code.md.npm run check:harnessgibt diese Basislinie und alle Changelog-Versionen seitdem aus, und der geplanteharness-watch-Workflow erstellt einharness-update-Issue, wenn die Liste nicht leer ist. Wenn die SecretsHARNESS_ROUTINE_URLundHARNESS_ROUTINE_TOKENgesetzt sind, startet der Workflow auch eine Cloud-Routine. Diese Routine durchläuft den Delta-Addendum-Pfad und eröffnet einen Entwurf-PR aufclaude/harness-addendum-<version>. Wenn dieser PR bereits existiert, von ihm aus starten, anstatt erneut zu triagieren. Auch mitclaude --versionvergleichen. - Das Gate unter dem neuen CLI ausführen, bevor irgendetwas gelesen wird:
npm run verifyauf einem sauberen Checkout. Der Plugin-Validator läuft mit--strict, sodass eine Warnung, die ein Release hinzufügt, das Gate zum Scheitern bringt und ein Changelog-Triage diesen Eintrag als Rauschen lesen kann. - Das Delta sammeln im Scratchpad, eine Quelle pro Agent:
- die Claude Code Changelog-Abschnitte seit der Basislinie (https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md), die einzige Quelle, die eine Änderung datiert;
- die Modellübersicht und die Modellkonfigurationsseiten für neue Modelle, Voreinstellungen, Preise und Aufwand;
- das eigene Prompt-Audit des Harnesses über dieses Repository (
/doctor prompt-auditin einer Sitzung). Es meldet veraltete Pfade, tote Befehle, widersprüchliche Anweisungen und Prompting-Muster, die für ältere Modelle geschrieben wurden.
- Die Tiefe wählen. Die folgende Beurteilung verwenden. Sagen, welche gewählt wurde und warum.
- Triage und Klassifizierung. Jeder Kandidat erhält eine Zuordnung: DUPLIKAT, KONFLIKT, ERGÄNZUNG oder EINZIGARTIG (Definitionen in references/dispositions.md). Die Regeldateien,
plugins/house/orchestration/ORCHESTRATION.md, die Agenten, die Hooks, die Skills und die Evals nach Text durchsuchen, der das alte Verhalten behauptet. - Verifizieren. Ein DUPLIKAT oder KONFLIKT zählt nur, nachdem zwei Skeptiker es nicht widerlegen konnten. Einer liest auf Dokumentationsgenauigkeit und einer auf Durchsetzungsrealität, und jeder geht standardmäßig von Widerlegung aus, wenn unsicher. Die Sitzung liest dann die zitierte Zeile und den Regeltext selbst. Alles, was durch Ausführen geklärt werden kann (
--help, ein Hook mit einer echten Nutzlast, der Checker), ausführen. - Handeln gemäß der Zuordnung. Einen Konflikt in der Regel oder im Hook auflösen. Ein Duplikat ausmustern oder als deklariertes Duplikat behalten, das die native Grundlage nennt. Eine Ergänzung nur umformulieren, wo die Regel eine Grundlage behauptet oder impliziert, und die Tatsache zitieren. Ein Einzigartiges erfassen und unverändert lassen. Ein Prompt-Audit-Befund ändert den Wortlaut, niemals die Behauptung einer Regel, und muss in die Regelform passen, die der Checker durchsetzt. Bevor eine Abweichung eines Agenten, eine „nicht blockierende“ Anmerkung eines Reviewers oder eine „bekannte Einschränkung“ akzeptiert wird, die Hausregel oder Dokumentationsempfehlung nennen, die dies regelt, und die empfohlene Option wählen, es sei denn, es kann begründet werden, warum nicht.
- Aufzeichnen an den drei in references/recording-and-release.md beschriebenen Stellen. Dann den dortigen Release-Fluss durchlaufen.
Die Tiefe wählen
Delta-Addendum (Standard). Nur die Changelog-Abschnitte und Modelländerungen seit der Basislinie triagieren, mit einem Forscher pro Quelle. Die Treffer gegen die Regeloberfläche klassifizieren, dann einen datierten Abschnitt ## Addendum schreiben. Dies passt für ein oder zwei Releases mit Fehlerbehebungen und kleinen Funktionen sowie für eine Modelländerung, deren Auswirkung auf Stufen und Aufwand beschränkt ist.
Vollständige Neu-Umfrage. Jeden Harness-Bereich aus den Dokumenten erneut erforschen, jede Regelüberschrift und jeden Mechanismus klassifizieren, verifizieren, synthetisieren und einen Vollständigkeitskritiker laufen lassen. Dann einen Lücken-Durchlauf über alles machen, was der Kritiker nennt. Den Changelog-Triage aus dem Delta-Pfad parallel dazu ausführen: Dokumentseiten tragen keine Daten, daher kann ein vollständiger Lauf ohne das Changelog eine aktuelle Seite nicht von einer veralteten unterscheiden. Anzeichen dafür, dass das Addendum nicht ausreicht:
- das Delta betrifft mehrere Bereiche gleichzeitig;
- eine neue Modellfamilie oder Voreinstellung erscheint;
- das Prompt-Audit kennzeichnet Muster in vielen Dateien;
- ein Addendum deckt einen Konflikt in einem Bereich auf, dessen gespeicherte Fakten älter als die Änderung sind;
- der Kritiker der letzten Neu-Umfrage hat Bereiche aufgelistet, die seitdem niemand erforscht hat.
Die Skripte sind scripts/house-vs-harness-audit.js (Hauptskript) und scripts/house-vs-harness-gap-audit.js (Lücken). Jedes benötigt args.repo (absoluter Pfad zum sauberen Worktree) und args.date. Der Lücken-Durchlauf benötigt außerdem args.areas und args.targets aus den Ergebnissen des Kritikers sowie einen optionalen args.context-Satz, der das Ergebnis des Hauptdurchlaufs für sein Addendum angibt. Sie werden über das Workflow-Tool ausgeführt, das die explizite Zustimmung des Benutzers erfordert. Vor dem Fragen die Anzahl der Agenten angeben: Der Hauptdurchlauf besteht aus einem Forscher pro Bereich, einem Opus-Klassifizierer pro Modul plus einem für Mechanismen, zwei Skeptikern pro Duplikat-oder-Konflikt-Behauptung und zwei Syntheseagenten.
Gefahren
- Die meisten Befunde betreffen die Zuordnung, nicht den Inhalt. Die bisher größte Neu-Umfrage fand weder Duplikate noch Konflikte, aber 27 Umformulierungen, bei denen eine Regel eine native Grundlage behauptete, die die Dokumente nicht nennen. Bevor eine Regel aussagt, dass das Harness etwas tut, muss die Tatsache in der Bank oder auf einer abgerufenen Seite existieren.
- Skeptiker sehen nur Duplikate und Konflikte. Die vorgeschlagene Umformulierung einer Ergänzung gelangt ohne Verifikation in den Bericht und kann das Harness genauso leicht überbewerten wie der alte Text. Einen Widerleger schicken, der jede Umformulierung vor der Auslieferung gegen die gespeicherten Fakten prüft.
- Eine naive Überschriftenzählung überspringt eine Regel. Jede Regeldatei endet mit
## Don't, und einige echte Regeln beginnen mit „Don't“. Überschriften nach exakter Übereinstimmung zählen, nicht nach Präfix. - Dokumentseiten tragen keine Daten. Das Abrufdatum neben jedem Zitat notieren. Wenn das Changelog und eine Seite sich widersprechen, dem Changelog vertrauen, wann, und der Seite, was.
- Modelleinstellungen liegen außerhalb des Repositorys. Die Subagent-Grundlage und der modellspezifische Aufwand sind Benutzereinstellungen. Wenn eine Modelländerung sie verschiebt, dem Benutzer mitteilen, was einzustellen ist; niemals die Einstellungen von hier aus bearbeiten. Ein neu veröffentlichtes Modell läuft mit seinem eigenen Standardaufwand, bis eine modellspezifische Stufe greift.
- Ein Prompt-Audit-Befund kann mit der Hausform kollidieren. Ein Audit-Kennzeichen für eine Verbotsliste oder eine feste Zahl ist ein Stilsignal. Der Abschnitt
## Don'tund die Längenobergrenzen sind geprüfte Form und Sperren, daher ist ihre Änderung eine Paketentscheidung gemäß den ADRs, keine Umformulierung. - Der Branch-Guard liest Befehlstexte. PR-Bodies und Commit-Nachrichten schreiben, die Git-Verben in der Nähe von Branchnamen erwähnen, mit dem Write-Tool, dann mit
--body-fileoder-Fübergeben. - Subagenten committen nicht. Die Sitzung committed und pusht, was ein Agent vorbereitet hat.
Wann eine Bearbeitung hier wirksam wird
Diese Fähigkeit ist Repository-lokal. Eine Bearbeitung erreicht die nächste Sitzung, die sie namentlich aufruft, und nichts wird an Anwender ausgeliefert. Was Anwender erreicht, sind die Regel- und Mechanismusänderungen, die sie erzeugt, durch ein Release und das render --apply jedes Anwenders.