Items bearbeiten¶

Vollständige Anleitung für die Arbeit mit Backlog-Items in CC-Sprint.

Item-Typen¶

CC-Sprint unterstützt vier Item-Typen, die verschiedene Aspekte der Entwicklung abdecken:

Feature (F)¶

Zweck: Neue Funktionalität, User-Stories, nutzerorientierte Anforderungen

Beispiele:

"User kann sich einloggen"
"Dark Mode Support"
"Backlog.md Export als JSON"

Typische Felder:

Beschreibung (User-Story Format)
Akzeptanzkriterien (Checkboxen)
Technische Hinweise

Technical Task (T)¶

Zweck: Technische Aufgaben ohne direkten User-Wert

Beispiele:

"SQLite-Integration einrichten"
"Logging-System implementieren"
"CI/CD Pipeline konfigurieren"

Typische Felder:

Setup-Details
Konfiguration
Implementation-Notes

Bug (B)¶

Zweck: Fehlerbehebung, bekannte Probleme

Beispiele:

"App crashed bei großer Backlog.md"
"FileWatcher erkennt Änderungen nicht"
"Filter-Reset funktioniert nicht"

Typische Felder:

Symptom (Was ist kaputt?)
Ursache (Warum kaputt?)
Reproduktion (Wie reproduzieren?)
Lösung (Wie gefixt?)

Chore (C)¶

Zweck: Wartung, Dokumentation, Refactoring

Beispiele:

"Dependencies aktualisieren"
"README schreiben"
"Parser refactoren"

Typische Felder: Variabel, je nach Chore-Typ

Item erstellen¶

Schnellerstellung¶

Klicken Sie "+ Neues Item" in der Toolbar
Oder: "+ Feature", "+ Task", "+ Bug", "+ Chore" (Typ direkt wählen)
Füllen Sie die Pflichtfelder:
Titel (Pflicht)
Status (Default: Offen)
Priorität (Default: Mittel)
Klicken Sie "Erstellen"

Das Item erhält automatisch die nächste ID (z.B. F-0032, T-0015).

Erweiterte Erstellung¶

Im Erstellungs-Dialog können Sie alle Felder ausfüllen:

Feld	Beschreibung	Pflicht
Titel	Kurze Beschreibung	Ja
Typ	F, T, B, C	Ja (bei Schnellerstellung)
Status	Offen, In Arbeit, Blockiert, Erledigt	Ja
Priorität	Hoch, Mittel, Niedrig	Ja
Phase	Idee, Analyse, Umsetzung, Test, Done	Nein
Bereich	funktional, technisch, design, sonstiges	Nein
Beschreibung	Detaillierte Beschreibung (Markdown)	Nein
Akzeptanzkriterien	Checkliste für Abnahme	Nein
Technische Hinweise	Implementation Details (Markdown)	Nein

Item bearbeiten¶

Item auswählen¶

Klicken Sie auf ein Item in der Liste, um das Detail-Panel zu öffnen.

Felder bearbeiten¶

Im Detail-Panel können Sie alle Felder bearbeiten:

Dropdown-Felder:

Status, Priorität, Phase, Bereich – Auswahl aus vordefinierten Werten

Text-Felder:

Titel – Einzeilig
Beschreibung – Mehrzeilig, Markdown unterstützt
Technische Hinweise – Mehrzeilig, Markdown unterstützt

Checkbox-Listen:

Akzeptanzkriterien – Einzelne Kriterien können abgehakt werden

Auto-Save¶

Änderungen werden automatisch gespeichert:

Bearbeiten Sie ein Feld
Fokus verlassen oder kurze Pause
Nach 2 Sekunden (konfigurierbar) wird gespeichert
Backlog.md wird aktualisiert

Tipp

Sie können Auto-Save in den Settings deaktivieren und manuell mit dem Speichern-Button speichern.

Status-Management¶

Status-Werte¶

Status	Bedeutung	Farbe
Offen	Noch nicht begonnen	Grau
In Arbeit	Aktive Entwicklung	Blau
Blockiert	Wartet auf etwas	Rot
Erledigt	Abgeschlossen	Grün

Phase-Werte¶

