karlsCORE KI-Gemeinschaft KI-Wissen Systemisch Denken Erstgespräch Anmelden

Artifact Request

Jede Reise beginnt mit dem ersten Schritt - und jede Änderung beginnt mit einem Request. Das Request-Artefakt ist der dokumentierte Startpunkt: Was soll passieren? Warum? Für wen?

Was ist ein Artefakt?

Ein Artefakt ist ein strukturiertes Dokument, das während des Prozesses erstellt wird. Es dient als Nachweis, als Übergabe-Medium und als Referenz. Das Request-Artefakt entsteht in Phase 1 (Intake) und begleitet die Änderung durch den gesamten Prozess.

Vollständiges Beispiel

# Artifact: Request
# Erstellt in: Phase 1 (Human Request Intake)

artifact:
  type: "request"
  version: "1.0"

  # Identifikation
  metadata:
    id: "REQ-2024-0057"
    created_at: "2024-01-15T08:30:00Z"
    created_by: "alice@example.com"
    status: "submitted"

  # Der eigentliche Request
  request:
    title: "Benutzer sollen sich mit Google anmelden können"
    description: |
      Als Benutzer möchte ich mich mit meinem Google-Konto anmelden können,
      damit ich kein separates Passwort verwalten muss.

    # Strukturierte Anforderung
    user_story:
      as_a: "Benutzer"
      i_want: "mich mit Google anmelden"
      so_that: "ich kein separates Passwort brauche"

    # Kontext
    context:
      business_value: "Reduziert Registrierungs-Abbrüche um ~30%"
      urgency: "Q1 Release geplant"
      related_requests:
        - "REQ-2024-0023"  # Apple Sign-In
        - "REQ-2024-0031"  # Social Login Framework

  # Anfragesteller-Informationen
  requester:
    name: "Alice Schmidt"
    role: "Product Owner"
    team: "team-identity"
    contact: "alice@example.com"

  # Initiale Einschätzung (wird in Triage verfeinert)
  initial_assessment:
    priority: "high"
    estimated_complexity: "medium"
    suggested_change_class: "normal"
    affected_areas:
      - "authentication"
      - "user_service"
      - "frontend_login"

  # Anhänge
  attachments:
    - type: "mockup"
      file: "google-login-mockup.pdf"
      description: "UI-Entwurf für Google-Button"
    - type: "reference"
      url: "https://developers.google.com/identity"
      description: "Google Identity Dokumentation"

  # Akzeptanzkriterien (initial)
  acceptance_criteria:
    - "Google-Login-Button auf Login-Seite sichtbar"
    - "OAuth2-Flow funktioniert"
    - "Neuer User wird bei erstem Login angelegt"
    - "Bestehender User wird erkannt und verknüpft"
    - "Fehlerbehandlung bei Google-Ablehnung"

  # Constraints
  constraints:
    - "Muss DSGVO-konform sein"
    - "Keine zusätzlichen Tracking-Cookies"
    - "Fallback auf Email-Login muss bleiben"

Request-Lifecycle

# Request-Status-Verlauf
request_lifecycle:
  request_id: "REQ-2024-0057"

  status_history:
    - status: "draft"
      at: "2024-01-15T08:00:00Z"
      by: "alice@example.com"
      action: "Request erstellt"

    - status: "submitted"
      at: "2024-01-15T08:30:00Z"
      by: "alice@example.com"
      action: "Zur Prüfung eingereicht"

    - status: "triaged"
      at: "2024-01-15T09:15:00Z"
      by: "triage-bot"
      action: "Klassifiziert als 'normal'"
      details:
        change_class: "normal"
        priority: "high"
        assigned_to: "team-identity"

    - status: "in_analysis"
      at: "2024-01-15T10:00:00Z"
      by: "bob@example.com"
      action: "Analyse gestartet"
      linked_artifact: "ANA-2024-0057"

    - status: "approved"
      at: "2024-01-15T14:00:00Z"
      by: "gate-G2"
      action: "Analysis Gate bestanden"
      evidence: "G2_PASS_2024-0057"

    - status: "in_progress"
      at: "2024-01-15T14:30:00Z"
      action: "Implementierung gestartet"
      linked_artifact: "CHG-2024-0057"

    - status: "completed"
      at: "2024-01-17T16:00:00Z"
      action: "Deployed to production"
      release_version: "2.5.0"

  total_duration: "2 days, 7.5 hours"

Warum ist das wichtig?

Das Request-Artefakt ist der Single Source of Truth für die ursprüngliche Anforderung. Es verhindert Missverständnisse ("Das habe ich nicht gemeint!") und ermöglicht Nachvollziehbarkeit ("Warum haben wir das so gebaut?").

Im Mensch + KI-Code Prozess: Jede Änderung beginnt mit einem Request-Artefakt. Es wird in Phase 1 erstellt, in Phase 2 angereichert und begleitet die Änderung bis zum Abschluss. Alle späteren Artefakte referenzieren zurück auf den Request.