cleankoda logo

Issue-Tracking-System (ITS)

cleankoda integriert sich direkt in Ihre bestehenden Projektmanagement- und Ticket-Systeme (z. B. Trello, Jira oder GitHub Issues). Der Coding-Agent kann Anforderungen, Akzeptanzkriterien und Kontextinformationen direkt aus Ihren Tickets laden, um den Implementierungsprozess nahtlos daran auszurichten.

Konfiguration (config.json)

Die Konfiguration des Issue-Trackers erfolgt derzeit über die zentrale Konfigurationsdatei (eine interaktive Einrichtung direkt in der TUI über Slash-Befehle ist in Vorbereitung):

~/.config/cleankoda/config.json

Tragen Sie dort die Verbindungsparameter sowie das Status-Mapping für Ihr System ein. Hier ein Beispiel:

{
  "its_type": "Trello",
  "its_base_url": "https://api.trello.com/1",
  "its_container_id": "1234567890",
  "its_parent_id": "",
  "its_state_backlog": "Backlog",
  "its_state_todo": "Sprint Backlog",
  "its_state_in_progress": "In Progress",
  "its_state_in_review": "In Review",
  "its_state_done": "Done"
}

Parameter im Überblick:

  • its_type: Das verwendete System (z. B. Trello, Jira, GitHub).

  • its_base_url: Der API-Endpunkt des Anbieters.

  • its_container_id: Die ID des Boards, Projekts oder Repositories, in dem sich Ihre Tickets befinden.

  • its_parent_id: Optionale übergeordnete ID (z. B. für Epics oder Sub-Tasks).

  • its_state_*: Das Mapping zwischen den internen Workflow-Zuständen von cleankoda und den tatsächlichen Spalten- oder Statusbezeichnungen in Ihrem Ticket-System:

    • its_state_backlog → Status für BACKLOG

    • its_state_todo → Status für TODO

    • its_state_in_progress → Status für IN_PROGRESS

    • its_state_in_review → Status für IN_REVIEW

    • its_state_done → Status für DONE

Ticket-Verwaltung im Terminal (/issue)

Sobald das Issue-Tracking konfiguriert ist, steuern Sie Tickets bequem über die /issue-Befehle in der TUI:

Issue auswählen und Kontext laden

Verbinden Sie ein konkretes Ticket mit Ihrer aktuellen Arbeitssitzung:

  • Per ID oder URL:
/issue <id_oder_url>
/issue

(Öffnet einen Dialog zur Auswahl aus den verfügbaren Tickets des konfigurierten Boards).

Hinweis: Beim Laden übernimmt cleankoda die Ticket-Beschreibung (z. B. User Story, Problembeschreibung, Akzeptanzkriterien) automatisch in den Arbeitskontext des Agenten.

Weitere Issue-Befehle

  • Inhalt anzeigen:
/issue show

Zeigt die Details und den Inhalt des aktuell im Kontext aktiven Tickets übersichtlich an.

  • Ticket aktualisieren:
/issue sync

Lädt die neuesten Änderungen des Tickets vom Server nach (z. B. wenn im Board Kriterien ergänzt oder Kommentare hinzugefügt wurden) und aktualisiert den Kontext des Agenten.

  • Issue zurücksetzen:
/issue clear

Entfernt das aktuell verknüpfte Ticket wieder aus dem Arbeitskontext des Agenten.