Aider Motia Project Configuration

Configures Aider to work with Motia projects using a structured agent-based architecture with modular guides for different development concerns.

What This Skill Does

This skill sets up Aider to work effectively with Motia projects by:

Instructions

When working with a Motia project using Aider:

1. **Always read AGENTS.md first**

- This file contains the project overview and references to all detailed guides

- The AI should use AGENTS.md as the primary navigation document

- Specific guides in `.cursor/rules/` and `.cursor/architecture/` will be referenced as needed

2. **Understand the modular guide structure**

- `api-steps.mdc` — API endpoint development patterns

- `event-steps.mdc` — Event-driven architecture patterns

- `cron-steps.mdc` — Scheduled job implementation

- `state-management.mdc` — State handling patterns

- `middlewares.mdc` — Middleware implementation

- `realtime-streaming.mdc` — Real-time data streaming

- `virtual-steps.mdc` — Virtual step patterns

- `ui-steps.mdc` — UI component patterns

- `architecture.mdc` — Overall architecture documentation

- `error-handling.mdc` — Error handling strategies

3. **Configure model preference**

- Uncomment the appropriate model line in `.aider.conf.yml`

- Recommended: `claude-3-5-sonnet-20241022` or `gpt-4`

4. **Enable auto-commits (optional)**

- Uncomment `auto-commits: true` to automatically commit changes after each edit

- Useful for tracking incremental progress

5. **Add additional context files as needed**

- Uncomment or add files under the `read:` section

- Common additions: `config.yml`, `package.json`, environment configs

6. **Follow the agent-based workflow**

- When implementing features, reference the appropriate guide from AGENTS.md

- Keep changes focused and aligned with established patterns

- Use the modular architecture to maintain separation of concerns

Usage Example

1. Create `.aider.conf.yml` in your Motia project root with this configuration

2. Ensure `AGENTS.md` exists and contains project overview and guide references

3. Run `aider` in your project directory

4. Aider will automatically load the configuration and provide context-aware assistance

Configuration File

```yaml

Aider Configuration for Motia Projects

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

read:

- AGENTS.md

Model selection (uncomment your preferred model)

model: gpt-4

model: claude-3-5-sonnet-20241022

Auto-commit changes (optional)

auto-commits: true

Additional context files (optional)

read:

- config.yml

- package.json

```

Important Notes