Agent-Katalog¶

Übersicht aller verfügbaren Claude Code Agents im Kamerplanter-Projekt für autonome Feature-Implementierung, Requirements Engineering, Code-Reviews und Dokumentation.

Schnellreferenz¶

Agents nach Kategorie¶

Agent-Details¶

agent-catalog-generator¶

Modell: haiku | Tools: Read, Write, Glob, Grep

Rolle: Technical Writer, der alle Agent-Definitionen systematisch einliest und einen kompakten, entwicklerfreundlichen Katalog generiert.

Workflow: 1. Alle Agent-Definitionen aus .claude/agents/*.md einlesen 2. YAML-Frontmatter und Markdown-Body analysieren 3. Agents nach Kategorie gruppieren und sortieren 4. Dokumentations-Katalog mit Tabellen, Tabs und Details generieren 5. RAG-optimierte Metadaten einfügen

Output: docs/de/development/agent-catalog.md — Dieser Katalog mit Übersicht, Tabellen, Kategorisierung und Entscheidungshilfe

agrobiology-requirements-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Agrarbiologie-Experte mit 20+ Jahren Praxis in Indoor-Anbau, Hydroponik, Zimmerpflanzen und geschütztem Anbau, der Anforderungen auf biologische Korrektheit und Vollständigkeit prüft.

Workflow: 1. Anforderungsdokumente einlesen und klassifizieren (Indoor/Hydroponik/Outdoor) 2. Biologische Korrektheit prüfen (Licht, Temperatur, VPD, Substrate) 3. Vollständigkeitschecklisten abarbeiten (Zimmerpflanzen, Hydroponik, IPM) 4. Datenquelle-Verfügbarkeit bewerten 5. Report mit Findings (Fehler/Unvollständig/Ungenau) erstellen

Output: spec/requirements-analysis/agrobiology-review.md — Detaillierter Report mit botanischen Findings, Korrekturvorschlägen und Datenquellen

cannabis-indoor-grower-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Cannabis-Anbau-Spezialist der Spezifikationen auf Legalität, Durchführbarkeit und Best-Practice-Konformität prüft.

Workflow: 1. Alle Cannabis-spezifischen Anforderungen identifizieren 2. Legale Grundlagen prüfen (CanG Lizenzpflicht, PflSchG Karenzzeiten) 3. Genetische Daten, Phänotypen, Terpene bewerten 4. Growing-Parameter (Photoperiode, VPD, EC) validieren 5. Report mit Legal-Checks und Best-Practice-Abweichungen

Output: spec/requirements-analysis/cannabis-grower-review.md — Legalitäts-Check, Growing-Parameter-Validierung, Risiko-Bewertung

casual-houseplant-user-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Planloser Zimmerpflanzenbesitzer ohne grünen Daumen, der Anforderungen auf Alltagstauglichkeit und Anfänger-Freundlichkeit prüft.

Workflow: 1. Alle Anforderungen aus Laien-Perspektive lesen 2. Dealbreaker-Features identifizieren (z.B. Foto-Erkennung) 3. Frustrierendes und Überforderendes markieren 4. Aufwand pro Woche schätzen 5. Konkurrenz-Vergleich (Planta, Greg) durchführen 6. Report mit Dealbreakern, Optimierungen, Aufwand-Analyse

Output: spec/requirements-analysis/casual-houseplant-user-review.md — Laien-Perspektive, Dealbreaker, Aufwand-Analyse, Konkurrenz-Vergleich

code-security-reviewer¶

Modell: sonnet | Tools: Read, Edit, Bash, Glob, Grep

Rolle: Application Security Engineer, der implementiertem Backend- und Frontend-Code auf OWASP-Top-10-Schwachstellen prüft und behebt.

Workflow: 1. Backend- und Frontend-Code analysieren (Discovery) 2. OWASP-A01 bis A10 systematisch prüfen 3. Tenant-Isolation, RBAC, JWT, Secrets validieren 4. Kritische Schwachstellen (P0/P1) sofort beheben 5. Security-Report mit behobenen und offenen Punkten

Output: spec/requirements-analysis/code-security-review.md — Security-Audit, P0/P1/P2/P3 Findings, Compliance-Matrix

e2e-testcase-extractor¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Elite QA-Architekt, der E2E-Testfälle aus Spezifikationen aus der Endbenutzerperspektive (Browser-Sicht) systematisch ableitet.

Workflow: 1. Spezifikationen einlesen und nach testbaren Szenarien decomposieren 2. Für jedes UI-Element Test Cases ableiten (Happy Path + Fehler) 3. Testfälle strukturieren: Preconditions → Test Steps → Expected Results 4. RAG-Metadaten (Frontmatter, Tags) hinzufügen 5. Strukturierte Testfall-Dateien generieren

Output: spec/test-cases/TC-{REQ-ID}.md — RAG-optimierte Testfall-Dokumente mit Traceability

frontend-design-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Frontend-Designer mit 15+ Jahren Erfahrung in Responsive Design, Kiosk-Systemen und Touch-Interfaces für raue Arbeitsumgebungen.

Workflow: 1. Alle Anforderungen nach Bedienkontext klassifizieren 2. Responsive Design prüfen (Breakpoints, Fluid Grids) 3. Kiosk-Modus bewerten (64–72px Touch-Targets, Vereinfachung) 4. Mobile Vor-Ort-Szenarien validieren 5. Report mit Design-Findings und Wireframe-Vorschlägen

Output: spec/requirements-analysis/frontend-design-review.md — Responsive-Matrix, Kiosk-Detailbewertung, Touch-Target-Audit, Wireframes

frontend-usability-optimizer¶

Modell: sonnet | Tools: Read, Write, Edit, Bash, Glob, Grep

Rolle: UX-Engineer, der React/MUI-Komponenten nach Mobile-First-Prinzip für bessere Usability optimiert (Labels, Hilfstexte, Validierung, Layout).

Workflow: 1. Code einlesen und Usability-Probleme identifizieren 2. Beschreibende Texte und Hilfstexte ergänzen 3. Feldanordnung und Validierung optimieren 4. Mobile-First Progressive Enhancement umsetzen 5. UI-NFR-Compliance-Prüfung durchführen 6. Tests durchführen und Zusammenfassung ausgeben

Output: Optimierter Code in src/frontend/ + Zusammenfassung mit Usability-Verbesserungen und Compliance-Checks

fullstack-developer¶

Modell: opus | Tools: Read, Write, Edit, Bash, Glob, Grep

Rolle: Senior Full-Stack-Entwickler, der Features vollständig (Backend FastAPI + Frontend React) unter strikter Einhaltung aller NFRs umsetzt.

Workflow: 1. Anforderungs-Spezifikationen einlesen 2. Backend: ArangoDB-Modelle, APIs, Services, Tests 3. Frontend: React-Komponenten, Redux-Slices, Tests 4. Alle NFRs und UI-NFRs einhalten 5. Unit-Tests schreiben und validieren

Output: Produktionsreife Implementierung in Backend + Frontend mit Tests, der unit-test-runner kann grün werden

gemini-graphic-prompt-generator¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Visual Design Director, der präzise, produktionsreife Google Gemini Prompts für Icons, Illustrationen und Marketing-Material generiert.

Workflow: 1. Design-Anforderungen analysieren 2. Kamerplanter Corporate Design anwenden (Farben, Stil) 3. Gemini-Prompts mit Design-Details schreiben 4. Light/Dark-Mode-Varianten spezifizieren 5. Qualitäts-Kriterien (Transparenz, Auflösung) definieren

Output: Gemini Image Generation Prompts für Designer/Marketing — z.B. für Icons, Illustrationen

growing-phase-auditor¶

Modell: sonnet | Tools: Read, Write, Edit, Glob, Grep, Bash, WebSearch, WebFetch

Rolle: Gartenbau-Wissenschaftler, der Wachstumsphasen-Daten (bloom_months, harvest_months, etc.) in Seed-YAML auf biologische Korrektheit und chronologische Konsistenz prüft.

Workflow: 1. Alle Seed-YAML-Dateien einlesen 2. Gegen 5 Prüfregeln validieren (Lückenloses, Biologie, Plausibilität) 3. Korrektur-Vorschläge mit WebSearch-Verifikation 4. YAML-Dateien direkt mit Edit-Tool korrigieren 5. Report mit Findings und Korrektionen erstellen

Output: Korrigierte YAML-Dateien + spec/requirements-analysis/growing-phase-audit.md mit Findings und Verifikation

ha-integration-requirements-engineer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Home Assistant Specialist mit 8+ Jahren HACS-Integration-Entwicklung, der aus REQ-Dokumenten konkrete HA-Integrations-Anforderungen ableitet.

Workflow: 1. REQ-Dokumente einlesen 2. Drei-Seiten-Modell anwenden (Export A, Import B, Control C) 3. Entity-Taxonomien definieren 4. Coordinator-Datenstrukturen entwerfen 5. API-Anforderungen spezifizieren

Output: spec/ha-integration/HA-CUSTOM-INTEGRATION.md — Entity-Mappings, Coordinators, Services, Events

ha-integration-sync¶

Modell: opus | Tools: Read, Write, Edit, Bash, Glob, Grep

Rolle: Home Assistant Integration Developer, der die kamerplanter-ha Custom Integration mit der aktuellen Backend-API synchronisiert, ohne bestehende Fachlogik zu verändern.

Workflow: 1. Backend-API-Endpunkte erfassen 2. HA-API-Client (api.py) analysieren 3. Delta-Analyse durchführen (neue/geänderte Endpunkte) 4. Koordinator-, Sensor-, Service-Code anpassen 5. HA-Integration deployen

Output: Aktualisierte HA-Integration-Dateien + Deploy-Anweisungen

it-security-requirements-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: IT-Security-Architekt mit 15+ Jahren Erfahrung, der Anforderungen auf Sicherheit, Datenschutz und DSGVO-Compliance prüft.

Workflow: 1. Alle Anforderungen einlesen 2. Sicherheits-Index erstellen (Daten, Zugriff, Schnittstellen) 3. Datenschutz-Anforderungen (DSGVO Art. 15–21) validieren 4. OWASP ASVS gegen Specs abgleichen 5. Report mit Security-Lücken und DSGVO-Empfehlungen

Output: spec/requirements-analysis/it-security-review.md — Sicherheitsbewertung, DSGVO-Audit, Empfehlungen

mkdocs-documentation¶

Modell: sonnet | Tools: Read, Write, Edit, Bash, Glob, Grep

Rolle: Technical Writer und Documentation Engineer, der endnutzerfreundliche, mehrsprachige Dokumentation im MkDocs-Material-Format erstellt und pflegt.

Workflow: 1. Dokumentation im MkDocs-Material-Format schreiben 2. Deutsch und Englisch parallel (i18n) 3. Mermaid-Diagramme für Visualisierungen verwenden 4. mkdocstrings für API-Docs aus Docstrings 5. lokale mkdocs-Vorschau testen

Output: docs/de/ und docs/en/ — Benutzer- und Admin-Dokumentation

outdoor-garden-planner-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Ambitionierte Hobbygärtnerin mit 15 Jahren Freiland-Garten + 80m² Gemeinschaftsgarten-Parzelle, die Anforderungen auf Praktikabilität und Alltags-Relevanz prüft.

Workflow: 1. Anforderungen aus Hobbygärtner-Perspektive lesen 2. Gartenleben-Workflows identifizieren 3. Freiland-Alltagstauglichkeit bewerten 4. Fruchtfolge, Überwinterung, Mischkultur-Features validieren 5. Report mit praktischen Hinweisen und Verbesserungsvorschlägen

Output: spec/requirements-analysis/outdoor-garden-planner-review.md — Hobbygärtner-Perspektive, Praxis-Feedback

plant-info-document-generator¶

Modell: sonnet | Tools: Read, Write, Glob, Grep, WebSearch, WebFetch

Rolle: Agrar-Botaniker mit 20+ Jahren Praxis (Gärtnerei, Indoor-Growing, Schrebergarten), der detaillierte Pflanzen-Steckbriefe recherchiert und dokumentiert.

Workflow: 1. Nutzereingabe analysieren (Pflanzenname, Liste) 2. Wissenschaftliche Namen recherchieren 3. Taxonomie, Phasen, Nährstoffe, IPM, Mischkultur erfassen 4. Quellen verifizieren (RHS, USDA, DWD) 5. Strukturiertes Dokument für Datenimport ausgeben

Output: Detaillierte Pflanzen-Informationsdokumente für Datenimport

png-to-transparent-svg¶

Modell: haiku | Tools: Read, Write, Bash, Glob

Rolle: Bildverarbeitungs-Spezialist, der PNG-Bilder mit Schachbrett-Hintergrund in saubere SVGs mit echter Transparenz konvertiert.

Workflow: 1. PNG-Input analysieren (Alpha-Kanal prüfen) 2. Schachbrettmuster erkennen und entfernen 3. Bereinigtes PNG mit echter Alpha-Transparenz erzeugen 4. PNG mit vtracer zu SVG vektorisieren 5. SVG-Datei speichern

Output: Transparente SVG-Dateien → assets/icons/ oder benutzerdefinierter Zielordner

pr-to-develop¶

Modell: sonnet | Tools: Read, Bash, Glob, Grep

Rolle: Release Engineer, der GitHub Pull Requests von Feature-Branches nach develop mit CI-Validierung und aussagekräftiger Dokumentation vorbereitet.

Workflow: 1. Branch-Analyse (Commits seit develop) 2. Geänderte Dateien analysieren (Backend/Frontend/Spec) 3. REQ/NFR-Nummern identifizieren 4. PR-Titel und ausführliche Beschreibung erstellen 5. Labels setzen und auf CI warten

Output: GitHub Pull Request nach develop mit Titel, Beschreibung, Labels, CI-Status

requirements-contradiction-analyzer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep, Bash

Rolle: Requirements Engineer, der Anforderungsdokumente mittels RAG auf Widersprüche zwischen funktionalen und non-funktionalen Anforderungen systematisch analysiert.

Workflow: 1. Alle Anforderungs-Dokumente einlesen (RAG-Retrieval) 2. Anforderungen klassifizieren (FA/NFA) 3. Anforderungs-Index aufbauen 4. Systematisch auf Widersprüche prüfen 5. Report mit Widerspruch-Findings generieren

Output: spec/requirements-analysis/contradiction-analysis.md — Widersprüche, Inkonsistenzen, Empfehlungen

seed-data-validator¶

Modell: sonnet | Tools: Read, Write, Glob, Grep, Bash, WebSearch, WebFetch

Rolle: Datenqualitäts-Ingenieur, der YAML-Seed-Daten auf Vollständigkeit, Konsistenz, referenzielle Integrität und botanische Plausibilität prüft.

Workflow: 1. YAML-Seed-Dateien einlesen 2. Schema-Konformität prüfen 3. Referenzielle Integrität validieren 4. Botanische Plausibilität bewerten (optional Agrobiology-Reviewer) 5. Multi-Source-Verifikation (Hersteller, SDS, Händler) 6. Report mit Data Quality Findings

Output: spec/requirements-analysis/seed-data-validation.md — Datenqualitäts-Report mit Findings

selenium-test-generator¶

Modell: opus | Tools: Read, Write, Edit, Glob, Grep, Bash

Rolle: QA-Ingenieur und Selenium-Experte, der NFR-008-konforme Python-Selenium-Tests mit Page-Object-Pattern und Screenshot-Checkpoints generiert.

Workflow: 1. NFR-008 und Testfall-Dokumente lesen 2. Anforderungen analysieren (testbar) 3. Page-Objects erstellen 4. Test-Klassen mit pytest generieren 5. Screenshot- und Protokoll-Funktionalität integrieren 6. Tests lokal validieren

Output: tests/e2e/test_*.py — NFR-008-konforme Selenium-Tests mit Protokoll-Generierung

selenium-test-reviewer¶

Modell: sonnet | Tools: Read, Write, Edit, Glob, Grep, Bash

Rolle: QA-Spezialist, der vorhandene Selenium-Tests auf Qualität, Wartbarkeit, Flakiness und NFR-008-Konformität reviewt und optimiert.

Workflow: 1. Bestehende Selenium-Tests analysieren 2. Auf NFR-008-Anforderungen prüfen 3. Flakiness-Probleme identifizieren 4. Code-Qualität, Wartbarkeit optimieren 5. Report mit Empfehlungen erstellen

Output: Optimierte Selenium-Tests + Qualitäts-Report

smart-home-ha-reviewer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Home Assistant Integration Reviewer, der die kamerplanter-ha Custom Integration gegen Spezifikation und Best Practices prüft.

Workflow: 1. HA-Integration Code analysieren 2. Gegen HA-CUSTOM-INTEGRATION.md prüfen 3. Entity-Taxonomien validieren 4. Coordinator-Datenfluss überprüfen 5. Report mit Konformität und Optimierungen

Output: spec/ha-integration/HA-REVIEW.md — HA-Integration Review mit Findings

target-audience-analyzer¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Markt- und UX-Analyst, der die Zielgruppen, Personas und Marktpotenziale der Anwendung systematisch analysiert und dokumentiert.

Workflow: 1. Anforderungen und Kontexte analysieren 2. Potenzielle Zielgruppen identifizieren 3. Personas mit Zielen, Schmerzpunkten, Motivation erstellen 4. Marktgröße und -potential schätzen 5. Report mit Personas und Marktanalyse

Output: spec/requirements-analysis/target-audience-analysis.md — Zielgruppen-Analyse, Personas, Marktpotenzial

tech-stack-architect¶

Modell: sonnet | Tools: Read, Write, Glob, Grep

Rolle: Tech-Architekt, der den definierten Tech-Stack (FastAPI, React, ArangoDB, Redis, Kubernetes) gegen Anforderungen validiert und Technologie-Entscheidungen begründet.

Workflow: 1. Anforderungen und NFRs einlesen 2. Tech-Stack definieren (Backend, Frontend, Datenbanken, Infra) 3. Anforderungen gegen Stack abgleichen 4. Alternative Technologies bewerten 5. Report mit Validierung und Begründungen

Output: spec/stack.md oder Technology Decision Record — Tech-Stack-Validierung mit Begründungen

unit-test-runner¶

Modell: sonnet | Tools: Read, Edit, Bash, Glob, Grep

Rolle: QA-Engineer und Test-Spezialist, der Unit-Tests (pytest, vitest) und statische Analyse (Ruff, ESLint, TypeScript) ausführt, Fehler analysiert und Fixes vorschlägt.

Workflow: 1. Backend-Ruff (lint + format) ausführen 2. Frontend-TypeScript und ESLint ausführen 3. Backend-Unit-Tests (pytest) ausführen 4. Frontend-Unit-Tests (vitest) ausführen 5. Test-Fehler analysieren und minimal fixe implementieren 6. Regressions-Check durchführen 7. Report mit Test-Ergebnissen und Merge-Status

Output: Test-Ergebnisse + Testbericht — grüne Tests oder Fehleranalyse mit Fixes

Einsatz-Entscheidungshilfe¶

Hinweise für Entwickler¶

• Agent starten: /agent <agent-name> im Claude Code Chat
• Reports: Analyse-Agents schreiben zu spec/requirements-analysis/, Selenium-Reports zu test-reports/, Testfälle zu spec/test-cases/, Doku zu docs/
• Modellwahl: opus = höchste Qualität (komplexe Features), sonnet = Preis-Leistung (Review, Analyse), haiku = schnell & günstig (einfache Tasks)
• Tool-Verfügbarkeit: Nicht alle Agents haben alle Tools — z.B. png-to-transparent-svg hat kein Edit-Tool

Agent-Abhängigkeiten und Workflow-Vorschläge¶

graph LR
    A["Spezifikation<br/>(REQ/NFR)"] --> B["tech-stack-architect<br/>requirements-contradiction-analyzer"]
    B --> C["agrobiology-requirements-reviewer<br/>cannabis-indoor-grower-reviewer<br/>casual-houseplant-user-reviewer<br/>it-security-requirements-reviewer"]
    C --> D["e2e-testcase-extractor"]
    D --> E["fullstack-developer"]
    E --> F["unit-test-runner"]
    F --> G["code-security-reviewer"]
    G --> H["pr-to-develop"]
    H --> I["GitHub Actions / CI"]

    E -.-> J["frontend-design-reviewer<br/>frontend-usability-optimizer"]
    E -.-> K["ha-integration-sync"]
    E -.-> L["growing-phase-auditor"]
    L -.-> M["seed-data-validator"]

    D -.-> N["selenium-test-generator"]
    N -.-> O["selenium-test-reviewer"]
    O -.-> P["unit-test-runner"]

    A -.-> Q["ha-integration-requirements-engineer"]
    Q -.-> K
    K -.-> R["smart-home-ha-reviewer"]

    A -.-> S["mkdocs-documentation"]
    A -.-> T["plant-info-document-generator"]
    A -.-> U["target-audience-analyzer<br/>outdoor-garden-planner-reviewer"]

    V["Icon/Grafik-Anforderungen"] -.-> W["gemini-graphic-prompt-generator"]
    W -.-> X["png-to-transparent-svg"]

Legende: - Durchgezogene Pfeile: Standard-Workflow (Spec → Implementation → QA → PR) - Gepunktete Pfeile: Parallele oder optionale Workflows (Design, HA, Doku, Grafik)

Kategorien-Übersicht¶

Analyse & Review (11 Agents): Bewerten Anforderungen und Code gegen Qualitätskriterien. Keine Implementierung.

Entwicklung (4 Agents): Schreiben oder optimieren produktiven Code und Integrations-Code.

Testing & QA (6 Agents): Erzeugen, validieren oder führen Tests aus. Sichern Qualität.

Design & Grafik (3 Agents): UI/UX-Optimierung und Asset-Generierung.

Dokumentation (3 Agents): Erstellen und pflegen Dokumentation und Steckbriefe.

Katalog aktualisiert: 2026-03-23 Agents dokumentiert: 27 Generiert von: agent-catalog-generator