Zum Inhalt

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


🔁 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