Konventionen (Team-Gedächtnis)

Jedes Team hat Regeln, die nirgends aufgeschrieben sind: den gemeinsamen Geldformatierer verwenden, die Zahlungs-API nie aus einem Controller aufrufen, Feature-Flags in einer Datei sammeln. Menschen lernen sie im Code-Review. kanman lernt sie genauso, aber anders als eine Blackbox zeigt es Ihnen, was es gelernt hat, und lässt Sie es ändern.

Wie kanman lernt

1. Während eines Runs führt kanman ein Notizbuch. Am Ende schreibt es eine kurze Retrospektive: Was hat funktioniert, was musste es nacharbeiten?
2. Im Review bringt der unabhängige Reviewer-Run Einwände ein, zum Beispiel “den gemeinsamen Geldformatierer statt toFixed verwenden”.
3. Nach jedem Versuch werden Lehren aus der Retrospektive und die Einwände des Reviewers gespeichert und mit den Bereichen des Repositorys verschlagwortet, für die sie gelten, etwa src/invoices.
4. Jede Nacht fasst kanman die Einwände der letzten 90 Tage zusammen. Eine Gruppe wird zur Konvention, sobald sie mindestens drei Einwände aus mindestens zwei verschiedenen Runs enthält. Ein Einwand, der zu einer bestehenden Konvention passt, stärkt stattdessen diese; eine ausgemusterte Konvention entsteht nie neu.
5. In künftigen Runs gehören angeheftete Konventionen immer zum Auftrag des Executors, aktive dann, wenn sie für alle Bereiche gelten oder für einen Bereich, den die Story berührt. Aktuelle Lehren und Einwände zu denselben Bereichen kommen dazu.

Konventionen, die Sie sehen

Öffnen Sie das Team und wählen Sie den Reiter Konventionen. Er listet aktive und angeheftete Konventionen (angeheftete zuerst) unter Aktiv und ausgemusterte unter Ausgemustert. Jede Konvention zeigt:

• die Regel in einem Satz, zum Beispiel Geldbeträge mit dem gemeinsamen Formatierer formatieren
• wo sie gilt (Gilt für: Bereiche des Repositorys oder alle Bereiche)
• ihre Herkunft, zum Beispiel 3 Review-Hinweise; ihre Detailseite listet sie unter Woher sie stammt, mit Links zu den Runs
• ihren Status: aktiv, angeheftet oder ausgemustert

Was Sie mit einer Konvention tun können

Jede Änderung steht im Audit-Log als convention_changed mit Ihrem Namen.

Warum das wichtig ist

kanman wird jede Woche besser in Ihrer Codebasis, und Sie sehen, was es gelernt hat. Reviewer müssen nicht immer wieder denselben Kommentar schreiben, und neue Regeln sind für alle sichtbar, statt nur im Kopf einer Person zu existieren.

Was nicht gespeichert wird

Konventionen enthalten Regeln und kurze Auszüge aus Review-Befunden, keine Kopien Ihres Codes. Sie gehören zum Team und werden mit ihm gelöscht. Siehe Aufbewahrung und Löschung.

Verwandte Seiten

• Runs
• Das Outcome-Gate und Nachweise