Markdown

Für Einsteiger

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.

Auf dieser Seite

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:

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.

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.
  • „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.

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.