Complete Aider configuration for ADD (Agent-Driven Development) 2.0 Universal methodology with contract-first implementation, multi-agent coordination, and phase-aware development
Complete Aider configuration implementing the ADD (Agent-Driven Development) 2.0 Universal methodology with contract-first development, multi-agent coordination, and phase-aware workflows.
Configures Aider to follow ADD 2.0 methodology with:
Create `.aider.conf.yml` in your project root with the following content:
```yaml
model: claude-3-5-sonnet-20241022
editor-model: claude-3-5-sonnet-20241022
architect-model: claude-3-5-sonnet-20241022
architect: true
auto-commits: true
commit-message-template: |
{msg}
ADD 2.0 Phase: {phase}
Contract Compliance: {contract_status}
Co-authored-by: Aider <[email protected]>
dirty-commits: false
show-diffs: true
read:
- add-project.yaml
- README.md
- docs/discovery.md
- docs/design.md
- docs/interfaces.md
- docs/journal.md
ignore:
- "*.log"
- "node_modules/*"
- ".git/*"
- "dist/*"
- "build/*"
- ".next/*"
- "coverage/*"
test-cmd: npm test
lint: true
lint-cmd: npm run lint
system-prompt: |
You are an AI pair programmer following ADD (Agent-Driven Development) 2.0 Universal methodology.
CRITICAL RULES:
1. ALWAYS read project documentation first (add-project.yaml, docs/*.md)
2. Determine current phase from add-project.yaml version field
3. In BUILD phase (v0.4.x), read docs/interfaces.md for contracts BEFORE implementing
4. Implement EXACTLY to contract specification - no deviations
5. Use mocks for dependencies not yet implemented
6. Never commit changes across different phases
7. Validate exit criteria before considering phase complete
8. Update docs/journal.md with progress
PHASES:
- v0.1.x DISCOVER: Research, requirements, analysis
- v0.2.x DESIGN: Architecture, contracts, design
- v0.3.x PREPARE: Setup, configuration, tools
- v0.4.x BUILD: Implementation (CONTRACT-FIRST if multi-agent)
- v0.5.x VALIDATE: Testing, QA, validation
- v0.6.x DELIVER: Deployment, launch
- v0.7.x SUPPORT: Maintenance, bug fixes
- v0.8.x EVOLVE: Optimization, enhancements
CONTRACT-FIRST (in BUILD phase):
1. Read docs/interfaces.md first
2. Implement exactly as specified
3. Use mocks for missing dependencies
4. Add contract compliance comments
5. Include tests validating contract
When in doubt, ask which phase we're in and what the goal is.
ask-before-commit: true
pretty: true
check-update: false
```
Create required project documentation files:
```bash
mkdir -p docs
touch add-project.yaml docs/discovery.md docs/design.md docs/interfaces.md docs/journal.md
```
Set up your project metadata with version indicating current phase:
```yaml
name: your-project
version: 0.1.0 # Phase: DISCOVER (0.1.x), DESIGN (0.2.x), BUILD (0.4.x), etc.
phase: DISCOVER
```
**Basic session:**
```bash
aider --config .aider.conf.yml
```
**Check current phase and goals:**
```bash
aider --message "What phase are we in? Show exit criteria."
```
**Architect mode for planning:**
```bash
aider --architect --message "Plan implementation of user authentication"
```
In BUILD phase (v0.4.x), always start by reviewing contracts:
```bash
aider --message "Read docs/interfaces.md and list all contracts"
aider --message "Implement POST /api/users following contract in docs/interfaces.md"
aider --message "Run tests and validate contract compliance"
```
For parallel development with multiple Aider instances:
**Backend agent:**
```bash
git checkout -b feature/v0.4.x-backend
aider --config .aider.conf.yml \
--read src/backend/ \
--read docs/interfaces.md \
--message "Implement API endpoints per contracts"
```
**Frontend agent (in separate terminal):**
```bash
git checkout -b feature/v0.4.x-frontend
aider --config .aider.conf.yml \
--read src/frontend/ \
--read docs/interfaces.md \
--message "Implement UI components per contracts (use mocks)"
```
**Coordinate via Git:**
```bash
git commit -m "build(api): all endpoints ready
Frontend team: you can now replace mocks with real API
All contracts from docs/interfaces.md implemented
Tests: 20/20 passing"
git push
git pull
aider --message "Backend API is ready. Replace mocks with real API client"
```
**DISCOVER phase:**
```
discover(requirements): document user authentication requirements
Research findings documented in docs/discovery.md
ADD 2.0 Phase: DISCOVER
```
**DESIGN phase:**
```
design(architecture): define API contracts for user service
All endpoints specified in docs/interfaces.md
ADD 2.0 Phase: DESIGN
Contract Compliance: N/A (defining contracts)
```
**BUILD phase:**
```
build(api): implement POST /api/users endpoint
Implements contract from docs/interfaces.md:
ADD 2.0 Phase: BUILD
Contract Compliance: Yes
Tests: Included (5/5 passing)
```
Update journal with progress:
```bash
aider --message "Update docs/journal.md with today's progress"
```
Before advancing to next phase:
```bash
aider --message "Check all exit criteria for BUILD phase"
```
| Phase | Version | Focus | Key Files |
|-------|---------|-------|-----------|
| DISCOVER | v0.1.x | Research, requirements | docs/discovery.md |
| DESIGN | v0.2.x | Architecture, contracts | docs/design.md, docs/interfaces.md |
| PREPARE | v0.3.x | Setup, configuration | N/A |
| BUILD | v0.4.x | Implementation | docs/interfaces.md (contracts) |
| VALIDATE | v0.5.x | Testing, QA | Test files |
| DELIVER | v0.6.x | Deployment | Deployment configs |
| SUPPORT | v0.7.x | Bug fixes | Issue tracking |
| EVOLVE | v0.8.x | Optimization | Performance docs |
**Aider doesn't follow contracts:**
```bash
aider --message "Read docs/interfaces.md for POST /api/users contract, then implement exactly as specified"
```
**Commits span multiple phases:**
```bash
aider --message "This is BUILD phase work only. Don't include DESIGN files."
```
**Multi-agent conflicts:**
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/add-20-universal-configuration-for-aider/raw