> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Mit einem Coding-Agenten bauen

Übergeben Sie Aufgaben an einen Coding-Agenten: die Dateien, die er liest, die mitgelieferten Skills und die Überprüfung, die Sie unter Kontrolle hält.

## Schritt-für-Schritt für Einsteiger

Voraussetzungen: Lesen Sie die beiden Anfänger-Handbücher unten und schließen Sie die lokale Desktop-Einrichtung ab. Ein Coding-Agent ist ein KI-Werkzeug — Cursor, Claude Code, Devin oder ein ähnlicher Assistent —, das Ihr Projekt liest, Dateien bearbeitet und Befehle ausführt. Alles auf dieser Seite gilt für jeden, den Sie verwenden.

Kurze Begriffe: Ein Prompt ist der Anweisungstext, den Sie in den Agenten einfügen. Ein Diff ist die Liste der Dateiänderungen, die er vorschlägt. Das Repository-Stammverzeichnis ist der oberste Ordner mit der package.json — der Agent sollte immer dort starten.

1. Öffnen Sie `.agents/skills/` im Repository-Stammverzeichnis und kopieren Sie den Skill, der Ihrer Aufgabe am nächsten kommt — `add-a-desktop-capability` ist ein guter erster Versuch.

2. Fügen Sie ihn in Ihren Agenten ein, beschreiben Sie Ihre Änderung und fügen Sie eine Zeile hinzu: Lesen Sie `llms.txt`, dann `AGENTS.md`, dann `.ai/PROJECT_CONTEXT.md`, bevor Sie Code anfassen.

3. Lassen Sie den Agenten die Dateien auflisten, die er ändern wird, und die Prüfungen, die er vor der Bearbeitung ausführt. Wenn er fertig ist, prüfen Sie den Diff — Sie genehmigen echte Änderungen an Ihrem Produkt.

4. Veröffentlichung, das Freigeben von Installern und kostenpflichtige Provider-Aufrufe sind niemals Teil eines Aufgaben-Prompts. Halten Sie sie als separate Schritte, die Sie ausdrücklich genehmigen.

