Aider Configuration for Motia Projects

This skill provides an Aider configuration optimized for Motia-based projects (smart meeting summarizers, action trackers, and similar backend systems). It automatically loads project context from `AGENTS.md` and references detailed implementation guides.

What This Skill Does

Sets up Aider to work intelligently with Motia project architectures by:

Instructions

When implementing this configuration:

1. **Create `.aider.conf.yml` in project root** with the following structure:

```yaml

Aider Configuration for Motia Projects

https://aider.chat/docs/config.html

Read AGENTS.md for project overview and guide references

read:

- AGENTS.md

# Uncomment specific guides as needed for more context:

# - .cursor/rules/motia/api-steps.mdc

# - .cursor/rules/motia/event-steps.mdc

# - .cursor/rules/motia/cron-steps.mdc

# - .cursor/rules/motia/state-management.mdc

# - .cursor/rules/motia/middlewares.mdc

# - .cursor/rules/motia/realtime-streaming.mdc

# - .cursor/rules/motia/virtual-steps.mdc

# - .cursor/rules/motia/ui-steps.mdc

# - .cursor/architecture/architecture.mdc

# - .cursor/architecture/error-handling.mdc

Note: AGENTS.md references all detailed guides in .cursor/rules/

The AI will read those guides when needed based on AGENTS.md instructions

Auto-commit changes (optional, uncomment to enable)

auto-commits: true

Model selection (uncomment your preferred model)

model: gpt-4

model: claude-3-5-sonnet-20241022

Additional context files (optional)

read:

- config.yml

- package.json

```

2. **Ensure `AGENTS.md` exists** at the project root and contains:

- High-level project architecture overview

- References to all detailed implementation guides in `.cursor/rules/motia/`

- Instructions for when to consult specific guides

3. **Customize guide loading** based on current work:

- Leave all guides commented by default (lightweight context)

- Uncomment specific guides when working on related features

- Example: Uncomment `api-steps.mdc` when building API endpoints

- Example: Uncomment `realtime-streaming.mdc` when working on WebSocket features

4. **Configure optional features** as needed:

- **Auto-commits**: Uncomment `auto-commits: true` to enable automatic Git commits after changes

- **Model selection**: Uncomment and set your preferred model (GPT-4, Claude Sonnet, etc.)

- **Additional context**: Add project-specific files like `config.yml`, `package.json` to the `read` list

5. **Architecture-aware development**:

- The configuration supports Motia's event-driven architecture

- Guides cover: API patterns, event handling, cron jobs, state management, middleware patterns, real-time streaming, virtual steps, and UI components

- Error handling and architectural patterns are available in `.cursor/architecture/`

Usage Examples

**Basic setup for new Motia project:**

```bash

Create .aider.conf.yml with default configuration

Ensure AGENTS.md exists with project overview

aider

```

**Working on API endpoints:**

```yaml

read:

- AGENTS.md

- .cursor/rules/motia/api-steps.mdc # Uncommented for API work

```

**Working on real-time features:**

```yaml

read:

- AGENTS.md

- .cursor/rules/motia/realtime-streaming.mdc

- .cursor/rules/motia/event-steps.mdc

```

**Full context mode (for complex refactoring):**

```yaml

read:

- AGENTS.md

- .cursor/rules/motia/api-steps.mdc

- .cursor/rules/motia/event-steps.mdc

- .cursor/rules/motia/state-management.mdc

- .cursor/architecture/architecture.mdc

- .cursor/architecture/error-handling.mdc

```

Important Notes