Projekte verwalten¶

CC-Sprint unterstützt mehrere Projekte und bietet integrierte Git-Funktionen.

Projekt-Konzept¶

Single Source of Truth¶

Jedes Projekt basiert auf einer docs/Backlog.md Datei:

Backlog.md ist die Wahrheit – alle Items, Status, Beschreibungen
SQLite-Datenbank ist ein Cache für schnelle Queries und Filterung
Backups sichern den Zustand vor Änderungen

Projekt-Struktur¶

my-project/
├── docs/
│   └── Backlog.md           # Source of Truth
├── .backlog-admin/
│   ├── backlog.db           # SQLite Cache
│   └── backups/             # Timestamped Backups
│       ├── backlog-2026-02-01_10-30-00.md
│       └── backlog-2026-02-02_14-15-30.md
├── src/                     # Ihr Quellcode
├── CLAUDE.md                # Claude Code Kontext
└── .gitignore

Projekt erstellen¶

Neues Projekt¶

Starten Sie CC-Sprint
Klicken Sie "Neues Projekt erstellen"
Wählen Sie einen Ordner (leer oder existierend)
Geben Sie einen Projekt-Namen ein
Klicken Sie "Erstellen"

CC-Sprint erstellt:

docs/Backlog.md mit Standard-Template
.backlog-admin/ Ordner mit Datenbank
Initiale Backup-Datei

Existierendes Projekt öffnen¶

Voraussetzung: Ordner enthält docs/Backlog.md

Klicken Sie "Projekt öffnen"
Navigieren Sie zum Projekt-Ordner
Wählen Sie den Ordner
Klicken Sie "Öffnen"

CC-Sprint analysiert:

Parst die Backlog.md
Erstellt/aktualisiert .backlog-admin/backlog.db
Importiert alle Items
Zeigt Parse-Fehler falls vorhanden

Kürzlich geöffnete Projekte¶

Die Startseite zeigt kürzlich geöffnete Projekte mit:

Projekt-Name
Pfad
Letzte Änderung
Item-Anzahl

Klicken Sie auf ein Projekt zum schnellen Öffnen.

Projekt-Einstellungen¶

Zugriff: Settings Tab → Projekt-Bereich

Allgemeine Einstellungen¶

Einstellung	Beschreibung	Standard
Auto-Save	Automatisches Speichern nach Änderungen	Ein
Auto-Save Debounce	Verzögerung vor dem Speichern	2000ms

Backup-Einstellungen¶

Einstellung	Beschreibung	Standard
Auto-Backup	Backup vor jeder Schreiboperation	Ein
Max Backups	Maximale Anzahl aufbewahrter Backups	10
Max Alter (Tage)	Backups älter als X Tage löschen	30

Git-Integration¶

CC-Sprint bietet vollständige Git-Integration für Versionskontrolle.

Git-Status anzeigen¶

Im Settings Tab unter "Git-Integration":

Branch: Aktueller Branch-Name
Remote URL: Verbundenes Repository
Uncommitted Changes: Ja/Nein
Unpushed Commits: Anzahl

Commit & Push¶

Gehen Sie zu Settings → Git-Integration
Geben Sie eine Commit-Nachricht ein
Klicken Sie "Commit & Push"

Die App committed und pusht docs/Backlog.md automatisch.

Auto-Commit (Optional)¶

Aktivieren Sie Auto-Commit in Settings:

Bei jeder Item-Änderung wird automatisch committed
Commit-Nachricht wird aus der Änderung generiert

Auto-Push (Optional)¶

Aktivieren Sie Auto-Push in Settings:

Nach jedem Commit wird automatisch gepusht
Erfordert konfiguriertes Remote-Repository

Git-Credentials¶

Für Private Repositories:

Settings → Git-Integration → Token konfigurieren
Geben Sie Ihren Git-Token ein (GitLab/GitHub Personal Access Token)
Token wird sicher im System-Keyring gespeichert

Sicherheit

Tokens werden im System-Keyring gespeichert (Windows Credential Manager, macOS Keychain, Linux Secret Service). Sie werden nie im Klartext gespeichert.

Empfohlene .gitignore¶

# CC-Sprint Cache + Backups (nicht versionieren)
.backlog-admin/

