Motia Project Aider Config

Configuration skill for Aider when working on Motia AI aggregation projects (e.g., ai-route). This setup ensures the AI agent automatically reads the project's architectural documentation and coding standards.

What This Does

Sets up Aider to automatically read `AGENTS.md` (the project overview and guide hub) on every session. The AGENTS.md file references detailed architectural guides in `.cursor/rules/` and `.cursor/architecture/`, which the AI will consult as needed based on the task.

Instructions

When a user wants to configure Aider for a Motia-style project:

1. **Create `.aider.conf.yml` in the project root** with this content:

```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 in the project root** — this file should contain:

- Project overview and purpose

- Links to architectural guides in `.cursor/rules/motia/` (API patterns, event handlers, cron jobs, state management, middleware, streaming, virtual steps, UI)

- Links to `.cursor/architecture/` docs (architecture, error handling)

- Instructions for the AI agent on when to consult each guide

3. **Optional: Uncomment specific guides** in the `read:` section if you want them loaded upfront instead of on-demand.

4. **Optional: Enable auto-commits** by uncommenting `auto-commits: true`.

5. **Optional: Set a default model** by uncommenting and modifying the `model:` line (e.g., `claude-3-5-sonnet-20241022`, `gpt-4`).

6. **Optional: Add additional context files** like `config.yml`, `package.json`, or environment-specific docs.

Architecture Notes

Example Usage

After creating `.aider.conf.yml`:

```bash

Start Aider — it will auto-load AGENTS.md

aider

The AI now has context on:

- Project structure

- Where to find API, event, cron, state, middleware, streaming, virtual, and UI guides

- Error handling and architectural patterns

```

Constraints