CLAUDE.md, Hooks & Skills Engineering für Platform-Teams

Ich baue für Platform-Teams CLAUDE.md-Template-Libraries, Pre/Post-Tool-Hooks und projektspezifische Skills, damit Coding-Agents im gesamten Unternehmen konsistent und sicher arbeiten - über Repo-Grenzen hinweg.

In großen Engineering-Organisationen reicht eine einzelne CLAUDE.md nicht. Sie brauchen Standards, die über mehrere Repositories hinweg konsistent bleiben.

Jedes Team baut eigene CLAUDE.md-Dateien, eigene Hooks und eigene Skills - ohne Standards, ohne Audit-Trail, ohne zentrale Pflege. Coding-Agents verhalten sich pro Repo unterschiedlich.

CLAUDE.md-Template-Library, Pre/Post-Tool-Hook-Bibliothek, projektspezifische Skills-Sammlung, Onboarding-Playbook und Integration in Ihre DevX-Plattform.

Skalierende Engineering-Organisationen merken: AI-Coding-Tools sind nur produktiv, wenn die Konfiguration in den Repos konsistent ist. In der Realität sieht es anders aus: das Frontend-Team hat eine eigene CLAUDE.md, das Backend-Team eine andere, das Platform-Team gar keine. Hooks sind copy-paste, Skills werden nicht versioniert, neue Repos starten von Null.

Ich baue mit Ihrem Team eine zentrale Template-Library, projektspezifische Skills und standardisierte Hooks. Ein Bootstrap-Skript oder Ihre DevX-Plattform verteilt das Setup in die vorgesehenen Repositories.

Typische Ausgangslage

  • Jedes Repo hat eine andere CLAUDE.md-Struktur - neue Engineers verstehen sie nicht
  • Pre/Post-Tool-Hooks sind nicht zentral gepflegt, brechen bei Tool-Updates
  • Wiederverwendbare Skills (Code-Review, Deploy, Test-Generation) sind nicht gesammelt
  • Onboarding eines neuen Repos in den AI-Coding-Workflow dauert Tage
  • Compliance/Security hat keine Sicht auf was Coding-Agents in welchem Repo dürfen

Was ich liefere

  • CLAUDE.md-Template-Library: Skeleton + projekttypspezifische Erweiterungen (Frontend, Backend, Infra, …)
  • Hook-Bibliothek: standardisierte Pre/Post-Hooks für gängige Tools (npm, git, terraform, kubectl, …)
  • Skills-Sammlung: wiederverwendbare Skills für Code-Review, Test-Generation, Deploy, Doc-Update
  • Bootstrap-Skript oder DevX-Integration für neue Repositories
  • Audit-Layer: was darf der Coding-Agent in welchem Repo, was wird geloggt

Technischer Ansatz

  • CLAUDE.md als modulares Template-System (Skeleton + Includes pro Projekttyp)
  • Hook-Library als versioniertes NPM-Package oder Git-Submodule (zentrale Updates)
  • Skills als Bibliothek mit semver-Versionierung pro Skill
  • Bootstrap via cookiecutter, npm/pnpm-Template oder Backstage-Plugin
  • Logging über Pre/Post-Tool-Hooks an Ihr SIEM oder Audit-Backend

Ablauf

  • Discovery: bestehende Repos, Tool-Versionen, DevX-Plattform, Compliance-Anforderungen
  • Design: Template-Architektur, Hook-Bibliothek, Skills-Liste, Bootstrap-Pfad
  • Implementation: Library aufbauen, in 2-3 Pilot-Repos ausrollen, iterieren
  • Übergabe: Playbook, Team-Session, Wartungsverantwortung an Platform-Team übergeben

Warum ich

  • Erfahrung mit Hooks aus DevOps-Context (pre-commit, Husky, GitHub Actions)
  • AWS-Background: Infrastructure-as-Code-Mindset auf AI-Coding übertragen
  • Vendor-agnostisch: Templates funktionieren mit Claude Code, Cursor, Codex
  • Remote deutschlandweit, deutsche Verträge

Häufige Fragen

Warum nicht einfach Copy-Paste der CLAUDE.md zwischen Repos?

Kopien entwickeln sich unabhängig weiter. Eine Template-Library hält den gemeinsamen Teil zentral und erlaubt gezielte Ergänzungen pro Repository.

Was sind Pre/Post-Tool-Hooks konkret?

Hooks sind Skripte, die vor oder nach jedem Tool-Call des Coding-Agents laufen. Beispiele: vor git commit automatisch Tests laufen, nach npm install Security-Audit triggern, vor kubectl apply Diff anzeigen. Standardisiert über alle Repos.

Wie integrieren Sie Backstage oder unseren DevX-Stack?

Ich baue ein Backstage-Plugin oder Bootstrap-Skript für Ihre DevX-Plattform. Die konkrete Form hängt von Ihrer vorhandenen Plattform ab.

Was passiert wenn Anthropic die Spec ändert?

Die Template-Library und Hook-Library sind semver-versioniert. Bei Spec-Breaking-Changes gibt es eine Major-Version-Update mit Migration-Skript. Wartung kann über LLM-Office-Hours-Retainer abgesichert werden.

Wird das auch für Cursor / Continue gebaut?

Ja. Entsprechende Konfigurationen für Cursor oder Continue können aus einer gemeinsamen Spezifikation entstehen. So bleibt Ihr Tooling über mehrere Werkzeuge hinweg konsistent.

Was ist der Unterschied zwischen Hooks, Skills und Commands?

Commands sind benutzerinitiierte Workflows (z.B. /deploy, /review). Skills sind komplexere, mehrschritte Workflows mit eigenem Kontext (z.B. database-migration-skill). Hooks laufen automatisch vor oder nach Tool-Calls (pre-commit, pre-deploy). Im Engineering kommen meist alle drei zum Einsatz - die Library standardisiert sie quer ueber Repos.

Wie wird sichergestellt, dass die Templates nicht zu starr werden?

Templates sind modular: Skeleton + projekttyp-spezifische Includes + repo-spezifischer Override. Beispiel: jedes Repo bekommt das gleiche Skeleton (Build-Befehle, Naming-Konventionen), TypeScript-Repos zusaetzlich TS-Includes (eslint-Regeln, Type-Patterns), und repo-spezifischer Override fuer Eigenheiten. So bleibt Standard + Flexibilitaet im Gleichgewicht.

Was passiert mit Repos, die schon eine CLAUDE.md haben?

Im Audit vergleiche ich die vorhandenen Dateien mit dem Zielbild. Brauchbare Teile bleiben erhalten, repository-spezifische Regeln werden getrennt und überholte Konfigurationen entfernt.

Wie integrieren Sie Audit-Logging?

Pre/Post-Tool-Hooks können strukturierte Logs an Ihr SIEM oder Audit-Backend senden. Welche Felder erfasst werden dürfen, kläre ich mit Ihrem Security- und Compliance-Team.

Brauchen wir dafuer Backstage?

Nein. Backstage ist nice-to-have fuer das Bootstrapping neuer Repos, aber nicht zwingend. Alternative: cookiecutter-Template, npm/pnpm Create-Template oder ein einfaches Shell-Skript. Welche Option am besten passt, klaeren wir im Discovery.