Aider Configuration for Stock Verification System

Configure Aider to work on a stock verification system with a read-only SQL Server ERP source and a read-write MongoDB primary database.

Architecture Context

Configuration Steps

1. Model & Edit Format

Use Claude Sonnet 4 with diff-based editing for both primary and weak model tasks:

```

model: claude-sonnet-4-20250514

edit-format: diff

weak-model: claude-sonnet-4-20250514

```

2. Git & Commit Attribution

Enable Git integration with full author attribution, but disable auto-commits for manual control:

```

git: true

gitignore: true

auto-commits: false

dirty-commits: false

attribute-author: true

attribute-committer: true

attribute-commit-message-author: true

attribute-commit-message-committer: true

```

3. Read-Only Reference Files

Prevent Aider from modifying documentation and configuration files. Add these as read-only context:

```

read:

- README.md

- ARCHITECTURE.md

- API_CONTRACTS.md

- API_REFERENCE.md

- .cursorrules

- .github/copilot-instructions.md

```

4. Lint Commands (Auto-Fix)

Configure language-specific linters to run automatically on modified files:

5. Test Command

Set the test command to run the full suite via Makefile:

```

test-cmd: "make test"

```

**Individual test commands** (for reference):

6. Code Map Settings

Use a 2048-token context window with automatic refresh:

```

map-tokens: 2048

map-refresh: auto

```

7. System Prompt (Critical Rules)

Inject the following system prompt to enforce architectural constraints:

```

You are working on the Stock Verification System.

CRITICAL RULES:

ARCHITECTURE:

TEST COMMANDS:

```

8. Safety & Environment

Enable shell command suggestions and diff display. Load secrets from `.env`:

```

suggest-shell-commands: true

show-diffs: true

check-update: true

env-file: .env

```

9. Ignore Files

Respect both `.gitignore` and `.aiderignore` for file exclusions:

```

ignore-file:

- .gitignore

- .aiderignore

```

10. Voice Settings (Optional)

Enable experimental voice mode with English language:

```

voice-language: en

```

Usage Example

Once configured, Aider will:

Important Constraints