Motia Icon
AI Development Guides

AI Development Guides Overview

Universal AI guides for building production-ready Motia applications with any AI tool

AI Development Guides for Motia

Motia provides comprehensive AI development guides that work with any AI tool or IDE. Whether you're using Cursor, VS Code with Copilot, Claude, ChatGPT, or any other AI assistant, these guides enable "one-shot complete backend" development with proven architectural patterns.

🤖 Universal AI Guides

🤖

AGENTS.md - Universal Guide

Works with ALL AI tools and IDEs - Cursor, VS Code, JetBrains, Claude, ChatGPT, and more.

  • Complete project architecture patterns
  • Multi-language workflow examples (JavaScript, TypeScript, Python, Ruby)
  • Production-ready code templates
  • Best practices for any AI assistant
🧠

CLAUDE.md - Claude-Specific Guide

Optimized specifically for Claude AI assistant with advanced prompting techniques and structured workflows.

  • Detailed step templates and examples
  • Claude-specific prompt patterns
  • Complex workflow orchestration
  • Advanced development scenarios

Cursor Rules - IDE-Specific Patterns

IDE-specific patterns that enhance the universal guides when using Cursor IDE.

  • Complete application patterns
  • Multi-language workflows
  • API, Event, and Cron step patterns
  • Authentication and background job patterns
  • Real-time streaming and AI agent patterns

Key Features

🌐 Multi-Language Support

  • JavaScript: Rapid prototyping, simple APIs, real-time features
  • TypeScript: Type-safe business logic, complex APIs, production systems
  • Python: ML/AI processing, data science, complex algorithms
  • Ruby: Background jobs, data manipulation, system integration

Application Types Supported

Build Any Type of Backend

Motia's AI guides work for any type of production-ready backend - not just specific domains!

🛒

🛍️ E-commerce

Product catalogs, payments, inventory, order processing

💬

📱 Social Platforms

User feeds, real-time chat, notifications, content moderation

🏦

💰 Fintech

Transaction processing, account management, compliance workflows

⚕️

🏥 Healthcare

Patient records, appointment scheduling, medical data processing

🎯

🎮 Gaming

Player management, leaderboards, real-time multiplayer features

🏢

🏢 Enterprise

CRM systems, workflow automation, reporting dashboards

...and literally any other type of backend your business needs

Quick Setup

# Create new Motia project
npx motia@latest create my-app
cd my-app
 
# Pull AI development guides and cursor rules
npx motia@latest rules pull
 
# This creates:
# • AGENTS.md - Universal guide for ANY AI tool (project root)
# • CLAUDE.md - Claude-specific guide (project root)
# • .cursor/rules/ - IDE-specific patterns for Cursor

Usage Examples

Primary AI Development Guides

AGENTS.md and CLAUDE.md are your main development guides. They work with ANY AI tool and contain all the patterns you need. The .cursor/rules/ files are optional IDE-specific enhancements for Cursor users.

AI-Powered Development

Once AI guides are installed, AI assistants can generate complete applications using the patterns!

Example prompt to AI assistant:

"Using the patterns from AGENTS.md, create a complete e-commerce backend 
with user authentication, product catalog, shopping cart, and payment 
processing using Motia patterns."

The AI will use AGENTS.md patterns to generate:

  • Authentication system with JWT
  • Product management APIs
  • Shopping cart functionality
  • Payment processing workflows
  • Real-time inventory updates
  • Background job processing
  • Production deployment config

CLI Commands

# Install essential AI development guides (AGENTS.md, CLAUDE.md) + optional Cursor rules
npx motia@latest rules pull
 
# List available AI development guides and IDE rules
npx motia@latest rules list
 
# Show AGENTS.md (universal guide)
npx motia@latest rules show agents
 
# Show CLAUDE.md (Claude-specific guide)
npx motia@latest rules show claude
 
# Show a specific Cursor IDE rule
npx motia@latest rules show api-steps

Ready to Get Started?

Check out the Setup Guide for detailed installation instructions and configuration for different AI tools.

Need help? See our Community Resources for questions, examples, and discussions.

On this page