Aider Development Assistant

An AI-powered pair programming configuration optimized for iterative development workflows with automated testing, linting, and intelligent Git commit management.

What This Skill Does

This Aider configuration provides a comprehensive development assistant that:

Automatically runs tests after code changes

Enforces code quality through automated linting (Python: black, flake8, mypy)

Manages Git commits with proper attribution

Uses OpenRouter's GPT-5 models for code generation and review

Maintains chat history for context continuity

Validates code before committing

Configuration Details

Quality Automation

**Auto-test**: Runs `./test` script after every change

**Auto-lint**: Applies linting rules automatically

**Python linting**: Custom `./black-flake8-mypy` script enforces formatting and type checking

**No dirty commits**: Prevents commits with failing tests or lint errors

Model Setup

**Primary model**: `openrouter/openai/gpt-5` with diff edit format

**Editor model**: `openrouter/openai/gpt-5-mini` for quick edits

**Weak model**: `openrouter/openai/gpt-5-nano` for simple tasks

**Reasoning effort**: Medium (balances speed and quality)

**Cache prompts**: Enabled to reduce API costs

Git Integration

**Auto-commits**: Commits changes after successful validation

**Co-authored-by attribution**: Credits AI assistance in commits

**Commit message attribution**: Tracks AI-generated commit messages

**Restore chat history**: Maintains conversation context across sessions

UI Preferences

**Dark mode**: Enabled

**Gitignore**: Disabled (keeps `.aider.conf.yml` in repo)

**LLM history**: Logged to `.aider.llm.history.md`

Instructions for AI Agent

When using this Aider configuration:

1. **Read project conventions first**

- The configuration loads `CONVENTIONS.md` on startup

- Follow all project-specific guidelines defined there

2. **Test-driven workflow**

- After making code changes, wait for `./test` to complete

- If tests fail, analyze output and fix issues before proceeding

- Do not commit code with failing tests

3. **Enforce code quality**

- Python files must pass black (formatting), flake8 (linting), and mypy (type checking)

- Run the custom `./black-flake8-mypy` script via auto-lint

- Fix all linting errors before committing

4. **Commit management**

- Let auto-commits handle Git operations after successful validation

- Ensure commit messages are descriptive and follow project conventions

- Include Co-authored-by trailer to credit AI assistance

5. **Model usage strategy**

- Use primary GPT-5 model for complex code changes and architectural decisions

- Use editor model (GPT-5-mini) for minor edits and refactoring

- Use weak model (GPT-5-nano) for simple, repetitive tasks

- Leverage prompt caching to minimize API costs

6. **Context management**

- Restore chat history to maintain continuity across sessions

- Reference previous conversations when relevant

- Keep LLM history file updated for debugging API usage

7. **Error handling**

- If auto-test fails, read test output carefully

- If auto-lint fails, check `.aider.llm.history.md` for details

- Never force commits when quality checks fail

Example Usage

```bash

Start Aider with this configuration

aider

Aider will automatically:

1. Load CONVENTIONS.md

2. Enable dark mode

3. Run tests after changes

4. Lint Python code

5. Commit valid changes with attribution

```

Requirements

Aider CLI installed

`./test` script executable and present in project root

`./black-flake8-mypy` script for Python linting

`CONVENTIONS.md` file in project root

OpenRouter API key configured

Git repository initialized

Notes

This configuration keeps `.aider.conf.yml` in version control (gitignore disabled)

HTML linting is disabled due to Alpine.js template incompatibilities

LLM history logging helps track API usage patterns

Medium reasoning effort balances response quality with speed

Aider Development Assistant

Aider Development Assistant

What This Skill Does

Configuration Details

Quality Automation

Model Setup

Git Integration

UI Preferences

Instructions for AI Agent

Example Usage

Start Aider with this configuration

Aider will automatically:

1. Load CONVENTIONS.md

2. Enable dark mode

3. Run tests after changes

4. Lint Python code

5. Commit valid changes with attribution

Requirements

Notes

Reviews (0)