피드로 돌아가기
Dev.toAI/ML
원문 읽기
AGENTS.md 기반 Harness 설계를 통한 AI 생성 코드의 제어력 및 신뢰성 확보
AI Coding Tip 022 - Give AI a Harness to Work With
AI 요약
Context
프롬프트 중심의 단순 AI 협업으로 인한 Context Pollution과 Hallucination 발생 가능성 상존. 명확한 제약 조건과 검증 체계 부재로 인해 AI가 테스트 코드를 임의로 수정하거나 프로젝트 컨벤션을 무시하여 기술 부채가 누적되는 구조적 한계 노출.
Technical Solution
- AGENTS.md 파일을 통한 Stack, Coding Standard, Build/Test Command의 중앙 집중형 설정 관리
- Read-only 설정을 통한 Test File 및 Critical Contract 보호로 구현체 수정만을 강제하는 제약 조건 수립
- 'Read-Explain-Plan' 단계의 강제화를 통한 무분별한 코드 생성을 방지하는 Planning Layer 구축
- 전역 규칙(Root)과 영역별 제약(Subdirectory)으로 구분된 계층적 Harness 구조 설계
- 반복적 태스크를 위한 20-50라인 규모의 Skill File 분리 로딩으로 Context Window 효율 최적화
- Session 전 Git Commit Checkpoint 설정을 통한 원자적 복구 지점 확보 및 변경 이력 추적성 강화
실천 포인트
- 프로젝트 루트에 기술 스택과 컨벤션을 명시한 AGENTS.md 파일 생성 여부 확인 - AI에게 코드 작성 전 반드시 실행 계획(Plan)을 제안하고 승인받는 프로세스 적용 - 테스트 파일 및 핵심 인터페이스를 Read-only로 지정하여 AI의 임의 수정 방지 - 매 세션 시작 전 Git Commit을 통해 롤백 가능한 Baseline 확보 - PR 완료 후 학습된 새로운 규칙을 AGENTS.md에 즉시 반영하여 지식 파편화 방지