← Zurück zur Übersicht

KI-System

Kein Zufalls-Prompting. Ein System.

Ich nutze KI in der Entwicklung nicht ad hoc, sondern über ein bewusst gebautes System aus vier Bausteinen: Rules, Skills, Agents und Hooks. Jeder übernimmt eine andere Aufgabe – zusammen ergeben sie einen nachvollziehbaren, automatisiert durchgesetzten Workflow, im Job wie in eigenen Projekten.

Live im Agentic Infra Dashboard ansehen

Vier Bausteine, ein System

Jeder Baustein übernimmt eine andere Rolle im selben Ablauf – von der stillschweigenden Konvention bis zur automatisierten Durchsetzung.

Rules

Grundkonventionen, die in jedem Repo automatisch gelten – ich muss sie nicht in jedem Prompt wiederholen. Eine CLAUDE.md pro Workspace-Ebene, plus dedizierte Regel-Dateien je Thema.

  • Code-Style — TS strict, PSR-12/Symfony, Vue-SFC-Konventionen
  • Git & Commits — Branch-Namen, Conventional Commits, PR-Format
  • Security & Secrets — Keychain statt Klartext, keine echten Keys in öffentlichen Repos
  • Spec-Driven Development — erst Spec, dann Plan, dann Code
  • Test-Driven Development — Rot-Grün-Refactor ist Pflicht
  • Worktrees — parallele Agenten ohne Datei-Kollisionen

Skills

Wiederkehrende Abläufe, die ich per Kommando auslöse, statt sie jedes Mal neu zu erklären. „/feature“ verkettet die anderen zu einem kompletten Fluss.

  • /feature — verkettet Spec → Plan → Tests → Implementierung → Gates → Review
  • /spec — schreibt die Spec (Problem, User Stories, Akzeptanzkriterien)
  • /commit — Conventional Commit im Workspace-Format
  • /worktree — isolierten Arbeitsbaum für Parallelarbeit anlegen
  • /new-app — Repo-Grundgerüst inkl. CI und Commit-Setup
  • /wrap-session — strukturierter Abschluss einer Arbeits-Session

Agents

Spezialisierte Rollen mit eigenem Werkzeugkasten, die ich gezielt für einzelne Schritte einsetze, statt einem einzelnen Modell alles auf einmal zu geben.

  • orchestrator — zerlegt mehrschichtige Features, koordiniert die anderen Agents
  • planner — Implementierungsplan inkl. Interfaces & Contracts, schreibt keinen Code
  • tester — schreibt fehlschlagende Tests aus den Plan-Contracts (Rot)
  • implementer — macht Tests grün, hält sich an die Quality-Gates
  • reviewer — prüft Diffs auf echte Fehler, nicht auf Stil
  • security — auditiert Auth, Input-Handling und Secrets vor dem Ship
  • data-analyst — Schema-, Migrations- und Query-Planung
  • docs — hält README, Changelog und Doku synchron zum Code

Hooks

Automatisierte Durchsetzung im Hintergrund – nicht auf Disziplin verlassen, sondern technisch blockieren, was gegen die eigenen Regeln verstößt.

  • git-safety — blockiert force-push, main-Push, reset --hard, .env-Commits
  • tdd-gate — blockiert commit ohne grünen Testlauf, PR ohne Lint/Typecheck/Test
  • infra-dashboard-sync — hält das Agentic-Infra-Dashboard automatisch aktuell
  • stop-notify — Benachrichtigung, wenn ein Agentenlauf fertig ist

So läuft ein Feature durch das System

Am Beispiel eines nicht-trivialen Features – ausgelöst mit einem einzigen Befehl.

  1. 01
    Skill · /spec

    Spec schreiben

    Problem, User Stories und prüfbare Akzeptanzkriterien – bevor irgendetwas gebaut wird. Ich gebe die Spec frei, bevor es weitergeht.

  2. 02
    Agent · planner

    Plan erstellen

    Layer-für-Layer-Plan mit Interfaces & Contracts. Kein Code – nur die Entscheidungen, die tester und implementer verbindlich brauchen.

  3. 03
    Agent · tester

    Tests schreiben (Rot)

    Fehlschlagende Tests direkt aus den Plan-Contracts – ohne die Implementierung zu kennen.

  4. 04
    Agent · implementer

    Implementieren (Grün)

    Macht die Tests grün, nicht mehr. Hält sich an Code-Style- und Security-Rules.

  5. 05
    Hook · tdd-gate + git-safety

    Gate erzwingen

    Commit wird technisch blockiert, wenn seit der letzten Änderung kein grüner Testlauf erkannt wurde – unabhängig davon, ob ich es vergesse.

  6. 06
    Agent · reviewer + security

    Review gegen die Spec

    Prüft den Diff auf echte Fehler und gegen die Akzeptanzkriterien der Spec – nicht auf Geschmack.

Bei Einzeilern oder Trivialfixes übernehme ich diesen Ablauf komplett selbst, ohne den vollen Agenten-Apparat – das System skaliert mit der Aufgabe, nicht gegen sie.