Motia Project Aider Configuration

This skill configures Aider for Motia projects using AGENTS.md as the primary context file with optional guide references.

What This Skill Does

Sets up Aider to:

Instructions

When a user wants to set up Aider for a Motia project:

1. **Create `.aider.conf.yml` file** in the project root with this 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. **Verify AGENTS.md exists** in the project root. If not, create it with project overview and guide references.

3. **Customize configuration** based on user needs:

- **Uncomment specific guides** if user needs focused context (e.g., only API or event guides)

- **Enable auto-commits** if user wants automatic commit behavior

- **Set preferred model** (GPT-4, Claude 3.5 Sonnet, etc.)

- **Add additional context files** (config.yml, package.json, etc.)

4. **Explain the configuration strategy**:

- AGENTS.md serves as the central context hub

- Specific guides are commented out by default to reduce token usage

- Uncomment guides only when working on related features

- The AI will reference guides as needed based on AGENTS.md instructions

5. **Test the configuration**:

- Run `aider` in the project directory

- Verify AGENTS.md is loaded

- Check that Aider can reference the guide structure

Usage Examples

**Basic setup:**

```bash

Create default Motia Aider configuration

aider --config .aider.conf.yml

```

**Working on API features:**

Uncomment `api-steps.mdc` in the `read:` section.

**Working on event system:**

Uncomment `event-steps.mdc` in the `read:` section.

**Enable auto-commits for rapid iteration:**

Uncomment `auto-commits: true`.

Important Notes