Pflege & Versionen

Die CI ändert sich regelmäßig. Hier steht, wie Änderungen hineinkommen, wie eine neue Version entsteht und wie du sie bekommst.

Wer die CI pflegt

Die CI lebt im Repository Miragon/corporate-identity. Diese Doku und das Plugin für Claude entstehen aus derselben Quelle. Ändern kann jede und jeder bei Miragon, per Pull Request. Fragen und Ideen gehen in den Teams-Channel ask-marketing.

Was du wo änderst

Was	Quelle	Danach
Markenstimme, Regeln, Vokabular, Anti-Slop	brand/marke.yaml, brand/regeln.yaml, brand/vokabular.yaml, brand/slop.yaml	npm run brand:build
Farben, Schrift, Abstände, Formate	brand/tokens.json	npm run tokens:build
Doku-Seiten	docs/	nichts weiter
Skills	plugins/miragon-brand/skills/	npm run assets:sync, wenn Logos oder Tokens betroffen sind
Domain der Doku	SITE in docs/.vitepress/config.mts	npm run brand:build

Dateien mit dem Hinweis „AUTOMATISCH GENERIERT" änderst du nie von Hand. Sie entstehen aus den Quellen oben, und die Checks schlagen fehl, wenn sie nicht mehr dazu passen.

Freigabe

Änderungen an der CI laufen über den Pull Request. Gemergt wird, wenn alle Checks grün sind: Tokens und Marken-Daten in Sync, Plugin und Skills valide, brand-lint ohne harte Befunde, Doku baut ohne tote Links, überall dieselbe Version.

Posts auf LinkedIn brauchen keine Freigabe, weder auf dem eigenen Profil noch auf der Miragon-Seite. Die Skill social-post hilft beim Schreiben.

Versionen

Die CI folgt SemVer:

Stufe	Beispiel	Wann
Patch	1.4.1	Korrekturen, Tippfehler, genauere Formulierungen
Minor	1.5.0	Neue Skills, Seiten, Regeln oder Tokens, geänderte Formate. Was sich ändert, steht im CHANGELOG unter „Geändert".
Major	2.0.0	Eine Skill fällt weg oder bekommt einen neuen Namen, oder das Plugin ändert Namen oder Aufbau

Jede Version bekommt einen Git-Tag vX.Y.Z. Damit funktionieren feste Versionen wie Miragon/corporate-identity@v1.4.0 (siehe Installation). Was in welcher Version passiert ist, steht im CHANGELOG.

Release-Ablauf

1. Alle Änderungen stehen im CHANGELOG unter [Unreleased].
2. npm run release -- 1.5.0 setzt die neue Version überall auf einmal: package.json, Lockfile, marketplace.json, plugin.json, Versionsmenü der Doku, Pin-Beispiel in der Installation. Der Abschnitt [Unreleased] im CHANGELOG bekommt Versionsnummer und Datum.
3. npm run check && npm run docs:build
4. Pull Request, Squash-Merge auf main.
5. Tag setzen: git tag -a v1.5.0 -m "v1.5.0" && git push origin v1.5.0
6. Live prüfen: Versionsmenü, /llms.txt, Brand-Kit.

Ohne neue Version in plugin.json und marketplace.json bekommen installierte Plugins kein Update. npm run check prüft deshalb, ob überall dieselbe Version steht und ob der CHANGELOG einen Abschnitt dafür hat.

Updates holen

So bekommst du die neueste Version:

# Marketplace neu einlesen
/plugin marketplace update

# Installierte Plugins aktualisieren
/plugin update

Welche Version installiert ist, zeigt /plugin in der Liste der Plugins. Die aktuelle Version der Doku steht oben im Menü.