04 – Issueverwaltung: Aus Analysebefunden nachvollziehbare Aufgaben machen
Aus meiner Netzwerkdiagnose entstanden zahlreiche Linear-Issues mit Befunden, Vorgehen, Abschlusskriterien und Abhängigkeiten. Eine eigene Synchronisation verbindet die strukturierte Aufgabenverwaltung mit den technischen Arbeitsständen.
Vom Chat zur Aufgabe
Ich habe technische Beobachtungen in einzelne Aufgaben überführt. Jede Aufgabe beschreibt einen konkreten Befund, ein geplantes Vorgehen und Kriterien für den Abschluss. Erledigte Arbeiten werden ebenso dokumentiert wie offene Hypothesen.
Um effektiv und nachvollziehbar die Themen zu bearbeiten, ein Tracking zu erlauben und den Stand immer aktuell zu halten, habe ich mich für https://linear.app entschieden.

Diese Struktur verhindert, dass ich dieselbe Untersuchung bei einem späteren Import erneut anlege. Abhängigkeiten und Beziehungen wie „blocks“ machen sichtbar, welche Aufgaben voneinander abhängen.
Des weiteren habe ich mir von Codex eine komplette Übersicht meiner Infrastruktur erstellen lassen mit allen Erforderlichen Infos.

Wie die Synchronisation funktioniert
Die Synchronisation vergleicht lokale und entfernte Feldwerte mit einer gemeinsamen Ausgangsbasis. Einseitige Änderungen werden übernommen. Wenn beide Seiten dasselbe Feld unterschiedlich verändern, dokumentiert die Synchronisation den Konflikt, statt eine Seite blind zu überschreiben.
Es wird technisch mit einem Linear API Key gearbeitet.
Die Aufgabe läuft regelmäßig, sofern die Entwicklungsumgebung verfügbar ist. Sie synchronisiert Felder, bearbeitet aber keine technischen Aufgaben selbst. Beziehungen, Anhänge, Kommentare, Labels und Verantwortliche bleiben bewusst getrennte Themen.
Fortschritt und Ergebnisse festhalten
Ein typischer Ablauf beginnt mit einem allgemeinen Symptom, etwa kurzen Verbindungsabbrüchen. Daraus entstehen zeitlich begrenzte Messungen, Zwischenbefunde und schließlich eine gezielte technische Korrektur. Ein kurzer erfolgreicher Test reicht dabei nicht automatisch als vollständiger Abschluss.
Ich dokumentiere deshalb auch Grenzen: fehlende Langzeitbeobachtung, offene Failover-Tests oder noch nicht bewiesene Ursachen. So bleibt erkennbar, was tatsächlich geprüft wurde und welche Hypothesen noch offen sind.
Sicherheit und Zuständigkeiten
Zugangsdaten gehören nicht in Aufgabenbeschreibungen oder technische Dokumentationen. Die Synchronisation arbeitet mit geschützter Ablage und prüft Versionsstände, bevor Änderungen übernommen werden.
Ein Issue beschreibt eine Aufgabe, erteilt aber keine Freigabe für Routeränderungen. Technische Entscheidungen und Aktivierungen bleiben ein eigener Prüfschritt.
Der letzte Schritt des Schließen eines Issues bleibt weiterhin mir überlassen wenn ich es nicht anderweitig an Codex übergebe.
Meine Erkenntnis
Eine gute Aufgabenverwaltung ist kein Selbstzweck. Sie verwandelt unübersichtliche Analysebefunde in nachvollziehbare nächste Schritte. Dadurch kann ich technische Arbeit über mehrere Sitzungen hinweg fortsetzen, ohne den gesamten Kontext jedes Mal neu aufzubauen.
Aus bisheriger mühevoller manueller Kleinarbeit für Dokumentation und insbesondere zum regelmäßigen Updaten des Inventars wurde damit ein sehr einfacher Prozess.
Die Zeitersparnis liegt im Bereich von mehreren Werktagen.
Codex bzw. VS Code nutzen vorhandene Skripte bzw. passen diese an, Dokumentieren Änderungen in Konfiguration und Heimnetz, erstellen und bearbeiten Issues und setzen Lösungen um.
Entweder erfolgt die Implementierung dann manuell oder über einen spezifischen Befehl / Task.
Einen Teil der Skripte habe ich unter https://github.com/palbiez/network_diagnostic_operations_toolkit veröffentlicht.
