Dokumentation

Cursor / KI-Agenten

So nutzt du Cursor, Claude und andere KI-Agenten mit Motoko Base — AGENTS.md, Skills und architekturbewusstes Prompting.

Öffnen inChatGPT Claude Cursor

Motoko Base ist für KI-gestützte Entwicklung gebaut. Agenten erhalten klare Anweisungen, wohin Code gehört, welche Muster gelten und wie Änderungen über OpenSpec geplant werden — damit die Ausgabe zu einem echten SaaS-Starter passt, nicht zu einem generischen Next.js-Tutorial.

Funktioniert mit Cursor, Claude Code und anderen Agenten, die Projektanweisungen und Skills lesen.

Projektanweisungen

Zwei Dateien legen fest, wie sich Agenten verhalten sollen:

Datei	Rolle
`AGENTS.md`	Architektur-Platzierung, Muster befolgen/vermeiden, Demo vs. Core, Check-Befehle
`openspec/config.yaml`	Produktphilosophie, Stack, UI-Regeln, Regeln pro Artefakt für OpenSpec

CLAUDE.md verweist für Claude Code auf AGENTS.md. Cursor lädt AGENTS.md über Workspace Rules.

Vor jeder Feature-Arbeit sollten Agenten wissen:

Code gehört nach src/features/<name>/, nicht verstreut in src/app/
Datenbank und Auth bleiben serverseitig
Mutationen nutzen Server Actions + Zod + Ownership über userId
Optionale Integrationen soft-failen, wenn Env fehlt

Skills und Slash-Befehle

Motoko Base enthält OpenSpec-Skills, die der Agent automatisch lädt:

.agents/skills/openspec-propose/
.agents/skills/openspec-apply-change/
.agents/skills/openspec-archive-change/
.agents/skills/openspec-explore/
.agents/skills/openspec-update-change/
.agents/skills/openspec-sync-specs/

In Cursor liegen passende Slash-Befehle in .cursor/commands/:

Befehl	Wann nutzen
`/opsx-explore`	Ideen erkunden — kein Code
`/opsx-propose`	Neuen Change starten
`/opsx-update`	Plan überarbeiten
`/opsx-apply`	Tasks implementieren
`/opsx-archive`	Change abschließen

Domain-Skills (Drizzle, Supabase Postgres) liegen in .agents/skills/ für Schema- und Query-Arbeit.

Cursor-Docs: Cursor documentation

Gute Aufgaben formulieren

Formuliere Anfragen so, dass der Agent in der Motoko-Architektur bleibt:

Tun

/opsx-propose Add a notes demo under src/features/notes/
Reuse the links feature pattern: queries.ts, actions.ts, schemas.ts,
ownership via session userId, thin route in src/app/dashboard/notes/

/opsx-apply
Follow AGENTS.md — server-first, Zod at boundary, no new UI libraries

Add a nav item for Notes in src/features/dashboard/config/nav.ts

Vermeiden

Build a notes app with Redux and a separate API server

Put all logic in src/app/dashboard/notes/page.tsx

Skip auth checks for now, we'll add them later

Nützliche Referenzen

Muster	Agent hierhin verweisen
CRUD-Demo-Feature	`src/features/links/`
Datei-Uploads	`src/features/storage/`
Settings + Sessions	`src/features/dashboard/components/settings/`
Billing-Integration	`src/lib/billing/` + `src/features/dashboard/actions/billing.ts`
Neue Datenbanktabelle	Adding a New Table
Auth	Better Auth

Sage, ob die Arbeit Core-Infrastruktur, ein wiederverwendbares Muster oder eine entfernbare Demo ist — Agenten nutzen das in OpenSpec-Proposals.

Cursor vs. Claude Code

Tool	Wie Motoko Base andockt
Cursor	`AGENTS.md`-Regeln + `/opsx-*`-Befehle + `.cursor/skills/`
Claude Code	`CLAUDE.md` → `AGENTS.md` + dieselben OpenSpec-CLI/Skills
Andere Agenten	`AGENTS.md`, `openspec/config.yaml` lesen, `openspec`-CLI manuell ausführen

OpenSpec CLI global installieren: installation guide

Checks, die Agenten ausführen sollten

AGENTS.md verlangt diese vor dem Abschluss:

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Bitte den Agenten, sie nach /opsx-apply oder jeder größeren Änderung auszuführen.

Kleine Fixes ohne OpenSpec

Tippfehler, Copy-Änderungen und Einzeiler-Bugs brauchen keine volle Change-Proposal. Normaler Chat reicht:

Fix the typo on the billing page headline

Nutze OpenSpec, wenn die Änderung mehrere Dateien betrifft, Verhalten hinzufügt oder reviewbare Anforderungen braucht.

KI-Entwicklungsworkflow — Voller Ablauf von der Idee bis zum Archive.

OpenSpec — Proposals, Tasks, Apply und Archive.

Projektstruktur — Wo Code liegt.