chore(deploy): the AI service project deploys only from main (#104)

[Fluory]

Warum

Fixes #104 · Befund aus dem Review von #102 (#98): Auch mit dem „Ignored Build Step“ erzeugt jeder Push auf jeden PR-Branch ein Deployment des KI-Projekts requestflow-ai. Übersprungene Builds enden als CANCELED und zählen womöglich trotzdem gegen die Deploy-Grenzen des Hobby-Plans (am 2026-09-28: „Deployment rate limited – retry in 24 hours“). Ersetzt #106 (geschlossen, weil der Basis-Branch von #102 nach dessen Merge gelöscht wurde); #102 ist in main, main ist eingemergt.

Arbeitsstand

• Ziel: Nur main erzeugt Deployments des KI-Projekts; PR-Branches gar keine.
• Nicht-Ziele: Einstellungen des Web-Projekts; Aufräumen der Registry (infra(ai): Vercel container registry is full – AI service builds fail #98, Konto-Aktion).
• Erledigt: git.deploymentEnabled in services/ai/vercel.json (gegen die aktuelle Vercel-Doku geprüft), Runbook §3 Schritt 7, Schritt 6 angepasst, CHANGELOG; Muster-Logik lokal mit minimatch nachgestellt; frischer Review eingearbeitet.
• Offen: Freigabe durch den Orchestrator (Infra-Regel: Deploy-Änderung) – zusammen mit fix(deploy): build the AI service on Vercel only when services/ai changed #102; Nachweis am Vercel-Dashboard nach dem Merge.
• Annahmen: Vercel wendet die Regeln auf den Branchnamen an, wie dokumentiert (minimatch; bei mehreren Treffern gewinnt true).
• Nächster kleinster Schritt: Freigabe von fix(deploy): build the AI service on Vercel only when services/ai changed #102 und diesem PR.

Was ist passiert (Klartext)

Der KI-Dienst hat bisher bei jedem Push auf irgendeinen Branch ein eigenes Vercel-Deployment angelegt – auch wenn er gar nicht gebaut wurde. Das verbraucht das begrenzte Deploy-Kontingent des kostenlosen Plans. Jetzt deployt das KI-Projekt nur noch von main. Vorschau-Versionen des KI-Dienstes braucht niemand: Web-Vorschauen rufen den KI-Dienst nicht auf, und die CI baut und testet das Image bei jeder Änderung daran. Ein Redeploy aus dem Dashboard (z. B. nach einer geänderten Einstellung) bleibt möglich.

Das ist eine Änderung an der Deploy-Konfiguration und braucht deine Freigabe vor dem Merge.

Plan-Pflicht (SYSTEM.md §4)

• Kein Auslöser – keine Modulgrenze, öffentliche API, Migration, Auth/Rechte, kein Zahlungs-/Daten-/Infrapfad, höchstens zwei Module, keine Architekturvarianten, umkehrbar
• Auslöser zutreffend – Impact Manifest ausgefüllt (Plan vor Code)

Hinweis: Deploy-Konfiguration (Infra-Regel: menschliche Freigabe), aber kein neuer Infrapfad und per Revert umkehrbar.

Geändert

• services/ai/vercel.json: "git": { "deploymentEnabled": { "**": false, "main": true } }
• docs/technical/deployment-vercel.md §3: neuer Schritt 7 (nur main deployt, Redeploy bleibt möglich, warum keine KI-Previews nötig sind), Schritt 6 angepasst
• CHANGELOG.md: Changed-Eintrag infra(vercel): no preview deployments for the AI service project #104

Nachweis (SYSTEM.md §11)

• Vercel-Doku (/docs/project-configuration/git-configuration, Stand 2026-08-25): Objekt Branch-Muster → Boolean; nicht genannte Branches sind true; minimatch-Muster; trifft ein Branch mehrere Regeln und eine davon ist true, wird deployt; die Einstellung betrifft nur Deployments durch Commits.
• Lokal mit minimatch 5 nachgestellt: main → deployt; claude/fix-ai-build-skip-98, dependabot/npm_and_yarn/x, feature, main-old → nicht. (* würde Namen mit / nicht erfassen – deshalb **.)
• verify:changed: scripts/doku-check.sh grün, JSON gültig
• verify: grün – CI check Run 38006317015 am PR-Kopf 28b1177 (Doku + JSON, keine Code-Änderung)
• verify:full / E2E-Spec: nicht betroffen
• Manueller Prüfnachweis: nach dem Merge – der nächste PR-Push zeigt kein requestflow-ai-Deployment; ein Merge auf main mit Änderung unter services/ai/ deployt Produktion.
• Frischer Review (P1 vor Ready-for-review; Architektur/API/DB immer): chore(deploy): the AI service project deploys only from main (#104) #106 (comment) – nichts blockierend, beide should umgesetzt

Doku-Entscheidung (genau eine)

• Keine langlebige Doku betroffen – Begründung: –
• Doku betroffen und im selben PR aktualisiert:
  • Produktdoku (P0: README): –
  • Technische Doku: Runbook deployment-vercel.md §3
  • Architekturkarte: –
  • ADR: –
  • CHANGELOG [Unreleased] (sichtbares Feature oder Verhalten – im selben PR, nie „später"): Changed-Eintrag infra(vercel): no preview deployments for the AI service project #104

Entferntes oder Umbenanntes: docs/ + README gegrept, Treffer bereinigt: Hinweis „AI preview may be missing“ in §3.6 ersetzt

Dateigrößen und neue Bausteine (SYSTEM.md §7)

Dateien über 500 Zeilen im Diff (Ausnahmen: generierter Code, Lockfiles, Fixtures, Migrationen, Schemas, Ressourcen, Doku, Konfiguration):

• keine
• bewusst belassen – Begründung: –
• im selben PR nach fachlicher Verantwortung geteilt
• Folge-Issue –

Über 800 Zeilen mit neuer Fachlogik oder über 1000 Zeilen (P1/P2): nicht betroffen

Neue Shared-Komponente, Utility-Datei, Adapter oder fachlicher Service:

• nein
• ja – gesucht nach: –

Subagent-Einsätze

• 1 × frischer Review (read-only, Sonnet) – nichts blockierend, 2 should + 3 nits; Umgang im PR-Kommentar.

Risiken / offene Punkte

• Ein Hotfix-Branch des KI-Dienstes bekommt keine Vorschau mehr – er muss über main (PR + Merge) ausgerollt werden. Das entspricht dem Hotfix-Pfad (Branch → PR → Merge).
• Gestapelt auf fix(deploy): build the AI service on Vercel only when services/ai changed #102.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DJ5vaKvTYiMvdngT4d3xo1

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
requestflow	Ready	Preview	Oct 9, 2026 11:53pm UTC