Aufgaben und Marker

Aufgaben verfolgen die Arbeit; Marker verfolgen die offenen Fragen.

Das Dokument tasks wird zeilenweise indiziert. Eine Aufgabenzeile hat ein Kästchen, eine ID wie T13, eine optionale Markierung [P] für parallel ausführbare Aufgaben, die abgedeckten Anforderungen in Klammern, eine Beschreibung und eine Done-when-Prüfung. Die Phase ist die ##-Überschrift über der Zeile.

tasks.md
## Phase 2: Refunds - [ ] T13 [P] (FR-18) Migrate the refunds table — Done when: the migration test passes on a copy of production - [x] T12 (FR-17, FR-19) Add the refund endpoint — Done when: the endpoint test passes · commit: 4f2a9c1

Schreibe (FR: —), wenn eine Aufgabe keine Anforderung abdeckt. Zeilen, die wie Aufgaben aussehen, aber dieser Form nicht folgen, werden getrennt als fehlerhaft gemeldet. list_tasks liefert die geparsten Aufgaben mit der aktiven Reservierung jeder offenen Aufgabe, und pending_only blendet die erledigten aus.

Reservieren und abschließen

Ein Agent ruft claim_task auf, bevor er beginnt, damit kein anderer Agent dieselbe Aufgabe übernimmt. Die Reservierung gilt für eine Frist (standardmäßig zehn Minuten), die jede Anfrage des Agenten an das Projekt verlängert, und sie endet mit release_task, wenn die Aufgabe als erledigt markiert wird oder die Frist abläuft. Eine Aufgabe, die jemand anderes hält, wird mit claimed abgelehnt, mit Nennung des Inhabers.

mark_task_done hakt die Aufgabe ab und fügt · commit: mit den 7 bis 40 hexadezimalen Kleinbuchstaben des Commits an, der sie abgeschlossen hat, als neue Revision.

Marker

Offene Fragen werden inline als [NEEDS CLARIFICATION: …] oder [NEEDS RESEARCH: …] geschrieben.

spec.md
[NEEDS CLARIFICATION: should refunds above 500 EUR need a second approval?]

list_markers listet sie über die Dokumente einer Spec, und die App zeigt sie im Marker-Tab der Spec, damit keiner vergessen wird. Eine Spec kann nicht genehmigt werden, solange sie offene Marker hat: Die Genehmigung wird über MCP, API und App gleichermaßen abgelehnt, mit der Zahl der zuerst zu beantwortenden Marker.