Doku

Briefs, Checks und Readiness

Wie Briefs entstehen, wie der Readiness-Score berechnet wird, wie Checks getestet werden und wann ein erledigtes Ticket als verifiziert gilt.

Ein Brief ist ein Ticket, das so geschrieben ist, dass jemand, der nicht nachfragen kann, es umsetzen kann. Das Format ist der offene Brief-Standard; diese Seite beschreibt, wie NEWWORK Projects damit arbeitet.

Write with Nova

In jedem Ticket und im Dialog New ticket macht Write with Nova aus dem Titel und Ihren Notizen einen Brief für den Tickettyp. Es nennt unter Context die Repositories des Projekts, wo Ihre Notizen darauf verweisen, und erfindet nie Dateipfade.

Was es ergänzt, ohne dass Ihre Notizen es sagen, steht als Annahme da. Behalten Sie sie, oder streichen Sie sie, dann verlässt sie den Brief.
Was es nicht wissen kann (Namen, Zahlen, Grenzen, genaue Formulierungen), wird zu einer offenen Frage oder zu einem Platzhalter [to confirm].
Acceptance checks kommen als eigene Liste zurück und werden mit dem Ticket gespeichert. Vorhandene Checks bleiben; einer, der eine Aufgabe oder ein Wunsch ist, wird als beobachtbares Ergebnis neu formuliert.

Beantworten Sie die Fragen und wählen Sie Apply to description: Die Antworten werden eingearbeitet, und die Fragen verlassen den Brief. Gespeichert wird erst, wenn Sie speichern, und Undo bringt Ihre Notizen zurück.

Entwürfe aus Notizen, Aufteilungen in Unteraufgaben und die Pläne eines Brainstormings folgen demselben Format, und jeder Entwurf zeigt seine Readiness, bevor Sie ihn anlegen.

Von Hand geschriebene Briefs

Hat eine Beschreibung im Backlog oder in To do keinen Intent, keine Checks oder Checks, die Aufgaben oder Wünsche sind, bietet eine unaufdringliche Zeile darunter Restructure with Nova an. Es ordnet Ihren Text in die Abschnitte des Briefs und macht aus Aufgaben und Wünschen Checks. Es behält, was Sie geschrieben haben, und fügt keine Anforderungen hinzu; was noch fehlt, kommt als Frage zurück. Not now blendet die Zeile für dieses Ticket aus, Don’t suggest again für alle. Die Zeile selbst kostet nichts: Nur der Button ruft die KI auf.

Readiness

Jedes Ticket bekommt einen Score von 0 bis 100, berechnet aus dem Brief, sobald er sich ändert:

Teil	Punkte
Ein Intent	25
Acceptance checks, alle beobachtbar	30
Keine offenen Fragen	25
Context: ein Repository, eine Datei oder ein Link	20

Solange einige Checks Aufgaben („Export-Button hinzufügen“) oder Wünsche („Der Export ist schnell“) sind, bringen sie 15 der 30 Punkte. Alle vier Teile ergeben Ready for agent, und Karten auf dem Board und Zeilen im Backlog zeigen ein Roboter-Symbol. Agenten sehen den Score in pm-my-work und pm-item-get, pm-brief-check nennt die Checks, die neu zu formulieren sind, und pm-item-start warnt, wenn ein Ticket nicht bereit ist.

Acceptance checks

Checks stehen unter der Beschreibung, jeder eine beobachtbare Aussage. Die zuständige Person, die erstellende Person und Projektmanager haken sie ab:

Passed braucht einen Nachweis: einen Pull Request, Commit oder Link, oder einen Test und sein Ergebnis. Ein Haken einer Person in der App ohne Nachweis zählt als Confirmed durch diese Person.
Failed braucht eine Notiz, was fehlgeschlagen ist.
Wer abgehakt hat, wann, wie (in der App oder durch einen KI-Agenten) und mit welchem Nachweis, steht neben dem Check und in der Aktivität.

Eine Beschreibung, die noch eine alte Liste „Acceptance criteria“ enthält, wird mit einem Klick zu Checks.

Testen

Jeder Check ist ein Testfall; es gibt keine zweite Liste, die man abgleichen muss.

Standardmäßig automatisiert. Ein Agent schreibt pro Check einen Test, benannt nach dem Check (PAY-12 check 2: …), und hakt den Check mit diesem Test, seinem Ergebnis und dem CI-Lauf als Nachweis ab. pm-item-start sagt dem Agenten das.
Manuell, wenn nur ein Mensch urteilen kann. Beenden Sie den Check mit „(manuell)“ oder „(manual)“, zum Beispiel „Der leere Zustand entspricht dem Design (manuell)“. Agenten können ihn nicht bestehen lassen; sie lassen ihn fehlschlagen oder schreiben in einem Kommentar, wie er zu prüfen ist, und eine Person hakt ihn ab.

Verifiziert fertig

Ein erledigtes Ticket ist Verified, wenn jeder Check mit Nachweis bestanden ist und kein verknüpfter Pull Request mehr offen ist. Sonst zeigt es Not verified, und der Tooltip listet, was fehlt. Verifizierte Tickets bekommen ein Schild-Symbol auf Karten und Zeilen.