Erste Schritte¶

Willkommen bei CC-Sprint! Diese Anleitung hilft Ihnen beim Einstieg.

Was ist CC-Sprint?¶

CC-Sprint ist die Context-Bridge zwischen Mensch und Claude Code.

Es orchestriert Pair Programming mit einem Requirements-First-Ansatz – iterativ, in Sprints, von der Idee zur nutzerorientierten App.

Kern-Features:

Backlog.md als Single Source of Truth verwalten
Items erstellen, bearbeiten, filtern
Automatische Synchronisation zwischen App und Datei
Git-Integration für Versionskontrolle
Backup-System für Datensicherheit

Installation¶

Entwicklungs-Setup (Aktuell)¶

CC-Sprint befindet sich in aktiver Entwicklung. Installation erfolgt aus dem Quellcode:

# Repository klonen
git clone https://gitlab.SERVER/USER-NAME/claudecode_requirements_app.git
cd CC-Sprint

# Frontend Dependencies
cd app && npm install
cd ..

# Rust Backend
cd src-tauri && cargo build --release
cd ..

# Entwicklungsserver starten
npm run tauri dev

Voraussetzungen:

Node.js 18+
Rust 1.70+
npm oder yarn

Binaries (Geplant)¶

Pre-built Binaries für Windows, macOS und Linux werden in zukünftigen Releases verfügbar sein.

Erstes Projekt erstellen¶

Option 1: Neues Projekt¶

Starten Sie CC-Sprint
Klicken Sie "Neues Projekt erstellen"
Wählen Sie einen Projekt-Ordner
Geben Sie einen Projekt-Namen ein
Klicken Sie "Erstellen"

CC-Sprint erstellt automatisch:

docs/Backlog.md – Das Backlog (Source of Truth)
.backlog-admin/backlog.db – SQLite-Datenbank (Cache)
.backlog-admin/backups/ – Backup-Ordner

Option 2: Existierendes Projekt öffnen¶

Klicken Sie "Projekt öffnen"
Navigieren Sie zum Projekt-Ordner
Wählen Sie den Ordner mit einer existierenden docs/Backlog.md
Klicken Sie "Öffnen"

CC-Sprint parst die Backlog.md und importiert alle Items in die lokale Datenbank.

UI-Übersicht¶

Hauptfenster¶

┌─────────────────────────────────────────────────────────┐
│ CC-Sprint                              [Theme] [⚙️]    │
├─────────────────────────────────────────────────────────┤
│ [Dashboard] [Backlog] [Settings]                        │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Filter-Leiste:                                         │
│  [Suche...] [Status ▼] [Priorität ▼] [Phase ▼] [Typ ▼] │
│                                                         │
│  ┌─────────────────────────────────────────────────┐   │
│  │ Item-Liste                                       │   │
│  │ F-0001  Feature-Name           Offen    Hoch    │   │
│  │ T-0002  Technical Task         In Arbeit Mittel │   │
│  │ B-0003  Bug-Fix                Blockiert Hoch   │   │
│  └─────────────────────────────────────────────────┘   │
│                                                         │
│  [+ Neues Item]                                         │
└─────────────────────────────────────────────────────────┘

Tab	Beschreibung
Dashboard	Übersicht mit Statistiken und Konsistenzprüfung
Backlog	Item-Liste mit Filter und Suche
Settings	Projekt- und App-Einstellungen

Theme¶

Klicken Sie auf das Theme-Icon (Sonne/Mond) für Light/Dark Mode.

Erstes Item erstellen¶

Klicken Sie "+ Neues Item" oder "+ Feature/Task/Bug/Chore"
Wählen Sie den Typ:
Feature (F): Neue Funktionalität
Technical Task (T): Technische Aufgabe
Bug (B): Fehlerbehebung
Chore (C): Wartung, Dokumentation
Füllen Sie die Pflichtfelder:
Titel (Pflicht)
Status (Standard: Offen)
Priorität (Standard: Mittel)
Optional: Beschreibung, Phase, Bereich
Klicken Sie "Erstellen"

Das Item erhält automatisch die nächste ID (z.B. F-0001).

Item bearbeiten¶

Klicken Sie auf ein Item in der Liste
Das Item-Detail-Panel öffnet sich
Bearbeiten Sie die Felder:
Titel, Status, Priorität, Phase, Bereich
Beschreibung (Markdown unterstützt)
Akzeptanzkriterien
Technische Hinweise
Änderungen werden automatisch gespeichert (Auto-Save)

Filter verwenden¶

Schnellsuche¶

Tippen Sie in das Suchfeld, um Items zu finden:

Suche nach Titel
Suche nach ID (z.B. "F-0001")
Multi-ID Suche: Mehrere IDs kommasepariert (z.B. "F-0001, T-0005, B-0010")

Filter-Dropdowns¶

Kombinieren Sie Filter für präzise Ergebnisse:

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

Backlog.md Synchronisation¶

App → Datei (Auto-Save)¶

Änderungen in der App werden automatisch nach docs/Backlog.md geschrieben
Standard-Debounce: 2 Sekunden
Konfigurierbar in Settings

Datei → App (File Watcher)¶

Externe Änderungen (z.B. durch Claude Code) werden automatisch erkannt
App lädt Änderungen nach 500ms
Hash-Vergleich verhindert unnötige Reloads

Dashboard¶

Das Dashboard zeigt:

Statistik-Karten¶

Items gesamt nach Typ (Features, Tasks, Bugs, Chores)
Status-Verteilung (Offen, In Arbeit, Blockiert, Erledigt)
Prioritäts-Verteilung (Hoch, Mittel, Niedrig)

Konsistenzprüfung¶

Das Konsistenzprüfungs-Widget zeigt:

Grün: Alle Items konsistent
Gelb: Warnungen vorhanden (z.B. Status/Phase Mismatch)
Rot: Fehler vorhanden (ungültige Feldwerte)

Klicken Sie auf das Widget für Details zu den gefundenen Issues.

Nächste Schritte¶

Projekte verwalten – Multi-Projekt-Setup, Git-Integration
Items bearbeiten – Alle Item-Features im Detail

Häufige Fragen¶

F: Wo werden Daten gespeichert?

docs/Backlog.md – Source of Truth (text-basiert, git-freundlich)
.backlog-admin/backlog.db – SQLite Cache (schnelle Queries)
.backlog-admin/backups/ – Automatische Backups

F: Kann ich Backlog.md direkt editieren?

Ja! Änderungen werden automatisch von der App erkannt und importiert. Beachten Sie das korrekte Format (siehe Backlog-Format).

F: Was passiert bei Parse-Fehlern?

Die App zeigt eine Fehlermeldung mit Zeilennummer und Fehlerdetails. Korrigieren Sie den Fehler in der Backlog.md und speichern Sie erneut.

F: Ist CC-Sprint offline-first?

Ja! Keine Server-Komponente nötig. Alles läuft lokal.

F: Wie integriere ich Git?

Siehe Projekte → Git-Integration.

Letzte Aktualisierung: 2026-02-04