Phase	Beschreibung	Typischer Status
Idee	Konzept-Phase	Offen
Analyse	Requirements klären	Offen, In Arbeit
Umsetzung	Aktive Entwicklung	In Arbeit
Test	Testing-Phase	In Arbeit
Done	Deployed, fertig	Erledigt

Workflow-Beispiel¶

1. Item erstellt
   Status: Offen, Phase: Idee

2. Analyse beginnt
   Status: In Arbeit, Phase: Analyse

3. Implementation startet
   Status: In Arbeit, Phase: Umsetzung

4. Testing
   Status: In Arbeit, Phase: Test

5. Abgeschlossen
   Status: Erledigt, Phase: Done

Konsistenz

Halten Sie Status und Phase synchron. Die Konsistenzprüfung warnt, wenn:

Status = Erledigt, aber Phase ≠ Done
Phase = Done, aber Status ≠ Erledigt

Akzeptanzkriterien¶

Format¶

Akzeptanzkriterien sind Checkboxen im Markdown-Format:

- [ ] Unchecked criterion
- [x] Checked criterion

Bearbeiten¶

Öffnen Sie das Item-Detail
Bearbeiten Sie das Akzeptanzkriterien-Feld
Fügen Sie Kriterien als - [ ] Text hinzu
Klicken Sie auf Checkboxen zum Abhaken

In der Liste¶

Items mit Akzeptanzkriterien zeigen den Fortschritt:

F-0032: Auto-Save System  [4/5 Kriterien]

Dependencies (Abhängigkeiten)¶

Konzept¶

Ein Item kann von anderen Items abhängen:

F-0010 depends on T-0005: F-0010 kann erst starten, wenn T-0005 erledigt ist
Blockierende Abhängigkeit: Wenn T-0005 nicht erledigt, ist F-0010 blockiert

Hinzufügen¶

Im Item-Detail gibt es ein Abhängigkeiten-Feld:

Öffnen Sie das Item
Finden Sie das Feld Abhängigkeiten
Fügen Sie Item-IDs hinzu (z.B. T-0005, F-0008)
Optional: Notizen in Klammern (z.B. T-0005 (SQLite muss erst fertig sein))

Format in Backlog.md¶

- **Abhängigkeiten**: T-0005 (SQLite-Integration), F-0008

Zyklus-Erkennung¶

CC-Sprint erkennt zyklische Abhängigkeiten:

A → B → C → A  (Zyklus!)

Verhalten:

Warnung wird angezeigt
Nicht blockierend (für temporäre Situationen erlaubt)
Sollte aufgelöst werden

Suche & Filter¶

Schnellsuche¶

Tippen Sie in das Suchfeld oben:

Sucht in:

Item-ID (z.B. "F-0001")
Titel
Beschreibung

Multi-ID Suche:

Geben Sie mehrere IDs kommasepariert ein:

F-0001, T-0005, B-0010

Zeigt nur diese spezifischen Items.

Filter-Dropdowns¶

Kombinieren Sie Filter für präzise Ergebnisse:

Filter	Optionen	Multi-Select
Status	Offen, In Arbeit, Blockiert, Erledigt	Ja
Priorität	Hoch, Mittel, Niedrig	Ja
Phase	Idee, Analyse, Umsetzung, Test, Done	Ja
Typ	Feature, Task, Bug, Chore	Ja

Verknüpfung: Alle Filter sind UND-verknüpft.

Beispiel:

Typ: Feature
Status: Offen, In Arbeit
Priorität: Hoch
→ Zeigt nur offene/laufende High-Prio-Features

Filter zurücksetzen¶

Klicken Sie "Filter zurücksetzen" oder löschen Sie alle Dropdown-Auswahlen.

Sortierung¶

Standard-Sortierung¶

Items sind sortiert nach:

Typ (F, T, B, C)
ID (numerisch aufsteigend)

Spalten-Sortierung¶

Klicken Sie auf einen Spalten-Header, um nach dieser Spalte zu sortieren:

ID: Numerisch
Titel: Alphabetisch
Status: Offen → In Arbeit → Blockiert → Erledigt
Priorität: Hoch → Mittel → Niedrig

Item löschen¶

Einzelnes Item¶

