Abhängigkeiten zwischen Items

Wenn mehrere Agenten parallel arbeiten, geraten sie aneinander, sofern du nicht festlegst, was was blockiert. Abhängigkeiten machen dies explizit, damit Agenten die Ausführungsreihenfolge automatisch respektieren. Ohne klare Abhängigkeiten entstehen Merge-Konflikte, doppelte Arbeit und Agenten implementieren Features auf Code, der noch nicht existiert.

Abhängigkeiten ermöglichen es, Blockierungsbeziehungen zwischen Work Items festzulegen. Wenn ein Item von einem anderen abhängt, macht Almirant diese Beziehung sichtbar, sodass sowohl das Team als auch die KI fundierte Entscheidungen über die Ausführungsreihenfolge treffen können.

Abhängigkeitstypen

Almirant verwendet ein bidirektionales Abhängigkeitsmodell, das auf blocker/blocked-Beziehungen basiert:

Beziehung	Bedeutung	Beispiel
blocks	Item A blockiert Item B	"Benutzer-API implementieren" blockiert "Profilseite erstellen"
blocked by	Item B wird durch Item A blockiert	"Profilseite erstellen" wird blockiert von "Benutzer-API implementieren"

Beide Beziehungen sind zwei Seiten derselben Abhängigkeit. Wenn du eine Abhängigkeit von einem der beiden Items aus erstellst, wird die umgekehrte Beziehung automatisch eingerichtet.

Abhängigkeit erstellen

Über die Oberfläche

1. Öffne die Detailansicht eines Work Items.
2. Gehe zum Abschnitt Abhängigkeiten.
3. Wähle Abhängigkeit hinzufügen.
4. Suche das verknüpfte Work Item nach Titel oder taskId (e.g., A-T-15).
5. Wähle den Beziehungstyp: "Dieses Item blockiert ..." oder "Dieses Item wird blockiert von ...".
6. Bestätige.

Die Abhängigkeit erscheint in der Detailansicht beider beteiligten Items.

Über MCP

Verwende das Tool add_work_item_dependency und gib die IDs beider Items sowie den Beziehungstyp an.

Abhängigkeiten anzeigen

Die Abhängigkeiten eines Work Items werden angezeigt in:

• Detailansicht -- Eigener Abschnitt, der blockierende und blockierte Items zeigt.
• Board-Karte -- Visueller Indikator, wenn ein Item aktive Abhängigkeiten hat.

Jede Abhängigkeit zeigt:

• Die taskId und den Titel des verknüpften Items.
• Den Beziehungstyp (blocks / blocked by).
• Den aktuellen Status des verknüpften Items (abgeleitet aus seiner Spalte).

Stapelabfrage

Wenn du die Abhängigkeiten mehrerer Items gleichzeitig prüfen musst, etwa bei der Sprintplanung, kannst du die Stapelabfrage verwenden, um alle Beziehungen eines Satzes von Work Items in einer einzigen Operation abzurufen.

Auswirkungen auf den Workflow

Abhängigkeiten liefern wichtige Informationen für das Arbeitsmanagement:

• Sichtbarkeit von Blockaden -- Identifiziere schnell Items, die nicht weiterkommen, weil sie von anderen, noch nicht abgeschlossenen Items abhängen.
• Fundierte Priorisierung -- Items, die andere blockieren, sollten priorisiert werden, um ausstehende Arbeit freizugeben.
• Kontext für die KI -- Wenn die KI den Kontext eines Items abfragt, helfen ihr Abhängigkeiten festzustellen, ob es sinnvoll ist, damit zu beginnen, oder ob sie sich zuerst auf die blockierenden Items konzentrieren sollte.

Gute Praxis

Ein blockiertes Item sollte nicht nach "In Progress" verschoben werden, solange seine blockierenden Items nicht abgeschlossen sind. Almirant verhindert die Verschiebung zwar nicht, aber Abhängigkeiten dienen als visueller und kontextueller Hinweis, um verfrühte Arbeit zu vermeiden.

Abhängigkeit löschen

1. Öffne die Detailansicht des Work Items.
2. Suche im Abschnitt Abhängigkeiten die zu löschende Beziehung.
3. Klicke neben der Abhängigkeit auf die Schaltfläche zum Löschen.
4. Bestätige das Löschen.

Die Beziehung wird gleichzeitig von beiden Items entfernt.

Für Entwickler

Für Entwickler

MCP-Tools

Tool	Beschreibung	Wichtigste Parameter
get_work_item_dependencies	Ruft die Abhängigkeiten eines Work Items ab	workItemId
add_work_item_dependency	Erstellt eine Abhängigkeit zwischen zwei Items	workItemId, dependsOnWorkItemId, type
remove_work_item_dependency	Löscht eine Abhängigkeit	workItemId, dependsOnWorkItemId
get_dependencies_batch	Ruft Abhängigkeiten mehrerer Items gleichzeitig ab	workItemIds

Beispiel: Abhängigkeit hinzufügen

Tool: add_work_item_dependency
Parameter:
  workItemId: "uuid-item-bloqueado"
  dependsOnWorkItemId: "uuid-item-bloqueante"
  type: "blocked_by"

Damit wird festgelegt, dass das erste Item durch das zweite blockiert wird. Die umgekehrte Beziehung (das zweite blockiert das erste) wird automatisch erstellt.

Beispiel: Abhängigkeiten stapelweise abfragen

Tool: get_dependencies_batch
Parameter:
  workItemIds: ["uuid-1", "uuid-2", "uuid-3", "uuid-4"]

Gibt eine Zuordnung mit den Abhängigkeiten jedes Items zurück, hilfreich zur Darstellung des Blockierungsgraphen eines vollständigen Sprints.

Beispiel: Abhängigkeiten eines Items anzeigen

Tool: get_work_item_dependencies
Parameter:
  workItemId: "uuid-del-item"

Gibt zwei Listen zurück:

• blocks: Items, die dieses Item blockiert.
• blockedBy: Items, die dieses Item blockieren.