IT Prozess - Projektarbeit
🧠 Zusammenfassung¶
Dieser Prozess beschreibt die strukturierte Umsetzung von IT-Projekten – sowohl für Kunden als auch für interne Produkte.
Die Arbeit erfolgt task-basiert über ein zentrales Kanban-System, in dem Menschen und KI-Agenten gemeinsam arbeiten.
🎯 Ziel¶
- strukturierte und nachvollziehbare Umsetzung von Anforderungen
- klare Aufgabenverteilung zwischen Menschen und Agenten
- kontinuierlicher Fortschritt durch kleine, abgeschlossene Tasks
- transparente Priorisierung und Planung
📦 Kontext¶
Der Prozess wird verwendet für:
- Kundenprojekte
- interne Softwareentwicklung
- Feature-Entwicklung
- Bugfixing und Wartung
Alle Arbeit wird über Tasks im Kanban-Board gesteuert.
Es existieren folgende Arten von Tasks:
- Analyse → ein reiner Analyse Task, hier findet keine Implementierung statt - es können aber andere Arten von Tasks angelegt werden, sollte dies notwendig sein
- Anforderung → eine Anforderung für neue Features in einem Software-Projekt, analog der Analyse Tasks gibt es hier in dem Task keine direkte Umsetzung, vielmehr resultiert dieser Task ins Epics / User Stories
- Epic → ein großes, übergeordnetes Arbeitspaket in Scrum - fasst mehrere User Stories zusammen, es gibt hier auch keine direkte Implementierung, dafür aber in den verknüpften User Stories
- User Story → beschreibt eine kleinere, direkt umsetzbare Anforderung aus Sicht des Nutzers. Hier wird der komplette Prozess inklusive Entwicklung durchlaufen
👥 Beteiligte¶
👨💻 Menschen¶
- entscheiden über Prioritäten
- definieren Anforderungen
- treffen Architekturentscheidungen
- übernehmen kritische Implementierungen
🤖 KI-Agenten¶
- analysieren Anforderungen
- erstellen und strukturieren Tasks
- schlagen Lösungen vor
- unterstützen bei Implementierung und Dokumentation
🔁 Ablauf¶
Schritt 1: Anforderung erfassen¶
Beschreibung: Eine neue Anforderung wird identifiziert (Feature, Bug, Verbesserung). Diese wird durch Rückfragen des Business Analysten so weit refined, dass 1 bis n klar verständliche, abgeschlossene Task Cards am Kanban Board erstellt werden können.
Verantwortlich: Mensch oder Agent
Input:
- Kundenanfrage
- interne Idee
- Fehlerbeschreibung
Output:
- Initiative / Anforderung Task im Kanban-Board
Schritt 2: Offene Fragen klären, Task mit Informationen anreichern, strukturieren und priorisieren¶
Beschreibung: Die Anforderung wird im Ping Pong Prinzip zwischen Mensch und KI um alle fehlenden Informationen angereichert. Ist alles vollständig geklärt, wird der Task in ein oder mehrere klar definierte Epics zerlegt, welche wiederrum in ein oder mehrere User Stories resultieren.
Verantwortlich: Primär Agent, Klärung von Fragen mit Mensch
Input:
- initialer Task
Output:
- strukturierte Tasks, Epics, User Stories mit:
- Beschreibung
- Ziel
- Akzeptanzkriterien
- Sauber dokumentierte Requirements Entscheidungen in der WDB
Ein Task soll immer wie folgt aussehen:
## 🎯 Ziel
Klar messbarer Outcome
## 📦 Kontext
Relevante Hintergrundinfos, Einschränkungen, etc.
## 🧠 Analyse
Eine Analyse des Tasks - wenn noch nicht vorhanden, soll der Agent diese selbst durchführen.
## 🛠 Sub-Tasks
- [ ] Task 1
- [ ] Task 2
- [ ] Task 3
## 📊 Abnahmekriterien
- Woher wissen wir dass es fertig gestellt ist
## 🔁 Logs / Notizen
- Der Agent aktualisiert diese selbständig
Schritt 3: Quality Gate - Review der User Stories und Priorisierung¶
Beschreibung: Ein Mensch reviewed die Ergebnisse und alle Tasks werden nach Wichtigkeit und Dringlichkeit eingeordnet.
Verantwortlich: Mensch
Input:
- alle ausgearbeiteten Tasks, Epics und User Stories
Output:
- priorisierte Task-Reihenfolge im Kanban-Board
- eine Freigabe um zum nächsten Schritt zu gehen oder
- Informationen mit gewünschten Nachbesserungen um zum vorhergehenden Schritt zu gehen
Schritt 4: Technische Analyse¶
Beschreibung: Die User Stories werden durch einen KI Agenten technisch designed und etwaige Architekturentscheidungen werden sauber in der WDB dokumentiert.
Technical Design im Task ergänzen:
- betroffene Komponenten
- betroffene APIs
- Datenmodelländerungen
- relevante Abhängigkeiten
- Architekturentscheidung
- Risiken
- Security-relevante Aspekte
- Teststrategie
- Deployment-Auswirkungen
Verantwortlich: Primär Agent, Klärung von Fragen mit Mensch
Input:
- freigegebene User Stories
Output:
- dokumentierte Architekturentscheidungen
- Zusammenfassung zur technischen Umsetzbarkeit
Schritt 5: Quality Gate - Review der Architekturentscheidungen¶
Beschreibung:
Ein Mensch reviewed die Ergebnisse.
Verantwortlich:
Mensch
Input:
- alle (neuen) Architekturentscheidungen
Output:
Eines der folgenden beiden: * eine Freigabe um zum nächsten Schritt zu gehen * Informationen mit gewünschten Nachbesserungen um zum vorhergehenden Schritt zu gehen
Schritt 6: Implementierung¶
Beschreibung:
Die User Stories werden durch einen KI Agenten umgesetzt und mit automatisierten Tests versehen.
DoD
□ Acceptance Criteria implementiert □ automatisierte Tests vorhanden □ relevante bestehende Tests weiterhin grün □ Linter/Formatter erfolgreich □ Build erfolgreich □ keine unbeabsichtigten Änderungen □ Commit vorhanden □ Feature Branch gepusht □ technische Dokumentation aktualisiert, falls erforderlich
Verantwortlich:
Primär Agent, Klärung von Fragen mit Mensch
Input:
- freigegebene User Stories
- Architekturentscheidungen
Output:
- Umgesetzer, getesteter Code
- GIT Check-In in Feature Branch
Schritt 7: Quality Gate - Test & Review der Implementierung¶
Beschreibung:
Ein Mensch tested die Ergebnisse und reviewed den neu entstandenen Code.
Verantwortlich:
Mensch
Input:
- implementierte User Stories
Output:
- Schliessen der korrekt umgesetzten User Stories (und Epics)
- Mergen des Feature Branches nach Develop
- Wenn alles korrekt ist, schliessen des ursprünglichen Tasks
- Optional: Informationen mit gewünschten Nachbesserungen um zum vorhergehenden Schritt zu gehen
- Releaseplanung durch einen Menschen
- Optional: Starten des Release Prozesses durch einen Menschen
🔄 Entscheidungslogik¶
IF Task unklar
→ zurück zu "Task strukturieren"
IF Umsetzung fehlerhaft
→ zurück zu "Umsetzung"
IF neue Erkenntnisse entstehen
→ wenn notwendig Rückfragen mit Mensch klären, Dokumentation in WDB
IF zusätzliche Arbeite wurde identifiziert
→ neue Tasks erstellen
IF Änderung betrifft Production Infrastructure
→ Menschliche Implementierung notwendig
IF Security Classification >= 3
→ Freigabe durch Menschen notwendig
📊 Erfolgskriterien¶
- Tasks sind klar definiert und verständlich
- kontinuierlicher Fortschritt im Kanban-Board sichtbar
- geringe Anzahl an blockierten Tasks
- Anforderungen werden vollständig umgesetzt
⚠️ Fehlerfälle / Risiken¶
- unklare Anforderungen → führen zu falscher Umsetzung
- fehlende Priorisierung → ineffiziente Arbeit
- zu große Tasks → Fortschritt schwer messbar
- fehlendes Review → Qualitätsprobleme
🔗 Abhängigkeiten¶
- Übersicht: Business Prozesse - IT
- Kanban-System (zentrales Arbeitstool)
🔁 Folgeprozesse¶
- Deployment / Release
- Monitoring / Betrieb
- Support / Bugfixing
🤖 Hinweise für Agenten¶
- Tasks dürfen selbstständig erstellt werden, wenn neue Arbeit erkannt wird - Diese müssen im Prozessschritt "Refinement" landen.
- Tasks müssen immer klar strukturiert sein (Beschreibung, Ziel, Ergebnis)
- Bei Unsicherheit muss ein Mensch eingebunden werden
- Keine direkten Änderungen an produktiven Systemen ohne Freigabe
- Kontext aus bestehenden Tasks und Dokumentation berücksichtigen
- Jeder Prozessschritt muss idempotent oder wiederaufnehmbar sein
- Agenten dürfen keine menschliche Entscheidung simulieren, sobald ein Task in einem Zustand ist, den ein Mensch weiterschalten muss, darf kein Agent an dem Task etwas verändern
Zukünftiger Prozess¶
Der endgültige Prozess soll wie folgt aussehen. In () stehen die Verantwortlichen und Aktoren des jeweiligen Prozessschrittes.
┌──────────────┐
│ INTAKE │
│ (Human / AI) │
└──────┬───────┘
│
▼
┌──────────────┐
│ REFINEMENT │◄─────┐
│ (AI ↔ Human) │ │
└──────┬───────┘ │
│ │ improvements
▼ │ neccessary
┌──────────────┐ │
│ HUMAN REVIEW │──────┘
│ (Human) │
└──────┬───────┘
│ approved
▼
┌────────────────────┐
│ TECHNICAL DESIGN │◄────┐
│ (AI) │ │
└─────────┬──────────┘ │
│ │
▼ │ improvements
┌──────────────────┐ │ neccessary
│ ARCHITECTURE │ │
│ REVIEW │──────┘
│ (Human) │
└────────┬─────────┘
│ approved
▼
┌───────────┐
│ SECURITY │
│ DESIGN │
│ (AI) │
└─────┬─────┘
│
▼
┌───────────┐
│ DEV │◄─────────┐
│ (AI) │ │
└─────┬─────┘ │
│ │
▼ │
┌─────────────────────┐ │ fails
│ Automated Quality │ │
│ Tests / Security / │──────┤
│ Code Review │ │
│ Dependency Checks │ │
│ (AI) │ │
└──────────┬──────────┘ │
│ pass │
▼ │ improvements
┌───────────┐ │ neccessary
│ HUMAN │ │
│ REVIEW │───────────┘
│ (Human) │
└─────┬─────┘
│ approved
▼
┌───────────┐
│ DONE │
└───────────┘
Optional wird durch einen Menschen der separate Release Prozess gestartet.
🔗 Verwandte Themen¶
⚠ Hinweise / Notizen¶
- Alle Arbeit MUSS über Tasks im Kanban-System erfolgen
- Direkte Umsetzung ohne Task ist zu vermeiden
- Kleine, abgeschlossene Tasks sind zu bevorzugen