Konzept, Test, Review: was braucht was
Nicht jede Änderung geht den ganzen Von der Idee zum Commit. Das Template verlangt drei Dinge, und hinter jedem steht eine Regel:
- Zuerst ein Konzept -
R-work-idea-first: Eine Idee, ein Feature oder ein Änderungswunsch bekommt zuerst ein kurzes Konzept mit Optionen (act-idea) und eine Entscheidung, dann wird gebaut. Das bei etwas Kleinem zu überspringen ist erlaubt, aber der Assistent sagt es laut, damit du widersprechen kannst. - Beleg -
R-work-evidence: „Fertig“ gilt nur mit einem Testlauf, einem CI-Lauf, einem Log-Auszug oder Screenshot, einem Commit-Hash oder einem Aufruf nach außen. Ohne ihn ist ein Ergebnis „nicht verifiziert“.R-code-commitlässt Prüfungen in Stufen laufen, wo das Projekt sie eingerichtet hat: betroffene Tests innerhalb eines Schritts; Lint, Typecheck und Tests vor jedem Commit; die volle oder E2E-Suite (ein optionaler viertercommands-Eintrag) einmal vor einem Push und nach einem Update von Framework oder Abhängigkeiten. Solange eine Prüfung rot bleibt, wird nichts committet oder gepusht. - Ein Review -
R-code-commit: Derreviewerläuft einmal je Aufgabe vor der Abnahme, nicht nach jedem Schritt, und schließt mitALLOW,CONDITIONALoderBLOCK. Bei einer trivialen Änderung (ein Tippfehler, nur Doku) überspringt der Assistent es und sagt es.
| Die Änderung | Zuerst ein Konzept? | Test oder Beleg? | Review? |
|---|---|---|---|
| Ein neues Feature oder ein Änderungswunsch | Ja, mit Optionen und deiner Entscheidung (R-work-idea-first). |
Ja: Tests, wo das Projekt sie hat, dazu der Nachweis, dass das Feature funktioniert (R-work-evidence, R-code-commit). |
Ja, einmal je Aufgabe (R-code-commit). |
| Eine kleine, genau beschriebene Änderung, etwa ein Label umbenennen | Darf entfallen; der Assistent sagt es laut (R-work-idea-first). |
Ja, mindestens ein Lauf oder ein Blick auf das Ergebnis (R-work-evidence). |
Ja, einmal je Aufgabe, außer sie ist trivial (R-code-commit). |
| Eine Fehlerbehebung | Nein: Ein Fehler ist keine Idee, R-work-idea-first gilt für Ideen, Features und Änderungswünsche. |
Ja, zuerst: act-bug schreibt einen Test, der vor der Behebung fehlschlägt und danach besteht (R-work-evidence). |
Ja, einmal je Aufgabe (R-code-commit). |
| Ein Tippfehler oder eine reine Doku-Änderung | Darf entfallen, laut gesagt (R-work-idea-first). |
Ja, trotzdem: Der Commit-Hash ist ein Beleg, dazu ein Build oder Link-Check, wo es einen gibt (R-work-evidence). |
Entfällt; der Assistent überspringt es und sagt es (R-code-commit). |
| Ein Ergebnis, das ein Worker zurückgibt | Entfällt. | Ja: kein Beleg, kein „fertig“ (R-work-evidence). |
Einmal je Aufgabe, vor der Abnahme (R-code-commit). |
So liest du sie:
- „Ja“ ist der Normalfall, „darf entfallen“ ist eine Entscheidung, die der Assistent ankündigt und nie stillschweigend trifft.
- Ein Review-Urteil
CONDITIONALstoppt den Commit nicht. Die Bedingung wird im selben Schritt als Todo oder Frage in die Inbox gelegt und in der Commit-Nachricht genannt.BLOCKstoppt ihn (R-code-commit). Derreviewerblockiert nach Schweregrad: bei einem Fehler auf einem Pfad, den gewöhnliche Arbeit erreicht, einem fehlenden Teil des Auftrags, einer Sicherheitslücke, die ein Modell ohne Absicht erzeugen kann, oder einer abgeschwächten Prüfung, deren Grund der Autor nicht nennt, nicht bei einem konstruierten Randfall; der wird als Backlog-Fall abgelegt. Lint, Typecheck und Tests laufen einmal auf dem abgenommenen Stand, vor dem Commit; eine volle oder E2E-Suite läuft einmal vor einem Push. - Die Tabelle folgt den Vorgaben des Templates. Jede Regel lässt sich im Projekt abschalten oder ersetzen
(
R-work-override, Schichten und Overrides); die Regeltexte stehen in der Regeln.