Das Board

Das Board ist ein Ordner: .agent/board/, eine Markdown-Datei pro Ticket. Die App rendert ihn als drei Spalten — und nur drei:

Backlog  →  Doing  →  Done

Zwei Invarianten halten es ehrlich: Nur ein Ticket ist in Doing zu jeder Zeit (der Agent beendet oder teilt, bevor er das nächste anfängt), und Stationen werden nie erfunden — ein Ticket ist in einer dieser drei, oder die App zeigt einen Fehlerbanner.

Ein Ticket ist eine Datei

---
id: site-scaffold
title: Scaffold the site
station: Backlog
created: 2026-08-26T08:25:00Z
order: 1
plan: agent-fundamentals-website
---
## Scope
Was dieses Ticket umfasst — klein genug für einen Agenten-Lauf.

## Acceptance criteria
Woran beide Seiten erkennen, dass es fertig ist.

Zwei optionale Flags betreffen dich als Owner:

needs_human: true — ein Mensch muss handeln (ein manueller Test, ein Konto, ein DNS-Eintrag). Die App hebt diese hervor, damit sie nicht unbemerkt im Backlog liegen.
open_question: Q1 — der Agent hängt an einer Frage, die du noch nicht beantwortet hast. Siehe Fragen.

Woher Tickets kommen

Ein frisches Projekt hat einen Plan und ein leeres Board. Der Agent liest den aktiven Plan (lifecycle: active — nur ein Plan darf aktiv sein), schneidet ihn in kleine Tickets, geordnet nach order, und arbeitet dann das Board: oberstes Backlog-Ticket nehmen, auf Doing setzen, die Arbeit machen, committen, auf Done setzen. Ein Ticket, das sich als zu groß erweist, wird geteilt statt halbfertig liegengelassen.

History: das Gedächtnis des Inspektors

Jedes Ticket hat ein append-only-Log, .agent/board/history/<id>/index.jsonl — eine JSON-Zeile pro bedeutsamem Schritt:

{"actor":"agent","event_type":"station_changed","summary":"Backlog -> Doing","ticket_id":"site-scaffold","timestamp":"2026-08-26T09:05:30Z"}

Die App loggt, was die App ändert; der Agent loggt seine eigenen Schritte — Tickets anlegen und verschieben, beantwortete Fragen festhalten, einen Skill ausführen. Die Event-Typen (ticket_created, station_changed, ticket_edited, agent_run) bekommen je ein Icon im Ticket-Inspektor — so lässt sich das Leben jedes Tickets rekonstruieren, ohne ein Terminal-Transkript zu lesen.