Dokumentation

KI-Entwicklungsworkflow

So baust du auf Motoko Base mit KI-Agenten — von der Idee bis zum Review mit OpenSpec und Cursor.

Motoko Base liefert einen spezifikationsgetriebenen KI-Workflow. Statt einen Agenten die App in einem Rutsch umschreiben zu lassen, planst du in OpenSpec-Artefakten, prüfst den Plan und implementierst dann Aufgabe für Aufgabe. Änderungen bleiben begrenzt, reviewbar und an der Starter-Architektur ausgerichtet.

Das ist eines der Verkaufsargumente des Starters: du bekommst Produktionsmuster und die Werkzeuge, um sie mit KI sicher zu erweitern.

Der Workflow

Idea
 ↓
OpenSpec (optional explore)
 ↓
Proposal
 ↓
Design
 ↓
Tasks
 ↓
Cursor / AI Agent (apply)
 ↓
Implementation
 ↓
Review → archive

Phase	Was du tust	Ergebnis
Idea	Feature oder Fix im Chat beschreiben	Grobes Ziel
Explore (optional)	`/opsx-explore` — Trade-offs, Codebase-Mapping	Geklärter Scope, kein Code
Proposal	`/opsx-propose` — Was & Warum, Non-Goals	`proposal.md`
Design	Mit Propose erstellt — wie es zum Starter passt	`design.md`
Tasks	Checkbox-Schritte für den Agenten	`tasks.md`
Apply	`/opsx-apply` — Tasks einzeln umsetzen	Codeänderungen
Review	Diff lesen, Checks laufen lassen, manuell testen	Freigegeben oder überarbeiten
Archive	`/opsx-archive` — Specs syncen, Change ins Archive verschieben	Aktualisiertes `openspec/specs/`

Planung und Implementierung sind getrennte Schritte. Propose schreibt keinen Produktcode. Apply wartet, bis du es ausdrücklich startest.

Wann der volle Workflow sinnvoll ist

Situation	OpenSpec nutzen?
Neues Feature oder Demo	Ja
Multi-Datei-Refactor	Ja
Querschnittliche Änderung (Auth, Billing, Schema)	Ja
Tippfehler, Copy-Anpassung, Einzeiler-Bug	Nein — normale Chat-Bearbeitung

Beispielsitzung

/opsx-explore Should team invites be a demo or core feature?

/opsx-propose Add team invites demo with ownership checks

# Review proposal.md, design.md, tasks.md — edit or /opsx-update if needed

/opsx-apply

pnpm lint && pnpm typecheck && pnpm test && pnpm build

/opsx-archive

Voraussetzungen

OpenSpec CLI global installiert (npm install -g @fission-ai/openspec@latest)
Cursor (oder ein anderer Agent, der .agents/skills/ lädt)
AGENTS.md im Repo-Root lesen — Architekturregeln, denen Agenten folgen

Das Repo ist bereits initialisiert — kein openspec init nötig.

Nach der Implementierung

Führe die Starter-Checks vor dem Merge aus:

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Verweise den Agenten auf ein bestehendes Feature (z. B. src/features/links/) als Vorlage für neue Arbeit.

OpenSpec — Artefakte, Befehle, Apply und Archive im Detail.

Cursor / KI-Agenten — AGENTS.md, Skills und Prompting innerhalb der Motoko-Architektur.