tworkflow

Was macht tworkflow?

Ein praktischer, übertreibungsfreier Workflow für KI-Codierungsagenten: Kontext, Plan, Implementierung, Review, QA, Auslieferung, Retrospektive. Mit Vorlagen, zwei Claude Code Skills und einer 40%-Kontextregel – jede Behauptung ist durch offizielle Dokumentation belegt.

Überblick

Dieser Workflow hilft Entwicklern, KI-Codierungsagenten systematisch durch den Entwicklungsprozess zu führen. Er reduziert Kontextüberlastung und stellt sicher, dass der Agent immer den Gesamtüberblick behält.

Hauptmerkmale

• 7-Phasen-Workflow: Kontext, Plan, Implementierung, Review, QA, Auslieferung, Retrospektive
• Markdown-Vorlagen: Vorgefertigte Dokumente für jede Phase
• Claude Code Skills: Zwei integrierte Skills (tworkflow-cli und tworkflow-agent) für nahtlose Integration
• 40%-Kontextregel: Maximal 40% des Kontextfensters werden für die aktuelle Aufgabe genutzt; 60% bleiben für den Gesamtkontext reserviert
• Belegte Behauptungen: Jeder Schritt verweist auf offizielle Claude-Code-Dokumentation

Installation

1. Klone dieses Repository:

   git clone https://github.com/clarity-digital-development/tworkflow.git
   cd tworkflow
   

2. Installiere die Claude Code Skills:

   • Kopiere die Dateien aus skills/ in dein Claude-Code-Skills-Verzeichnis
   • Oder verwende den bereitgestellten Installationsbefehl:

     ./install-skills.sh
     

3. Beginne mit der Workflow-Vorlage deiner Wahl aus dem templates/-Verzeichnis

Nutzung

Für Claude Code

Starte eine neue Sitzung mit dem Skill tworkflow-agent:

/claude tworkflow-agent

Dieser Skill führt dich durch die sieben Phasen und stellt sicher, dass der 40%-Kontext eingehalten wird.

Manuell

Öffne eine Vorlage aus templates/ und befolge die Anweisungen. Jede Phase enthält klare Schritte und Verweise auf die offizielle Dokumentation.

Phasen

1. Kontext: Sammle und dokumentiere relevante Informationen zum Projekt
2. Plan: Erstelle einen detaillierten Implementierungsplan
3. Implementierung: Führe den Plan aus, mit regelmäßigen Checks
4. Review: Überprüfe die Änderungen auf Korrektheit und Stil
5. QA: Führe Tests und Qualitätssicherung durch
6. Auslieferung: Stelle die Änderungen bereit (Deploy, Merge, etc.)
7. Retrospektive: Analysiere den Prozess und identifiziere Verbesserungen

40%-Kontextregel

Eine zentrale Idee dieses Workflows ist die 40%-Kontextregel: Dein Agent sollte niemals mehr als 40% seines verfügbaren Kontextfensters für eine einzelne Aufgabe nutzen. Der Rest bleibt für Projektkontext, Abhängigkeiten und den Gesamtüberblick reserviert. Dies verhindert Kontextverlust und stellt sicher, dass der Agent langfristig konsistent arbeitet.

Belege

Jede Behauptung im Workflow ist durch einen Link zur offiziellen Claude-Code-Dokumentation belegt. Siehe REFERENZEN.md für eine vollständige Liste.

Lizenz

MIT – siehe LICENSE für Details.