Documentation

Flux de développement IA

Comment construire sur Motoko Base avec des agents IA — de l’idée à la revue avec OpenSpec et Cursor.

Motoko Base propose un flux de travail IA piloté par les specs. Au lieu de demander à un agent de réécrire l’app d’un coup, vous planifiez dans des artefacts OpenSpec, vous validez le plan, puis vous implémentez tâche par tâche. Les changements restent ciblés, revus facilement et alignés sur l’architecture du starter.

C’est l’un des atouts du starter : vous obtenez des patterns de production et les outils pour les étendre en toute sécurité avec l’IA.

Le flux de travail

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

Phase	Ce que vous faites	Résultat
Idea	Décrire la feature ou le correctif dans le chat	Objectif approximatif
Explore (optionnel)	`/opsx-explore` — trade-offs, cartographie du codebase	Périmètre clarifié, sans code
Proposal	`/opsx-propose` — quoi & pourquoi, non-goals	`proposal.md`
Design	Créé avec propose — comment ça s’intègre au starter	`design.md`
Tasks	Étapes à cases à cocher pour l’agent	`tasks.md`
Apply	`/opsx-apply` — implémenter les tâches une par une	Modifications de code
Review	Lire le diff, lancer les checks, tester manuellement	Approuvé ou à revoir
Archive	`/opsx-archive` — synchroniser les specs, déplacer le change vers l’archive	`openspec/specs/` mis à jour

La planification et l’implémentation sont des étapes séparées. Propose n’écrit pas de code produit. Apply attend que vous le démarriez explicitement.

Quand utiliser le flux complet

Situation	Utiliser OpenSpec ?
Nouvelle feature ou démo	Oui
Refactor multi-fichiers	Oui
Changement transverse (auth, billing, schema)	Oui
Typo, ajustement de copy, bug d’une ligne	Non — édition chat normale

Exemple de session

/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

Prérequis

OpenSpec CLI installé globalement (npm install -g @fission-ai/openspec@latest)
Cursor (ou un autre agent qui charge .agents/skills/)
Lire AGENTS.md à la racine du dépôt — règles d’architecture suivies par les agents

Le dépôt est déjà initialisé — pas besoin de openspec init.

Après l’implémentation

Lancez les vérifications du starter avant de merger :

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Indiquez à l’agent une feature existante (p. ex. src/features/links/) comme modèle pour un nouveau travail.

OpenSpec — Artefacts, commandes, apply et archive en détail.

Cursor / agents IA — AGENTS.md, skills et comment prompter dans l’architecture Motoko.