Documentación

Flujo de desarrollo con IA

Cómo construir sobre Motoko Base con agentes de IA — de la idea a la revisión usando OpenSpec y Cursor.

Motoko Base incluye un flujo de trabajo con IA basado en especificaciones. En lugar de pedirle a un agente que reescriba la app de una sola vez, planificas en artefactos OpenSpec, revisas el plan y luego implementas tarea por tarea. Los cambios se mantienen acotados, revisables y alineados con la arquitectura del starter.

Este es uno de los puntos fuertes del starter: obtienes patrones de producción y las herramientas para extenderlos con IA de forma segura.

El flujo de trabajo

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

Fase	Qué haces	Resultado
Idea	Describes la feature o el arreglo en el chat	Objetivo aproximado
Explore (opcional)	`/opsx-explore` — trade-offs, mapeo del codebase	Alcance aclarado, sin código
Proposal	`/opsx-propose` — qué y por qué, non-goals	`proposal.md`
Design	Se crea con propose — cómo encaja en el starter	`design.md`
Tasks	Pasos con checkbox para el agente	`tasks.md`
Apply	`/opsx-apply` — implementa tareas una a una	Cambios de código
Review	Lees el diff, ejecutas checks, pruebas a mano	Aprobado o revisar
Archive	`/opsx-archive` — sincroniza specs, mueve el change al archive	`openspec/specs/` actualizado

La planificación y la implementación son pasos separados. Propose no escribe código de producto. Apply espera hasta que lo inicies explícitamente.

Cuándo usar el flujo completo

Situación	¿Usar OpenSpec?
Nueva feature o demo	Sí
Refactor multiarchivo	Sí
Cambio transversal (auth, billing, schema)	Sí
Typo, ajuste de copy, bug de una línea	No — edición normal en el chat

Ejemplo de sesión

/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

Requisitos previos

OpenSpec CLI instalado globalmente (npm install -g @fission-ai/openspec@latest)
Cursor (u otro agente que cargue .agents/skills/)
Leer AGENTS.md en la raíz del repositorio — reglas de arquitectura que siguen los agentes

El repositorio ya está inicializado — no hace falta openspec init.

Después de la implementación

Ejecuta las comprobaciones del starter antes de fusionar:

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Señala al agente una feature existente (p. ej. src/features/links/) como plantilla para trabajo nuevo.

OpenSpec — Artefactos, comandos, apply y archive en detalle.

Cursor / AI Agents — AGENTS.md, skills y cómo hacer prompts dentro de la arquitectura Motoko.