# Backlog.md IST versioniert (Source of Truth)
# !docs/Backlog.md  # Nicht ausschließen!

Warum?

Backlog.md ist Source of Truth → Git versionieren
.backlog-admin/backlog.db ist Cache → Lokal
.backlog-admin/backups/ sind lokale Kopien → Lokal

Backup-Management¶

Automatische Backups¶

CC-Sprint erstellt automatisch Backups:

Vor jeder Schreiboperation auf Backlog.md
Naming: backlog-YYYY-MM-DD_HH-MM-SS.md
Speicherort: .backlog-admin/backups/

Backup-Liste anzeigen¶

Settings → Backup Management

Zeigt alle verfügbaren Backups mit:

Dateiname und Zeitstempel
Dateigröße
Item-Anzahl

Backup wiederherstellen¶

Gehen Sie zu Settings → Backup Management
Wählen Sie ein Backup aus der Liste
Klicken Sie "Wiederherstellen"
Bestätigen Sie die Aktion

Achtung

Wiederherstellen überschreibt die aktuelle Backlog.md. Ein neues Backup des aktuellen Stands wird vorher erstellt.

Manuelles Backup erstellen¶

Klicken Sie "Backup erstellen" in Backup Management für ein sofortiges Backup.

Backup validieren¶

Überprüfen Sie ein Backup vor der Wiederherstellung:

Wählen Sie ein Backup
Klicken Sie "Validieren"
Zeigt: Gültig/Ungültig, Item-Anzahl, Parse-Fehler

Multi-Projekt-Workflow¶

Zwischen Projekten wechseln¶

Klicken Sie auf Projekt-Name in der Titelleiste
Wählen Sie ein kürzlich geöffnetes Projekt
Oder: "Anderes Projekt öffnen..."

Mehrere Branches¶

Bei der Arbeit mit Git-Branches:

git checkout feature/new-ui
# Ändere docs/Backlog.md
git commit -m "Add feature items"
git checkout main

CC-Sprint Verhalten:

Erkennt Backlog.md-Änderung beim Branch-Wechsel
Re-importiert Items automatisch
Jeder Branch kann eigene Items haben

Team-Workflow¶

Szenario: Team arbeitet parallel am Backlog

Pull neueste Backlog.md
CC-Sprint erkennt Änderung → Re-import
Arbeite in der App
Commit & Push über Git-Integration
Teammates pullen → Ihre Apps aktualisieren

Merge-Konflikte:

Bei Git-Merge-Konflikten in Backlog.md:

Lösen Sie den Konflikt im Editor
Speichern Sie die Datei
CC-Sprint re-importiert automatisch

Projekt-Statistiken¶

Das Dashboard zeigt Projekt-Statistiken:

Item-Übersicht¶

Gesamt: Anzahl aller Items
Nach Typ: Features, Tasks, Bugs, Chores
Nach Status: Offen, In Arbeit, Blockiert, Erledigt
Nach Priorität: Hoch, Mittel, Niedrig

Konsistenzprüfung¶

Zeigt Validierungsstatus:

Ungültige Feldwerte (Errors)
Status/Phase Mismatches (Warnings)
Details per Klick

CLI für Projekte¶

Die ccs CLI unterstützt Projekt-Operationen:

# Backlog validieren
ccs backlog validate --project /path/to/project

# Git-Status
ccs git status --project .

# Backup erstellen
ccs backup create --project .

# Backup wiederherstellen
ccs backup restore --project . backlog-2026-02-04_10-30-00.md

Siehe CLI Referenz für alle Befehle.

Geplante Features¶

Roadmap

Folgende Projekt-Features sind geplant:

Feature	Beschreibung	Status
Projekt-Export	JSON/CSV Export	Geplant
Projekt-Import	Import von anderen Tools	Geplant
Projekt-Templates	Vordefinierte Backlog-Templates	Geplant
Projekt-Archivierung	Alte Projekte archivieren	Geplant

Siehe auch¶

Erste Schritte – Grundlagen
Items bearbeiten – Item-Features
CLI Referenz – ccs Befehle
Git-Integration – Technische Details

Letzte Aktualisierung: 2026-02-04