[Bevor Sie beginnen](https://supastack.dev/de/docs/desktop/before-you-start.md)

[Terminal-Grundlagen](https://supastack.dev/de/docs/desktop/terminal-basics.md)

[Lokales Desktop-Setup](https://supastack.dev/de/docs/desktop/ship-in-5-minutes.md)


## Die Dateien, die Ihr Agent liest

Das Repository liefert einen kleinen Stapel Dateien mit, die für Agenten geschrieben sind, nicht nur für Menschen. Sie fügen diesen Kontext nie von Hand ein — verweisen Sie den Agenten auf `llms.txt`, und er liest den Rest selbst.

Die Lesereihenfolge zählt: `llms.txt` ist die Karte, `AGENTS.md` setzt die Grenzen, und `.ai/PROJECT_CONTEXT.md` trägt, was frühere Sitzungen gelernt haben. Ein Agent, der die Grenzen überspringt, produziert Code, den Sie nicht ausliefern können.

| Datei | Was sie dem Agenten gibt |
|---|---|
| `llms.txt` | Die Einstiegskarte des Repositorys, so generiert, dass sie nur auflistet, was dieser Checkout tatsächlich mitliefert |
| `AGENTS.md` | Die unverhandelbaren Grenzen: nur lokale Arbeit, bis Sie mehr genehmigen, die Shell forkt niemals Produkt-UI |
| `.ai/PROJECT_CONTEXT.md` | Sitzungsübergreifendes Gedächtnis — was sich zuletzt geändert hat und warum; vor Codeänderungen lesen |
| .ai/-Spiegel-Dokumente | Eine passende .ai/<path>.md-Notiz neben wichtigen Dateien, die Entscheidungen und offene Punkte pro Datei festhält |
| `.agents/skills/` | Aufgaben-Runbooks, die für Agenten geschrieben wurden — die fünf unten aufgeführten Desktop-Skills |
| `docs/agent-security.md` | Die Abnahme-Checkliste — Authentifizierung, Workspace- und Berechtigungsprüfungen, redigierte Logs |
| `docs/desktop-updates.md` | Das Runbook für den Update-Kanal — Signaturschlüssel, Endpunkte und Release-Kanäle |
| `.env.example` | Das vollständige Umgebungsinventar — der Agent erfindet nie einen Variablennamen, der nicht in dieser Datei steht |


## Die mitgelieferten Skills

Jede Datei unter `.agents/skills/` ist ein vollständiges Briefing: Fügen Sie sie ein oder lassen Sie den Agenten sie lesen, und die Regeln des Kits reisen mit — Produkt-UI bleibt in der Web-App, nur OS-Verhalten geht in Rust.

Die einfügbare `prompts/`-Bibliothek wird nur im Web-Repository mitgeliefert; dieser Checkout trägt stattdessen Skills. Für eine unbeaufsichtigte Einrichtung verwenden Sie den fertigen Prompt im Agent-Setup-Handbuch.

[Lassen Sie den Agenten die Einrichtung ausführen](https://supastack.dev/de/docs/desktop/agent-setup.md)

- `add-a-desktop-capability` — Fenster-, Tray-, Tastenkürzel-, Update- oder Build-Änderungen
- `adding-a-dependency` — eine npm-Abhängigkeit sicher hinzufügen, aktualisieren oder verschieben
- `reviewing-a-pr` — einen Diff auf Korrektheit, Workspace-Isolierung und Geheimnisse prüfen
- `upgrading-from-upstream` — eine neuere Kit-Version in Ihre Shell ziehen
- `verify-changes` — die richtigen Prüfungen vor der Übergabe auswählen und ausführen


## Wie sich der Agent zwischen Sitzungen erinnert

Agenten haben zwischen Sitzungen kein Gedächtnis — der `.ai/`-Ordner ist das Gedächtnis. `.ai/PROJECT_CONTEXT.md` protokolliert, was sich zuletzt geändert hat und warum. Daneben erklärt ein Spiegeldokument wie `.ai/apps/desktop/src-tauri/src/lib.md` die Entscheidungen hinter `apps/desktop/src-tauri/src/lib.rs`, die der Code allein nicht zeigt.

Der Vertrag ist einfach: Lesen Sie den Spiegel einer Datei, bevor Sie sie bearbeiten, und aktualisieren Sie den Spiegel, wenn die Änderung übernommen wird. Open-Threads-Einträge halten unfertige Arbeit fest, damit die nächste Sitzung weitermacht statt von vorn zu beginnen. Ein veralteter Spiegel ist schlimmer als keiner — wenn Sie den Diff des Agenten prüfen, kontrollieren Sie, dass die Spiegel geänderter Dateien mitgewandert sind.


## Die Arbeit des Agenten ehrlich prüfen

Eine fertige Aufgabe ist ein Beleg, keine Zusammenfassung. Bevor Sie die Arbeit des Agenten übernehmen, prüfen Sie sie so, wie `docs/agent-security.md` ein Deployment prüft:

Wenn etwas nicht stimmt, schicken Sie den Diff zurück — der Agent korrigiert seine eigene Arbeit am schnellsten, wenn Sie die fehlschlagende Prüfung benennen. Für alles, was er nie allein hätte versuchen dürfen, sagen Sie es einmal ausdrücklich; die Grenze gilt für den Rest der Sitzung.

[Verifizierungstore und die Testsuite](https://supastack.dev/de/docs/desktop/testing.md)

- Es hat die Prüfungen ausgeführt, die es behauptet — cargo test, cargo check oder den Release-Preflight — fragen Sie nach dem Befehl und seiner Ausgabe, nicht nach einer Schlussfolgerung.
- Geheimnisse blieben nur auf dem Server — kein Signaturschlüssel oder Zertifikat wurde in einen Bericht oder Commit gedruckt, und die Shell trägt weiterhin keine Provider-Anmeldedaten.
- Produktverhalten blieb in der Web-App — der Diff fügt keine parallele UI-, Auth- oder Chat-Logik in Rust hinzu.
- Der `.ai/`-Spiegel jeder geänderten Datei ist mit dem Code mitgewandert.
- Veröffentlichung, das Freigeben von Installern und kostenpflichtige Provider-Aufrufe blieben separate Schritte, die Sie genehmigt haben — der Agent hat niemals selbstständig gemergt, gepusht oder freigegeben.
- Wenn ein Schritt zweimal fehlschlug, hat er gestoppt und den fehlschlagenden Befehl gemeldet, statt darum herum zu improvisieren.


Wenn du die Einrichtung fortsetzen möchtest, lies [Desktop-Release-Konten einrichten](https://supastack.dev/de/docs/desktop/external-accounts.md).


## Weiter

[Desktop-Release-Konten einrichten](https://supastack.dev/de/docs/desktop/external-accounts.md)