05575df408
board-agent's own README documents docs/intent/ and docs/research-intent/ as tracked corpus directories, and docs/review/<slug>.md as the reviewer's persisted report per card - but the pipeline only writes these files to the checkout, it never commits them itself. This had built up a backlog of intent/review docs for cards already marked deployed or archiviert in the live board state, which were sitting uncommitted in the working tree. Adds that backlog as-is: the originating intents, their reviewer reports, the research-intent/research pair for the board UX evaluation, and one standalone process-retrospective report (board-review-pipeline-context- overhead.md, same genre as the two already-tracked audit reports in docs/review/). No code changes. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T7UVrKsttMP9a6FiGFna9b
77 lines
3.5 KiB
Markdown
77 lines
3.5 KiB
Markdown
# Intent: Archiv-Spalte für abgeschlossene Board-Karten
|
|
|
|
## Ziel
|
|
|
|
Das Intent Board erhält am rechten Ende eine Spalte `Archiviert`. Dort
|
|
können abgeschlossene oder nicht mehr aktive Karten manuell abgelegt
|
|
werden, ohne Dateien zu löschen und ohne einen Builder-, Review- oder
|
|
Deployment-Lauf auszulösen.
|
|
|
|
## Umfang / Auftrag an den Builder
|
|
|
|
- In `board.html` die Phase `archiviert` als letzte Spalte mit der
|
|
sichtbaren Bezeichnung `Archiviert` ergänzen.
|
|
- In `trigger.py` `archiviert` als gültige persistente Phase aufnehmen.
|
|
- Das manuelle Verschieben nach `archiviert` aus jeder vorhandenen Phase
|
|
erlauben. Archivieren ist eine reine Board-Aktion und überspringt daher
|
|
bewusst die normale Pipeline-Reihenfolge.
|
|
- Beim Übergang nach `archiviert` niemals einen Builder-, Review- oder
|
|
Deployment-Job erzeugen.
|
|
- Archivierte Intent-Karten bleiben mit ihrer vorhandenen
|
|
`docs/intent/<slug>.md` verknüpft.
|
|
- Falls ein Review-Bericht vorhanden ist, muss er auch in der
|
|
Archiv-Spalte weiterhin über die Karte geöffnet werden können.
|
|
- Vorhandene Metadaten wie letzter Laufstatus, Review-Entscheidung,
|
|
Review-Bericht, Runtime und Zeitstempel erhalten; nur die Phase ändert
|
|
sich.
|
|
- Das manuelle Zurückverschieben aus `archiviert` erlauben. Für einen
|
|
erneuten Builder-Lauf muss die Karte weiterhin zuerst nach `geplant`
|
|
und danach nach `in_umsetzung` verschoben werden; ein direkter Übergang
|
|
`archiviert -> in_umsetzung` darf keinen unbeabsichtigten Job starten.
|
|
- README und Tests an die zusätzliche Phase anpassen.
|
|
|
|
## Übergangsregeln
|
|
|
|
- `<beliebige Phase> -> archiviert`: erlaubt, reine Buchhaltung.
|
|
- `archiviert -> idea`: nur für Idea-Karten erlaubt, reine Buchhaltung.
|
|
- `archiviert -> geplant`: erlaubt, reine Buchhaltung.
|
|
- `archiviert -> in_umsetzung`: ablehnen; zuerst nach `geplant`
|
|
verschieben, damit der bestehende explizite Trigger-Übergang erhalten
|
|
bleibt.
|
|
- `archiviert -> review`, `bereit_fuer_deployment`,
|
|
`planung_mit_feedback` oder `deployed`: als manuelle Buchhaltung
|
|
erlauben, ohne Seiteneffekt.
|
|
- Alle bisherigen Pipeline-Guardrails außerhalb von `archiviert` bleiben
|
|
unverändert.
|
|
|
|
## Ausgeschlossen
|
|
|
|
- Keine Verschiebung von Dateien nach `docs/archive/` und keine Änderung
|
|
der Repository-Struktur.
|
|
- Kein Löschen von Intent- oder Review-Dateien beim Archivieren.
|
|
- Kein automatisches Archivieren nach Review oder Deployment.
|
|
- Keine zeitbasierte Bereinigung und kein Ausblenden archivierter Karten.
|
|
- Keine Änderung an der Codex-/Claude-Auswahl.
|
|
|
|
## Tests
|
|
|
|
- Das Frontend enthält `archiviert` genau einmal als letzte Spalte.
|
|
- Backend akzeptiert die Phase und liefert archivierte Karten weiterhin
|
|
über `GET /api/board`.
|
|
- Übergänge aus `review`, `bereit_fuer_deployment`,
|
|
`planung_mit_feedback` und `deployed` nach `archiviert` erzeugen keinen
|
|
Queue-Eintrag.
|
|
- Intent- und Review-Dialog funktionieren für archivierte Karten weiter.
|
|
- `archiviert -> geplant` ist erlaubt und erzeugt keinen Job.
|
|
- `archiviert -> in_umsetzung` wird abgelehnt und erzeugt keinen Job.
|
|
- Bestehende Vorwärts-, Rückwärts- und Doppel-Trigger-Tests bleiben grün.
|
|
|
|
## Erfolgskriterien
|
|
|
|
- Abgeschlossene Intent-, Review- und Deployment-Karten lassen sich
|
|
manuell in eine dauerhafte Archiv-Spalte verschieben.
|
|
- Archivierte Karten bleiben lesbar, aber vollständig inaktiv.
|
|
- Archivieren verändert außer Phase und Aktualisierungszeitpunkt keine
|
|
fachlichen Metadaten.
|
|
- Ein späteres Reaktivieren ist über den bewussten Zwischenschritt
|
|
`archiviert -> geplant -> in_umsetzung` möglich.
|