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

Transition Implementation → Review

Wenn ein Autor sein Manuskript fertig hat, gibt er es an einen Lektor. Die Transition Implementation→Review ist genau dieser Moment - der Übergang von "Ich habe gebaut" zu "Bitte prüfe, ob es gut ist".

Der Weg zum Review

Diese Transition verbindet die Implementierungsphase mit dem Code Review. Sie stellt sicher, dass nur Code zum Review gelangt, der die automatischen Prüfungen bestanden hat und alle nötigen Informationen für Reviewer enthält.

Vollständiges Beispiel

# Transition: Implementation → Review
# Von Phase 6 (Implementation) zu Phase 7 (Review)

transition:
  id: "TR_IMPL_REVIEW"
  name: "Implementation to Review"
  description: "Übergang von fertiger Implementierung zum Code Review"

  from:
    phase: 6  # Implementation
    state: "implemented"

  to:
    phase: 7  # Review
    state: "in_review"

  # Vorbedingungen (müssen vom Implementation Gate erfüllt sein)
  preconditions:
    - "implementation_gate_passed"
    - "all_tests_green"
    - "no_linting_errors"
    - "documentation_complete"

  # Was wird für den Review bereitgestellt?
  payload:
    required:
      - change_id
      - change_set
      - test_results
      - coverage_report

    generated:
      - diff_summary
      - affected_files_list
      - dependency_changes

    optional:
      - screenshots
      - demo_video
      - manual_test_instructions

  # Aktionen während der Transition
  actions:
    - name: "Create Pull Request"
      type: "create_pr"
      settings:
        title_template: "[{change_class}] {change_title}"
        body_template: "pr_template.md"
        labels:
          - from: "change_class"
          - from: "priority"

    - name: "Auto-Assign Reviewers"
      type: "assign_reviewers"
      rules:
        - type: "code_owners"
          source: "CODEOWNERS"
        - type: "round_robin"
          pool: "senior_devs"
          count: 1

    - name: "Generate Review Checklist"
      type: "create_checklist"
      based_on:
        - change_class
        - affected_components
        - security_relevant

    - name: "Notify Reviewers"
      type: "notification"
      channels:
        - "assigned_reviewers"
        - "team-channel"

  # Validierung nach Transition
  postconditions:
    - "pull_request_created"
    - "reviewers_assigned"
    - "checklist_generated"

Transition in der Praxis

# Transition-Ausführung
transition_execution:
  transition_id: "TR_IMPL_REVIEW"
  change_id: "CHG-2024-0052"
  executed_at: "2024-01-15T15:00:00Z"

  precondition_check:
    - condition: "implementation_gate_passed"
      passed: true
      gate_result: "G4_PASS_2024-01-15T14:55:00Z"

    - condition: "all_tests_green"
      passed: true
      test_summary: "312/312 passed"

  actions_executed:
    - action: "Create Pull Request"
      status: "completed"
      result:
        pr_number: 247
        pr_url: "https://github.com/org/repo/pull/247"
        title: "[normal] Add two-factor authentication"
        labels: ["change:normal", "priority:high", "security"]

    - action: "Auto-Assign Reviewers"
      status: "completed"
      result:
        assigned:
          - reviewer: "alice@example.com"
            reason: "Code owner for src/Auth"
          - reviewer: "bob@example.com"
            reason: "Round robin from senior_devs"

    - action: "Generate Review Checklist"
      status: "completed"
      result:
        checklist_items:
          - "[ ] Security: Auth flow correctly implemented"
          - "[ ] Security: No hardcoded credentials"
          - "[ ] Tests: Edge cases covered"
          - "[ ] Docs: API documentation updated"

    - action: "Notify Reviewers"
      status: "completed"
      result:
        notifications_sent: 2

  result: "SUCCESS"
  new_state: "in_review"
  new_phase: 7

Warum ist das wichtig?

Diese Transition stellt sicher, dass Reviewer alles haben, was sie brauchen. Keine Zeit wird verschwendet mit Fragen wie "Wo sind die Tests?" oder "Was soll das Feature eigentlich tun?". Alles ist dokumentiert und vorbereitet.

Im Mensch + KI-Code Prozess: Die Transition Implementation→Review wird automatisch ausgelöst, wenn das Implementation Gate (G4) bestanden ist. Sie erstellt Pull Requests mit kontextreichen Beschreibungen, die sowohl menschlichen Reviewern als auch KI-Assistenten helfen.