피드로 돌아가기
Dev.toAI/ML
원문 읽기
YAML Spec 도입을 통한 AI Agent 리뷰 시간 60분 단축 및 설계 일관성 확보
Specsmaxxing: I Wrote YAML Specs for My AI Agents — Here's What Changed (and What Didn't)
AI 요약
Context
AI Agent가 맥락 없이 코드를 생성하며 발생하는 AI psychosis 현상으로 인해 제어 불가능한 의사결정이 빈번하게 발생. 단순 프롬프트 방식은 낮은 구속력으로 인해 리뷰 과정에서 불필요한 수정 작업과 아키텍처 일관성 결여라는 한계 노출.
Technical Solution
- Versioning 및 Audit이 가능한 YAML 기반의 정형화된 Blueprint 구조 설계
- Public Interface 보호를 위한 do_not_touch 및 do_not_break 제약 사항 명시
- Repository Pattern 등 필수 설계 패턴(required_patterns)과 금지 패턴(forbidden_patterns)의 강제 적용
- 테스트 커버리지 및 순환 참조 여부(madge 활용) 등 정량적 Success Criteria 설정
- 의존성 오염 방지를 위한 allowed_dependencies 화이트리스트 기반의 공급망 관리 체계 구축
- 모호성 제거를 위해 정성적 요구사항을 수치적 제한이나 구체적 예시로 구체화하는 제약 조건 최적화
실천 포인트
- AI Agent에게 작업을 맡기기 전 YAML 기반의 정형 스펙 파일 작성 - 'Typed errors'와 같은 추상적 표현 대신 구체적인 계층 구조나 개수 제한 명시 - 기존 코드 수정 시 forbidden_patterns가 기존 코드의 legacy와 충돌하는지 검증 - 신규 라이브러리 도입을 막기 위한 allowlist 기반의 의존성 제약 설정 - 스펙 파일 자체를 코드와 동일한 수준으로 리뷰하고 버전 관리 수행