164 lines
4.1 KiB
Markdown
164 lines
4.1 KiB
Markdown
# 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
|