출처

개요

O’Reilly Radar 에세이가 에이전틱 개발에서 스펙을 얼마나 줘야 하는지 다룬다. 짧은 프롬프트로 시작하면 당장은 빠르지만 검토·재설명·수정 요청으로 이어지는 교정 루프가 생기고, 결국 사람이 검증 기준(오라클) 역할을 떠맡는다. 반대로 스펙을 끝없이 쌓으면 그것대로 문제가 된다.

핵심 포인트

  • 병목은 사라진 게 아니라 옮겨갔다: 소프트웨어 개발의 본질은 무엇이 존재해야 하고 무엇이 일어나면 안 되는지 정하는 일이다. 예전에는 비싼 구현 비용이 거칠게나마 스펙을 강제했지만, 지금은 애매한 요구사항이 기계 속도로 그대로 시스템이 된다.
  • 스펙 작성과 스펙 검증은 다른 일: 꼼꼼한 스펙도 자기모순, 정상 경로만 다루고 재시도·부분 실패는 빠뜨림, 검증 불가능한 서술 같은 방식으로 실패한다. 에이전트가 결함 있는 스펙을 충실히 따르면 결과는 그럴듯하고 검사도 통과해 원인 찾기가 더 어렵다.
  • 구현 전에 물을 것: 내적으로 일관된가, 이 작업에 충분히 완결됐나, 어디가 테스트 가능하고 어디가 사람 판단에 남는가, 모두가 가정해서 빠뜨린 실패 상황은 없나.
  • 에이전트로 스펙 검증하기: 한 에이전트가 최소 스펙 초안을 쓰고, 다른 에이전트가 모순·애매함·검증 불가 주장·누락된 실패 상황을 공격하게 한다.
  • 스펙에도 유효기간이 있다: 입력이 길수록 모델 성능은 불안정해지고, 설계 문서·예시·계획·낡은 승인 기준이 섞이면 무엇이 지시이고 무엇이 기록인지 흐려진다. 인터페이스·테스트·불변 조건이 자리 잡으면 상세 설계 문서는 줄여야 한다. 안 그러면 사람용과 에이전트용 스펙이 따로 생긴다.

왜 중요한가

“스펙을 쓰면 에이전트가 구현한다”는 단순한 그림에서 빠진 두 단계, 즉 스펙 검증과 스펙 정리를 짚는다. 적정선은 필요한 만큼의 구조, 의도를 구체화하는 예시, 실행 가능한 확인 장치다.

참고 링크

관련 위키

원문 보존 위치

원문 전체는 raw source: 2026-07-21-aisparkup-post-14611-post에 source_url 및 HTML 원문과 함께 저장되어 있습니다.