Agenten-Übersicht — TimeInvoicer KI-Firma

Stand: 25. März 2026 | Referenz: PROJEKTPLAN.md (KI-Firma), .claude/rules/agent-team.md

Organigramm

                    ┌──────────────────────┐
                    │   Roland (CEO/CTO)   │
                    │   Entscheidungen &   │
                    │   Gesamtsteuerung    │
                    └──────────┬───────────┘
                               │
       ┌───────────────────────┼───────────────────────┐
       │                       │                       │
┌──────▼───────┐       ┌──────▼──────┐        ┌───────▼───────┐
│  STRATEGIE   │       │  QUALITÄT   │        │  FORSCHUNG    │
│  (Product)   │       │  (QA/Sec)   │        │  (Market/UX)  │
└──┬───────┬───┘       └──┬──────┬───┘        └──┬────────┬───┘
   │       │              │      │               │        │
 Strat.  Store-       Kritiker Sicherh.     Marktf.    UX
         Manager

┌──────────────────────────────────────────────────────────────┐
│                    ENTWICKLUNG                                │
│              Claude Code + Roland + Agenten                   │
└──┬──────┬──────────┬───────────┬──────────┬──────────┬───────┘
   │      │          │           │          │          │
 Hilfe  UI-Opt.  MinClick   Translator  Texter    SEO/Conv.

Skills (14 Stück)

Entwicklung & Qualität

Skill-Datei	Aufruf	Rolle	Wann einsetzen
`timeinvoicer-kritiker.skill`	`/timeinvoicer-kritiker`	Devil’s Advocate, Code-Review, Bug-Hunting	Nach jedem Feature (Phase B — PFLICHT)
`timeinvoicer-sicherheit.skill`	`/timeinvoicer-sicherheit`	CISO, DSGVO-Audit, Security-Scan	Vor jedem Release (Phase B — PFLICHT)
`timeinvoicer-help.skill`	`/timeinvoicer-help`	Coach-Marks, Onboarding, user_guide_de.html	Nach jedem UI-Feature (Phase C — PFLICHT)
`timeinvoicer-ui-optimizer.skill`	`/timeinvoicer-ui-optimizer`	Material3, Touch-Targets >=48dp, Responsive	Nach jedem UI-Feature (Phase C — PFLICHT)

Strategie & Planung

Skill-Datei	Aufruf	Rolle	Wann einsetzen
`timeinvoicer-strategie.skill`	`/timeinvoicer-strategie`	Product Owner, RICE-Score, Sprint-Planung	“was als nächstes”, Projektplan-Updates
`timeinvoicer-ux.skill`	`/timeinvoicer-ux`	User-Flows, Heuristik-Evaluation, Accessibility	“UX Review”, “ist das intuitiv”
`timeinvoicer-minimalclick.skill`	`/timeinvoicer-minimalclick`	Click-Reduktion, Flow-Analyse, Protokoll	“MinimalClick”, “weniger Taps”

Marktforschung & Marketing

Skill-Datei	Aufruf	Rolle	Wann einsetzen
`timeinvoicer-marktforscher.skill`	`/timeinvoicer-marktforscher`	Konkurrenz-Analyse, Preise, Reviews, Trends	Monatlich oder “was macht die Konkurrenz”
`timeinvoicer-texter.skill`	`/timeinvoicer-texter`	Verkaufstexte, Hero-Texte, emotional aus Psychologen-Sicht	Website-Content, Feature-Beschreibungen
`timeinvoicer-conversion.skill`	`/timeinvoicer-conversion`	Beta-Signup, Testimonials, FAQs, Landing Pages	Conversion-Optimierung, Lead-Generierung
`timeinvoicer-seo.skill`	`/timeinvoicer-seo`	Blog-Artikel, Keywords, Meta-Texte	SEO-Content, Blog-Posts
`timeinvoicer-store-manager.skill`	`/timeinvoicer-store-manager`	Play Store ASO, Release Notes, Feature-Grafik	Store-Listing, App-Updates

Internationalisierung

Skill-Datei	Aufruf	Rolle	Wann einsetzen
`timeinvoicer-translator.skill`	`/timeinvoicer-translator`	Übersetzungen DE<->EN/FR/ES, Terminologie-Glossar	“übersetze”, String-Übersetzungen

Spezial-Tools

Skill-Datei	Aufruf	Rolle	Wann einsetzen
`amazon-invoice-downloader.skill`	`/amazon-invoice-downloader`	Amazon-Rechnungen automatisch herunterladen	Eingangsrechnungen-Workflow

Automatisch gestartete Agenten (kein manueller Aufruf)

Diese Agenten werden automatisch nach bestimmten Events gestartet:

Agent	Trigger	Was er tut
Testuser-Agent	Nach jeder UI-Integration	Erstbenutzer-Simulation (Dr. Huber-Perspektive), Verständlichkeit, Tonalität
iOS-Merger-Agent	Nach jeder UI-Integration	Prüft welche Android-Änderungen in iOS (KMP/CMP) portiert werden müssen

Claude Rules (6 Stück — automatisch geladen)

Diese Dateien werden bei jedem Session-Start automatisch geladen:

Datei	Pfad	Inhalt
`dev-workflow.md`	`.claude/rules/`	Build-Befehle, Flavors (prod/demo/parallel), Package-Layout, Commit-Konventionen, VM->Repo->DAO Mappings
`agent-team.md`	`.claude/rules/`	KI-Firma Workflow (Phase A/B/C), 3 Pflicht-Agenten nach UI-Änderung
`ui-features.md`	`.claude/rules/`	Hilfe-Agent 3 Aufgaben, Coach-Marks, Long-Click-Hinweise, UI-Optimizer, Testuser
`ios-migration.md`	`.claude/rules/`	CalendarPort iOS-Team (6 Agenten), KMP/CMP Phasen, HIG-Wächter
`website-marketing.md`	`.claude/rules/`	WordPress (timeinvoicer.at), REST API, Status-Dashboard, Marketing-Agenten
`i18n.md`	`.claude/rules/`	4 Sprachen (DE/EN/FR/ES), Übersetzungs-Regeln, Ressourcen-Übersicht

Referenz-Dokumente (manuell lesen)

Datei	Wann lesen
`CLAUDE.md`	Wird automatisch geladen — Projekt-Überblick, Architektur, Gotchas
`PROJEKTPLAN.md`	Jede Session — Roadmap, Phasen 0-F, KI-Firma
`AGENTS.md`	Bei Unsicherheit über Regeln — Global Rules for AI Operations
`ARCHITECTURE.md`	Bei Architektur-Fragen — ViewModel->Repository->DAO Mappings
`IOS_PROJEKTPLAN.md`	Bei iOS-Arbeit — KMP/CMP Detailplan
`AGENT_HELP.md`	Bei Hilfe/Onboarding — Coach-Mark Status-Tabelle
`docs/ZUKUNFTS_MEETING_PROTOKOLL.md`	Bei Strategie-Entscheidungen — 6 Experten-Gutachten

Workflow bei neuem Feature

PHASE A: IMPLEMENTIERUNG (parallel, 3-5 Agenten)
├── Feature-Code + Domain + Tests
├── ViewModel + Hilt DI
├── UI/Compose Screen
└── Compile → Tests → Fix → Commit

PHASE B: QUALITÄTSSICHERUNG (parallel, 3 Agenten — PFLICHT)
├── /timeinvoicer-kritiker    → Code-Review, Bugs, Edge Cases
├── /timeinvoicer-sicherheit  → DSGVO, Krypto, Daten-Leaks
└── /timeinvoicer-ux          → Usability, Accessibility
    Compile → Tests → Fix → Commit

PHASE C: POLISH (parallel, 2 Agenten — PFLICHT bei UI)
├── /timeinvoicer-help         → Coach-Marks, user_guide, Pref-Keys
└── /timeinvoicer-ui-optimizer → Responsive, Touch-Targets, Farben
    Compile → Tests → Fix → Commit

AUTOMATISCH NACH UI (3 Hintergrund-Agenten):
├── Testuser-Agent             → Erstbenutzer-Simulation
├── UI-Optimizer-Agent         → WCAG AA, Material3
└── iOS-Merger-Agent           → KMP-Portierung prüfen
    Ergebnisse → User präsentieren → Fixes nach Freigabe

iOS-Agenten (CalendarPort Team)

Für iOS-spezifische Arbeit gibt es 6 spezialisierte Rollen:

Agent	Rolle	Trigger
`ios-architect`	CTO: KMP/CMP Setup, Gradle, Module, expect/actual, Koin DI	“KMP Setup”, “iOS Architektur”
`ios-platform`	Platform: EventKit, CNContact, FileManager, UserDefaults, StoreKit 2	“EventKit”, “iOS Platform”
`ios-ui`	UI: CMP Screens, SwiftUI-Bridges, Navigation, Material3 iOS	“iOS UI”, “Compose Multiplatform”
`ios-data`	Data: SQLDelight, Room-Wrapper, Repository-Pattern KMP	“SQLDelight”, “iOS Daten”
`ios-qa`	QA: commonTest, iosTest, XCTest, E2E-Flows	“iOS Tests”, “XCTest”
`ios-devops`	DevOps: Xcode, CocoaPods/SPM, Signing, CI/CD, TestFlight	“Xcode”, “iOS Build”

Details: .claude/rules/ios-migration.md und IOS_PROJEKTPLAN.md