피드로 돌아가기
Dev.toAI/ML
원문 읽기
YAML 기반 정형 Spec 도입으로 리뷰 시간 60분 단축 및 일관성 확보
Specsmaxxing: escribí mis specs en YAML para mis agentes y esto cambió (y esto no)
AI 요약
Context
LLM 에이전트가 맥락 없는 코드 생성 시 임의적인 의사결정을 내리는 AI Psychosis 현상 발생. 비정형 Prompt 기반 지시만으로는 아키텍처 일관성 유지와 Public Interface 보호에 한계 노출.
Technical Solution
- Prompt 중심의 지시 체계를 버전 관리 및 감사 가능한 YAML 기반 정형 Spec 구조로 전환
- Repository Pattern 및 Typed Error 등 필수 적용 패턴을 명시하여 에이전트의 임의적 설계 배제
- Public API 보호를 위한 수정 금지 파일 목록(files_no_tocar)과 필수 준수 제약 사항 정의
- 성공 기준을 Test Coverage 및 Circular Dependency 체크와 같은 정량적 지표로 구체화
- Supply Chain Attack 방지를 위해 Allowlist 기반의 의존성 관리 규칙 적용
실천 포인트
- 에이전트에게 부여할 제약 사항에 정량적 한계치나 구체적인 예시를 포함했는가 - Public Interface 및 수정 금지 영역을 명시적으로 정의하여 사이드 이펙트를 방지했는가 - 의존성 추가 시 승인 절차를 포함한 Allowlist 기반의 보안 규칙을 설정했는가 - Spec의 성공 기준을 CI 단계에서 검증 가능한 정량적 지표로 구성했는가