Aider CLI Workflow
Use this skill when the user explicitly wants an Aider-based coding loop in a local repo.
When to use this skill
- Aider 설치/초기 설정 확인부터 실행까지 한번에 정리해야 할 때
- 작은 기능/버그를 테스트 기준으로 AI pair-programming으로 처리할 때
- Aider가 만든 변경을 커밋 단위로 검증/정리해야 할 때
When not to use
- Hosted PR 리뷰/라벨/브랜치 보호 정책 중심 작업 (
code-review, GitHub workflow 계열) - 단순 Git 충돌/복구만 필요한 경우 (
git-workflow) - 루트 원인 디버깅 중심 작업 (
debugging)
Instructions
Step 1) Preconditions
- 저장소 루트 확인:
git rev-parse --show-toplevel - Aider 설치 확인:
aider --version - 기본 검증 명령 확인: 테스트/린트 명령 1개 이상 확보
Step 2) Scope-lock kickoff
- 한 번에 한 작업(버그 1개/기능 1개)만 지정한다.
- Aider 프롬프트에 반드시 포함:
- 변경 대상 파일 범위 - 수용 기준(acceptance criteria) - 테스트/검증 명령
Step 3) Test-backed edit loop
- 기준 테스트 실행(실패/성공 기준선 확보)
- Aider로 수정
- 테스트 재실행
- diff 확인 후 필요 시 추가 수정
Step 4) Commit hygiene
git add -p로 변경 범위를 검토- 커밋 메시지는 의도 + 검증 명령을 포함
- 리스크(실험적 패치, flaky test, 미검증 경로)는 커밋/보고서에 명시
Step 5) Fallback
- 변경이 과도하게 퍼지면 즉시 범위를 축소하고 재시도
- 테스트가 반복적으로 깨지면 Aider 자동 수정 루프를 멈추고 원인 분석으로 전환
Output format
# Aider Run Brief
- Goal:
- Scope:
- Validation commands:
- Changed files:
- Risks / follow-ups:Examples
Example 1: small bugfix loop
- Goal: failing unit test 1개를 green으로 복구
- Scope: 테스트 파일 + 관련 구현 파일만 편집
- Validation:
pytest -q tests/path/test_x.py
Example 2: narrow feature increment
- Goal: API 필드 1개 추가 + 역호환 유지
- Scope: schema + handler + 테스트
- Validation: 기존 테스트 + 신규 테스트
Best practices
- 항상 baseline 테스트 결과를 먼저 확보한다.
- 파일 범위를 명시하지 않은 Aider 세션은 시작하지 않는다.
- 커밋 전에
git add -p로 불필요 변경을 제거한다. - flaky/실험적 변경은 리스크를 명시하고 후속 TODO를 남긴다.
References
- Aider: https://github.com/Aider-AI/aider
- Aider docs: https://aider.chat/