Öffnen Sie das Item-Detail
Klicken Sie "Löschen" (oder Papierkorb-Icon)
Bestätigen Sie die Aktion

Achtung

Gelöschte Items werden aus der Backlog.md entfernt. Ein Backup wird automatisch erstellt.

Abhängigkeiten bei Löschung¶

Wenn das Item von anderen referenziert wird:

Warnung wird angezeigt
Referenzen in anderen Items werden nicht automatisch entfernt
Empfehlung: Erst Referenzen entfernen, dann löschen

Validierungsregeln¶

CC-Sprint validiert Item-Felder:

Gültige Werte¶

Feld	Gültige Werte
Status	Offen, In Arbeit, Blockiert, Erledigt
Priorität	Hoch, Mittel, Niedrig
Phase	Idee, Analyse, Umsetzung, Test, Done, -
Bereich	funktional, technisch, design, sonstiges, -
Typ	F, T, B, C
ID-Format	`[TYPE-XXXX]` z.B. F-0001, T-0042

Logik-Regeln¶

Regel	Severity
Status=Erledigt sollte Phase=Done haben	Warning
Phase=Done sollte Status=Erledigt haben	Warning

Konsistenzprüfung¶

Das Dashboard zeigt den Validierungsstatus:

Grün: Alle Items valide
Gelb: Warnungen vorhanden
Rot: Fehler vorhanden

Klicken Sie für Details zu den gefundenen Issues.

Markdown in Beschreibungen¶

Beschreibung und Technische Hinweise unterstützen GitHub-Flavored Markdown:

Unterstützte Formatierung¶

# Überschrift
**Fett** und *kursiv*
- Listen
- Mit Punkten

1. Nummerierte
2. Listen

`Inline-Code`

```javascript
// Code-Block
function foo() {}
```

[Link](https://example.com)

Anzeige¶

In der App wird Markdown als formatierter Text angezeigt
In Backlog.md bleibt es als Rohtext

CLI für Items¶

Die ccs CLI unterstützt Item-Operationen:

# Backlog validieren (prüft alle Items)
ccs backlog validate --project .

# Neues Item via CLI einfügen
cat > /tmp/new_item.md << 'EOF'
### [F-0051] Neues Feature
- **Status**: Offen
- **Priorität**: Mittel
- **Phase**: Idee
- **Bereich**: funktional
- **Beschreibung**:
  Beschreibung des Features...
EOF

ccs backlog edit --project . --file /tmp/new_item.md --insert-before "## Technical Tasks"

Siehe CLI Referenz für alle Befehle.

Geplante Features¶

Roadmap

Folgende Item-Features sind geplant:

Feature	Beschreibung	Status
Graph-Visualisierung	Dependencies als interaktiver Graph	In Entwicklung
Drag & Drop	Items per Drag sortieren	Geplant
Bulk-Edit	Mehrere Items gleichzeitig bearbeiten	Geplant
Inline-Editing	Felder direkt in der Tabelle bearbeiten	Geplant
Tags	Freie Tags für Items	Geplant
Undo/Redo	Änderungen rückgängig machen	Geplant

Best Practices¶

1. Aussagekräftige Titel¶

❌ "Fix Bug"
✅ "Fix FileWatcher detecting wrong changes on Windows"

2. Akzeptanzkriterien definieren¶

- [ ] User kann Feature X nutzen
- [ ] Dokumentation aktualisiert
- [ ] Tests geschrieben und grün

3. Status aktuell halten¶

Wenn Sie an einem Item arbeiten:

Status auf "In Arbeit" setzen
Nach Fertigstellung auf "Erledigt" + Phase "Done"

4. Abhängigkeiten dokumentieren¶

- **Abhängigkeiten**: T-0005 (DB muss erst implementiert sein)

5. Technische Hinweise für Entwickler¶

- **Technische Hinweise**:
  - Backend: `src-tauri/src/commands/item.rs`
  - Frontend: `app/src/components/ItemDetail.tsx`
  - Test: `tests/item_crud.test.ts`

Siehe auch¶

Erste Schritte – Grundlagen
Projekte – Projekt-Management
Claude Code Regeln – Für KI-Agenten
Backlog-Format – Technische Details

Letzte Aktualisierung: 2026-02-04