So schreiben wir Code. Jetzt auch die Agents.

Fünf Grundsätze

Die Golden Rules

Wähle eine Regel, um zu sehen, was sie verlangt und wo das Plugin sie anwendet.

Ein Feature in einem bestehenden Projekt

In einem TYPO3-Projekt sollen Referenzen nach Branche filterbar werden. Das Projekt wurde einmal mit /zdrei-core:setup eingerichtet.

Kleine Änderungen brauchen weniger: Ein Tippfehler braucht weder Plan noch Review, die Checks nach jedem Edit laufen trotzdem. Den Plan zu bestätigen ist eine Empfehlung; bei „mach einfach“ legt der Agent los.

Komponenten

Plugins im Marketplace

Unterstützung je Tool

Wann welche PHP-Checks laufen

Das hängt davon ab, ob das Projekt den zdrei.com-Builder hat.

Security-Review aus drei Quellen

/zdrei-core:security kombiniert vorhandene Werkzeuge, statt alles selbst zu bauen. Standard ist das Review einer Änderung; ein vollständiges Audit läuft nur auf ausdrücklichen Wunsch.

Ein Befund zählt nur, wenn er einen niedriger privilegierten Akteur, die Eingabe, die verletzte Grenze und ein konkretes Ergebnis benennt. Das vollständige Audit nutzt viele Agents, braucht Node.js für die Validatoren und schreibt seinen Bericht nach ~/security-audit-skill/<repo>/run-<N>, außerhalb des Projekts.

Den Marketplace einbinden

Das Repository ist privat. Zugriff gibt es über einen lesenden Deploy Token (Scope read_repository): einen für zdrei.com und je einen pro Kunde, damit jeder Zugang einzeln widerrufen werden kann. Der Token ist Teil der Marketplace-URL.

{
  "extraKnownMarketplaces": {
    "zdrei": {
      "source": {
        "source": "git",
        "url": "https://<token-user>:<token>@git.z3.ag/zdrei.com/product/p1599-ai-marketplace.git"
      },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "zdrei-core@zdrei": true
  }
}

claude plugin marketplace add "https://<token-user>:<token>@git.z3.ag/zdrei.com/product/p1599-ai-marketplace.git"
claude plugin install zdrei-core@zdrei

codex plugin marketplace add "https://<token-user>:<token>@git.z3.ag/zdrei.com/product/p1599-ai-marketplace.git"
codex plugin install zdrei-core

npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit

git config --global credential.helper osxkeychain
git config --global credential.https://git.z3.ag.useHttpPath true
printf 'protocol=https\nhost=git.z3.ag\npath=zdrei.com/product/p1599-ai-marketplace.git\nusername=<token-user>\npassword=<token>\n' | git credential approve
claude plugin marketplace add https://git.z3.ag/zdrei.com/product/p1599-ai-marketplace.git
claude plugin install zdrei-core@zdrei

claude plugin marketplace remove zdrei
claude plugin marketplace add "https://<token-user>:<new-token>@git.z3.ag/zdrei.com/product/p1599-ai-marketplace.git"
claude plugin install zdrei-core@zdrei

Fehlerbehebung

Die häufigsten Probleme nach Symptom. Jeder Eintrag hat einen eigenen Link, den du im Chat oder Ticket teilen kannst.

claude plugin marketplace update zdrei

claude plugin marketplace update zdrei
claude plugin update zdrei-core@zdrei

bin/builder analyse:php

Guideline und ADRs

skills/guideline/references/coding-guidelines.md ist eine Kopie von doc/1_Guidelines/coding-guidelines.md aus p1453-z3-coding-styleguide, die ADRs kommen aus doc/5_Architecture/adr/. Geändert wird dort, nie hier. /update-guideline kopiert beides aus demselben Commit.

Priorität beim Anwenden

1. Golden Rules zuerst. Passt eine Detailregel nicht, wird im Sinne der Golden Rules entschieden.
2. zdrei.com ADRs erklären Strukturregeln. Akzeptierte ADRs sind verbindlich, vorgeschlagene noch nicht.
3. Projektregeln in AGENTS.md, CLAUDE.md, GLOSSARY.md und Projekt-ADRs ergänzen und gewinnen bei ausdrücklichem Widerspruch.
4. Tools setzen Deterministisches durch. Befunde werden behoben, nie unterdrückt.

Abschnitte der Guideline

Die Golden Rules (Abschnitt 1) stehen oben. Die Links öffnen den Abschnitt im Repository.

Architecture Decision Records

Im Plugin zitiert als zdrei.com ADR-NNNN, damit sie nicht mit den ADRs des Projekts verwechselt werden.

Release-Checkliste

Nutzer bekommen eine neue Version nur, wenn sich version ändert. Der Haken wird nur in deinem Browser gespeichert.

• Guideline und ADRs aus p1453-z3-coding-styleguide (main) mit /update-guideline kopieren.
• version erhöhen in plugins/zdrei-core/.claude-plugin/plugin.json und plugins/zdrei-core/plugin.json.
• Eintrag in CHANGELOG.md, inklusive des Styleguide-Commits, aus dem die Guideline kopiert wurde.
• docs/index.html aktualisieren: Version, Changelog und geänderte Komponenten, Installationsschritte oder ADRs.
• Validieren: claude plugin validate . und claude plugin validate ./plugins/zdrei-core.
• Mergen, dann taggen: zdrei-core--v<version> (oder claude plugin tag --push im Plugin-Verzeichnis).
• Prüfen, dass der Job deploy_staging in der main-Pipeline die Doku-Seite deployt hat.

Lokal entwickeln

claude --plugin-dir ./plugins/zdrei-core

Nach Änderungen /reload-plugins ausführen.

Changelog

Quelle: CHANGELOG.md

Dokumentation