# 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 |

```fish
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
