# Mit einem KI-Agenten arbeiten

Claude Code, Cursor und Codex kennen die Regeln deines Projekts und sprechen über das Agent-Plugin direkt mit der Plattform.

> Source: https://www.application-platform.com/de/docs/work-with-ai-agents/

In einem Plattform-Projekt befolgt ein KI-Agent wie Claude Code, Cursor oder Codex die hinterlegten Regeln und spricht über das Agent-Plugin mit der Plattform. Öffne ihn immer im übergeordneten Projektordner `~/Documents/application-platform/<organisation>/<projekt>/`, damit er alle Repositories und die Regeldateien findet.

## Das Agent-Plugin installieren

Voraussetzung sind Node.js ab Version 18 und die ap CLI. Beides erledigst du im Terminal, die CLI mit dem ersten Befehl (Windows in PowerShell: `irm https://www.application-platform.com/install.ps1 | iex`), das Plugin mit dem zweiten:

```bash
curl -fsSL https://www.application-platform.com/install.sh | sh
npx --yes github:doppelt-digital/application-platform-plugin
```

Der Installer erkennt die installierten Agenten, legt bei ihnen Skills und MCP-Konfiguration ab und meldet dich mit `ap login` an; danach lädst du den Editor neu oder startest den Agenten neu.

Das Plugin bringt Skills, Slash-Commands wie `/create-project` sowie den MCP-Server `application-platform` über `ap mcp serve`; Details und die Installationswege für einzelne Tools stehen unter [CLI und Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}).

## Worum du den Agenten bitten kannst

- „Importiere dieses Projekt in meinen Application-Platform-Account.“ Der Agent erkennt den Stack, legt das Projekt an und pusht deinen Code, siehe [Bestehendes Projekt übernehmen]({{< relref "import-existing-project" >}}).
- „Lege ein neues Application-Platform-Projekt mit einer Next.js-App und einem NestJS-Backend an und klone es.“ Der Agent legt das Projekt aus einer Vorlage an, wartet auf die Einrichtung und klont es.
- „Starte das Backend lokal.“ Der Agent führt im Backend-Repository `ap run-local` aus.

## Welche Regeln der Agent befolgt

Die Datei `AGENTS.md` aus `local-configuration` im Projektordner verlangt, Anwendungen mit `ap run-local` zu starten, `.gitlab-ci.yml` und `env/*.generated.env` nie von Hand zu ändern, eigene Werte in `env/*.custom.env` zu schreiben, keine Geheimnisse zu committen oder auszugeben, im Anwendungs-Repository statt in `local-configuration` zu arbeiten, Laufzeiten aus `.tool-versions` zu nehmen und Backend-Uploads unter `./upload` abzulegen. Von selbst committen und pushen die Agenten nicht.

## Eigene Regeln ergänzen

Eigene Regeln, etwa bevorzugte Bibliotheken, ergänzt du in `local-configuration/AGENTS.md`; nach Commit und Push gelten sie für alle im Team, siehe [Eigene Regeln für KI-Agenten]({{< relref "ai-instructions" >}}).

## Grenzen

Der MCP-Server läuft lokal über die ap CLI, deshalb können Cloud-Agenten ihn nicht nutzen; meldet der Agent, dass du nicht angemeldet bist, gib `ap login` ein. Schlägt das Anlegen oder Importieren fehl, umgeht der Agent den Fehler nicht mit eigenen Git-Befehlen.

Änderungen des Agenten [sicherst und veröffentlichst du]({{< relref "save-and-publish" >}}).