Skip to content

PRODUCT_SENSE.md

이 파일은 에이전트(agent)가 코드만으로는 신뢰할 수 있게 추론할 수 없는 지속적인 제품 판단을 담습니다.

제품 감각(product sense) 문서는 단순한 기능 명세(feature spec)를 넘어, 팀이 어떤 종류의 결정을 어떤 우선순위로 내려야 하는지에 관한 횡단 관심사(cross-cutting) 원칙을 에이전트에게 제공합니다.

제품 핵심

  • 주요 사용자: [교체]
  • 해야 할 일(job to be done): [교체]
  • 제거할 주요 불편함: [교체]
  • 인수 품질 기준: [교체]

제품 규칙

  • 기능 수보다 사용자에게 보이는 신뢰성(reliability)을 우선시한다.
  • 모호한 동작은 추측할 권한이 아닌 명세 공백(spec gap)으로 취급한다.
  • 구현이 사용자가 보거나 신뢰하는 것을 변경하면 일치하는 명세를 업데이트한다.
  • 구체적인 흐름에는 제품 명세(product spec)를 사용하고, 횡단적인 제품 우선순위에는 이 파일을 사용한다.

금지 패턴

  • 숨겨진 파괴적 행동
  • 사용자 피드백 없는 무음(無音) 실패
  • 가시적 상태에 대한 불명확한 진실 원천
  • 한 문장으로 설명할 수 없는 기능