피드로 돌아가기
Specsmaxxing: escribí mis specs en YAML para mis agentes y esto cambió (y esto no)
Dev.toDev.to
AI/ML

YAML 기반 정형 Spec 도입으로 리뷰 시간 60분 단축 및 일관성 확보

Specsmaxxing: escribí mis specs en YAML para mis agentes y esto cambió (y esto no)

Juan Torchia2026년 5월 3일10intermediate

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 단계에서 검증 가능한 정량적 지표로 구성했는가

원문 읽기