Skip to content

[DOCS] ⓪에 재료 0개 SAFE 금지와 unknown_tag 카드 삭제 반영 (#133) - #288

Merged
ugnee2 merged 1 commit into
mainfrom
docs/supervisor-xai-pending
Oct 20, 2026
Merged

ugnee2 merged 1 commit into
mainfrom
docs/supervisor-xai-pending

Conversation

@ugnee2

@ugnee2 ugnee2 commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

🔗 Related Issue

📝 Summary

⑧ XAI에서 정했지만 ⓪ Supervisor에 아직 없던 두 가지를 ⓪에 반영합니다. Judge JSON을 Notion으로 넘기기 전에 ⓪과 ⑧이 같은 내용이 되도록 맞추는 작업입니다.

  1. 재료가 하나도 없으면 SAFE 금지 — 판정에 쓸 재료 목록이 텅 빈 채로 오면, ⑧의 "모든 재료가 사장님 확인값이면 SAFE" 조건이 저절로 참이 되어 SAFE가 나갈 수 있었습니다. 이런 메뉴는 정보 없음과 같이 처리합니다 (⑧ #282에서 결정).
  2. 태그를 모르는 재료에는 사장님 질문 카드를 만들지 않음 — 표준 재료로 못 맞추거나 태그 조회에 실패한 재료는 사용자와 겹치는지 알 수 없고, 재료 이름으로 물어도 판정이 바뀌지 않습니다. 이런 재료는 이미 SAFE가 막혀 있으므로, 카드 이유 코드에서 unknown_tag를 빼고 고위험 재검증 이유로만 씁니다 (⑧ #284에서 결정).
  • 영향: 1을 반영하지 않으면 ⓪만 보고 구현할 때 재료 0개 메뉴가 SAFE로 나갈 수 있습니다 (FN). 2를 반영하지 않으면 ⓪과 ⑧의 카드 이유 코드 목록이 서로 달라집니다.

🚀 Key Changes

⓪ Supervisor (docs/0-agent-supervisor.md)

  • §4-7 SAFE 금지 목록에 "confirmed_results·probability_results·proposed_variant_ingredients가 모두 비어 있음" 추가
  • §4-7 owner_cards[].reason_codes 허용값과 카드 정렬 순서에서 unknown_tag 삭제, 태그를 모르는 재료는 카드를 만들지 않는다는 문장 추가
  • 고위험 재검증의 high_risk_review.reason_code의 unknown_tag는 그대로 둠 (§2-10, §4-7)
  • §7 테스트 36(재료 0개면 SAFE 아님), 37(태그를 모르는 재료는 카드 없이 재검증 이유로만) 추가

⑧ XAI (docs/8-agent-xai.md)

  • §9 "⓪에 미반영 항목"의 두 항목 체크, §2-2 제목을 다시 "⓪ §4-7과 동일"로
  • §9에서 "기록 번역은 백엔드" 항목 삭제 (⓪에 따로 반영할 내용이 아니라 정리)

💥 Breaking Changes

  • Judge 응답 owner_cards[].reason_codes의 허용값이 8개에서 7개가 됩니다 (unknown_tag 삭제). 필드 구조는 그대로지만, 이유 코드마다 문구를 붙이는 쪽(프론트·백엔드)은 목록에서 빼야 합니다
  • SAFE 금지 조건 추가는 규칙만 바뀌고 JSON 필드는 그대로입니다

✅ Self-Check List

  • 스스로 한 번 이상 리뷰했습니다. (Self-review)
  • 문서만 변경했습니다. 코드 변경은 없습니다.

🤖 Generated with Claude Code

@ugnee2
ugnee2 merged commit 6d78040 into main Oct 20, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant