mm/kalina-ci

0 Fork 0

Files

T

mm db3725da4d init: KALINA CI 1.0.0 - Marke, Satzvorlage, Vorlagen, Stempel, CLI

Zusammenfuehrung der bisher verstreuten CI (Markendoku + Open-WebUI-Skill) in ein
versioniertes Repository. Neu: tools/kalina-pdf (build/stamp/check/tokens),
tokens.json, docs/aenderungen.md als verbindlicher Aenderungsweg.

2026-10-23 10:39:30 +02:00

2.1 KiB

Raw Blame History

Änderungen an der CI

Die CI ist eine Vorlage mit vielen Nutzern (Menschen, Hermes, Paperclip-Agenten). Wer sie ändern will, ändert deshalb eine Quelle und nicht sieben Projekte.

Der Weg (verbindlich)

Issue im Repo — was ist falsch, wo tritt es auf, welches Dokument zeigt es? Ein Screenshot/Raster oder ein Seitenzahl-Füllgrad ist ein besserer Beleg als ein Adjektiv.
Branch ci/<thema> vom aktuellen main.
Änderung + Beleg: betroffene Datei, ein gebautes Beispiel-PDF (nicht committen, nur beschreiben oder als Kommentar) und tools/kalina-pdf check für das Beispiel.
PR gegen main, im PR-Text: Issue-Referenz, Vorher/Nachher, geprüfte Seiten.
Review durch mm oder das Agenten-Konto kalina. Bei Farben, Geometrie und Marke gilt: nur mit Sichtprüfung eines gerasterten PDFs.
Merge → CHANGELOG.md im selben PR ergänzen (Datum, was, warum).

Was danach passiert

Hermes/Arbeitskopien: git -C <klon> pull --ff-only (die CLI liest aus der Kopie).
Paperclip-Skill: GET .../skills/<id>/update-status zeigt, ob main weiter ist; POST .../skills/<id>/install-update zieht die neue Fassung. Der Skill merkt sich ref und trackingRef, ein Update ist damit nachvollziehbar statt „irgendwann".
Bereits ausgelieferte PDFs werden nicht rückwirkend geändert. Ein Neubau braucht die Quelle (HTML) oder ein kalina-pdf stamp auf das alte PDF.

Was NICHT über die CI läuft

Projektspezifische Layouts (Deckblatttext, Kapitelstruktur, Anhänge). Die CI liefert Satz und Marke, nicht den Inhalt.
Interne Verdrahtung: Hostnamen, Pfade, Schlüssel. Dafür gibt es die Betriebsdoku des jeweiligen Systems.
Schnellschüsse wie „im Projekt die Farbe überschreiben". Wenn die CI nicht passt, ist das ein Issue, kein lokaler !important.

Wenn es schnell gehen muss

Notfall (ein Termin, ein Dokument): Änderung im Projekt, im selben Tag ein Issue mit der Abweichung und dem Grund. Eine Abweichung ohne Issue ist eine stille zweite CI — und die kostet beim nächsten Dokument mehr Zeit, als sie gespart hat.

2.1 KiB Raw Blame History