Coding Agent Integration

Dieser Leitfaden richtet sich an Teams, die bereits Coding Agents wie Claude Code oder Codex nutzen und pubm-Release-Workflows in dieses Setup einbinden möchten.

Schnellinstallation mit pubm setup-skills

Der schnellste Weg, Coding-Agent-Skills zu installieren, ist:

pubm setup-skills

Das lädt das Skill-Bundle für deinen Agenten (Claude Code, Codex CLI oder Gemini CLI) aus dem pubm-GitHub-Repository herunter und legt es im richtigen Verzeichnis ab. Es steht auch als letzter Schritt von pubm init zur Verfügung.

Mit Setup-Automatisierung anfangen

Wenn ein Repository noch nicht angebunden ist, sollte der Agent zuerst das Setup erledigen und nicht direkt veröffentlichen.

Verwende zuerst publish-setup. Dieser Skill übernimmt:

• Installation des pubm plugin-Bundles
• Erzeugung oder Aktualisierung der pubm-Konfiguration
• Anbindung von CI
• Aktivierung von Changesets
• optional die Anbindung von Version-Sync-Zielen

Gib dem Agenten den Link INSTALLATION.md, damit er das Bundle abrufen und dem eingecheckten Setup-Flow folgen kann.

Was das pubm plugin dem Agenten liefert

Das Repository liefert unter plugins/pubm-plugin/ ein Bundle für Agenten aus.

Dieses Bundle enthält derzeit:

• ein Claude-Code-Plugin-Manifest unter plugins/pubm-plugin/.claude-plugin/plugin.json
• ein eingechecktes Skill-Bundle unter plugins/pubm-plugin/skills/

Enthaltene Skills

publish-setup

Nutze dies zuerst, wenn du pubm über einen Agenten in ein Repository einbindest.

publish-preview

Nutze dies, wenn der Agent den Release-Plan erklären soll, bevor er den Git-Zustand ändert oder etwas veröffentlicht.

publish

Dies ist der abgesicherte Veröffentlichungspfad. Er beginnt mit einer Vorschau und verlangt eine Bestätigung, bevor der eigentliche Publish-Befehl ausgeführt wird.

version-sync

Nutze dies, um Versionsverweise außerhalb von Paket-Manifests zu finden und anzubinden, etwa in Doku-Snippets, Metadaten-Dateien und Nebenkonfigurationen.

create-plugin

Nutze dies, wenn der Agent ein neues pubm-Plugin-Paket mit Hooks, Befehlen und Tests anlegen soll.

Claude-Code-Installation

Claude Code nutzt ein marketplace-basiertes Plugin-Modell.

Typischer Ablauf:

1. den Marketplace hinzufügen
2. das Plugin aus diesem Marketplace installieren
3. in Claude Code den Installationsbereich wählen

/plugin marketplace add your-org/claude-plugins
/plugin install plugin-name@marketplace-name

Wenn du keinen Marketplace nutzt, gib dem Agenten stattdessen den Link INSTALLATION.md.

Integrationsmodell

• halte das Laufzeitverhalten der Releases in pubm selbst oder in einem pubm-Plugin
• halte Agent-Workflows und Freigaberichtlinien in eingecheckten Skills
• halte die Setup-Automatisierung für das Onboarding des Repositories maßgeblich

Skills und Befehlsoberfläche

Skills sollen die CLI orchestrieren, nicht ersetzen.

• verwende pubm-Befehle für deterministische Release-Operationen
• verwende Skills für Setup-Reihenfolge, Projektinspektion, Sicherheitsprüfungen und Freigaben

Sicherheitsregeln

• Setup vor dem Veröffentlichen in neuen Repositories
• Preview vor dem Veröffentlichen in bestehenden Repositories
• ausdrückliche Freigabe vor irreversiblen Aktionen
• Klartext-Zusammenfassungen für Versionen, Registries und Nebenwirkungen
• stoppen, wenn Git-Zustand, Authentifizierung oder CI-Annahmen noch nicht bereit sind

Praktische Hinweise

• behandle publish-setup als die primäre Integrationsfläche
• halte Setup- und Publish-Automatisierung im selben eingecheckten Bundle
• stelle pubm-Befehle direkt bereit, statt sie in vage Natursprache zu übersetzen
• behandle pubm als letzten Schritt, nicht als Standard-Schritt