정의
에이전트가 읽을 수 있는 제품 의사결정은 코드베이스 밖의 디자인 리뷰, PR 코멘트, Slack 논의, Figma 맥락에 흩어진 제품 판단을 저장소 안의 구조화된 규칙, 예시, 평가, 검증 루프로 옮기는 방식이다. 코드가 “무엇이 배포되었는가”를 보여준다면, 이 구조는 “왜 그것이 기준이 되었는가”를 에이전트가 재사용 가능한 지식으로 만든다.
핵심 속성
- 저장 위치: 제품 판단은 저장소 안의 skill, references, exemplars, lint, eval fixture로 관리된다.
- 분리 원칙: 판단이 필요한 규칙은 prose guidance로 두고, 기계적으로 판정 가능한 규칙은 lint로 강제한다.
- 증거 추적성: 각 규칙은 source, stable ID, 예시, 예외, 열린 질문을 가져야 하며 한 번의 리뷰 코멘트가 즉시 보편 규칙이 되지 않는다.
- 갱신 루프: collector가 증거를 모으고 judge가 검증한 뒤, 인간이 guidance, lint rule, exemplar, eval, coverage gap 중 어디에 반영할지 결정한다.
- 검증 방식: 실제 렌더링, sandbox, lint, holdout eval로 에이전트가 지침을 호출했는지와 실제로 따랐는지를 분리해 측정한다.
관계
- 20260627-product-design-skill — 구현체: Vercel이 제품 디자인 판단을 에이전트에게 주입하는 skill 구조다.
- 20260611-ai-harness-deterministic-lint — 하위 메커니즘: 판단이 아니라 정적 규칙으로 판정 가능한 부분을 담당한다.
- 20260607-harness-engineering-ai-agent-verification — 상위개념: 에이전트의 산출물을 검증 가능한 운영 루프로 묶는 방식이다.
- 20260609-agentic-skill-packaging-pattern — 인접 패턴: 반복되는 지식을 skill로 패키징한다는 점에서 연결된다.
인용
코드베이스에 없는 맥락은 에이전트에게 존재하지 않는다.