Archived

This repository has been archived on 2026-09-17. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.

pijukka 05575df408 docs: commit backlog of already-resolved intent/review corpus files

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

2026-09-10 12:06:53 +02:00

3.5 KiB

Raw Permalink Blame History

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.

3.5 KiB Raw Permalink Blame History