INBOX/ki-coding-workflow.md

Lokaler KI-Coding-Workflow

VS Code + continue.dev · Mistral 22B + Qwen2.5-Coder 7B · CachyOS · Stand: Juni 2026

---

Philosophie

• Architect für Entscheidungen, Coder für Code — nie mischen
• Eine Aufgabe pro Session — neuer Chat, klarer Scope
• Immer @file-Kontext — nie annehmen, dass das Modell weiß, was offen ist
• Plan vor Code — erst Ansatz erklären lassen, dann implementieren
• Ein Stück nach dem anderen — Datenmodell → Service → Route → Template

---

Setup

	Architect	Coder
Modell	Mistral Small 22B	Qwen2.5-Coder 7B
Kontext	16k Token	32k Token
Aufgaben	Planung, Review, Architektur	Code schreiben, Bugfixes, Inline-Edits

llama-switch   # dann [1] Architect oder [2] Coder wählen

---

Wichtigste Shortcuts

Aktion	Shortcut
Chat öffnen	Ctrl+L
Inline-Edit (markierter Code)	Ctrl+I
Inline-Vorschlag annehmen	Ctrl+Shift+Enter
Inline-Vorschlag ablehnen	Escape
Neue Chat-Session	+ im Chat-Panel

---

Kontext-Tags (immer verwenden)

@file pfad/zur/datei.py     → eine bestimmte Datei
@currentFile                → die gerade offene Datei
@codebase                   → durchsucht das ganze Projekt
@problems                   → VS Code Lint-Fehler

---

Der Build-Workflow

1 · Design validieren (Mistral)

@file CLAUDE.md

Ich fange gleich an zu bauen. Geh die wichtigsten Komponenten
in Build-Reihenfolge durch. Zeig mir Lücken und Risiken,
bevor ich eine einzige Zeile schreibe.

2 · Aufgaben-Checkliste (Mistral)

Mach daraus eine nummerierte Build-Checkliste.
Eine Aufgabe pro Komponente, eine Aufgabe pro Session.

→ Als TASKS.md speichern. Das ist die Roadmap.

3 · Aufgabe planen (Qwen — neue Session)

@file CLAUDE.md

Aufgabe 3: [Aufgabe aus Checkliste einfügen]
Erkläre deinen Ansatz und welche Dateien du anfasst,
bevor du irgendetwas schreibst.

4 · Stück für Stück bauen (Qwen)

Gut. Schreib jetzt nur das Datenmodell. Sonst nichts.

Dann:

Jetzt den Service-Layer. Erst nur das Interface.

5 · Inline-Fixes (Qwen · Ctrl+I)

Code markieren → Ctrl+I → Änderung beschreiben:

In eine separate Funktion auslagern und Fehlerbehandlung ergänzen

6 · Fertigen Teil reviewen (Mistral)

@file app/routes/auth.py
@file CLAUDE.md

Review gegen das Design-Dokument.
Korrektheitsprobleme zuerst, dann Wartbarkeit.

---

Prompt-Muster

Bug fixen:

@currentFile

Zeile 42 wirft einen Null-Pointer wenn der Nutzer keine Session hat.
Erst die Ursache, dann der minimale Fix, dann mögliche Folgeverbesserungen.

Unbekannten Code verstehen:

@file app/auth.py

Erklär mir Schritt für Schritt, was diese Datei macht.
Geh davon aus, dass ich die Codebase noch nicht kenne.

Feststecken bei einem Ansatz:

@file CLAUDE.md

Ich muss [X] implementieren. Gib mir 2–3 Ansätze mit
Vor- und Nachteilen, dann deine Empfehlung.

---

Projekt-Standarddokumente

Jedes Projekt bekommt diese drei Dateien:

Datei	Inhalt
CLAUDE.md	Projektanker: Stack, Architektur, Regeln, Logik. Claude Code liest sie automatisch.
TASKS.md	Session-Checkliste: eine Aufgabe pro Session, Tool, Prompt, Deliverables.
Konzept-*.md	Stakeholder-Dokument auf Deutsch: Zweck, Rollen, Funktionen, Out-of-Scope.

---

KI-Tools im Überblick

Tool	Wofür
Mistral 22B (Architect)	Planung, Design-Entscheidungen, Reviews — nie Produktivcode
Qwen2.5-Coder 7B (Coder)	Implementierung, Bugfixes, Autocomplete, Inline-Edits
Claude Code CLI	Scaffold, Mehrdateien-Arbeit, übergreifendes Verdrahten
Claude (Chat)	Mentor, Architektur-Entscheidungen, Dokumentation, Deployment

---

Goldene Regeln

1. Neue Session pro Aufgabe — Kontext nicht über Aufgaben hinweg wachsen lassen
2. Immer @file — nie annehmen, dass das Modell weiß, was relevant ist
3. Chat vor Edit — in Chat planen, Ctrl+I nur für gezielte Änderungen
4. Ein Stück nach dem anderen — Datenmodell, dann Service, dann Handler
5. Nach jeder Session committen