From c6a7f402b146ae598c0a6b33a49ed03f6a6f2371 Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Mon, 23 Mar 2026 00:53:21 +0900
Subject: [PATCH] docs: close 260323 grounding routing rollback follow-up

---
 ...�이브리드검색_품질개선_계획.md |  4 +-
 journey/troubleshooting/README.md             |  2 -
 ...�복원_및_fallback복구_검증완료.md | 49 +++++++++++++++++++
 3 files changed, 52 insertions(+), 3 deletions(-)
 create mode 100644 journey/worklog/260323_companyx_grounding_마커기반라우팅복원_및_fallback복구_검증완료.md

diff --git a/journey/plans/260321_하이브리드검색_품질개선_계획.md b/journey/plans/260321_하이브리드검색_품질개선_계획.md
index 5d504fd..993a7a8 100644
--- a/journey/plans/260321_하이브리드검색_품질개선_계획.md
+++ b/journey/plans/260321_하이브리드검색_품질개선_계획.md
@@ -1,7 +1,7 @@
 ---
 status: closed
 closed_date: 2026-03-21
-closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅완화) 전부 구현·배포·검증 완료. keyword 0→5건, grounding 5→11, 옐로펀치 MOU top-1.
+closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅완화) 구현·배포·검증 완료. 다만 P1-5(team_id 단독 grounding)는 2026-03-23 마커 기반 진입으로 롤백됨.
 ---
 
 # 260321 하이브리드 검색 품질 개선 계획
@@ -15,6 +15,7 @@ closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅
 
 - [260321 하이브리드 검색 keyword recall=0 및 grounding 실패 원인 확정 리서치](../research/rag/260321_하이브리드검색_keyword_recall0_및_grounding_실패_원인확정_리서치.md)
 - [260320 로빙 다형식문서 RAG 적용1 계획](./260320_로빙_다형식문서_RAG_적용1_계획.md)
+- [260323 Company X grounding 마커 기반 라우팅 복원 및 fallback 복구 검증 완료](../worklog/260323_companyx_grounding_마커기반라우팅복원_및_fallback복구_검증완료.md)
 
 ## 원인 → 조치 매핑
 
@@ -66,6 +67,7 @@ closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅
 - 따라서 grounding 검색 결과 0건이면 기존처럼 일반 챗봇 경로로 자연 fallback
 - **범위 위험**: 일반 대화("점심 뭐 먹을까?")도 검색 API를 태우게 됨. 불필요한 API 호출 + 응답 지연 발생 가능
 - **롤백 기준**: 배포 후 일반 대화 응답 지연이 1초 이상 증가하거나, grounding 경로 진입률이 80% 이상이면 마커 체크 복원
+- **후속 이력**: 위 위험이 실제 협업 검토에서 확인되어 2026-03-23 `91b92da`에서 `team_id + marker` 기준으로 롤백됐다. 현재 운영 기준은 이 문서가 아니라 260323 워크로그와 `SKILL.md`, `companyx_grounding_pipeline.md`를 따른다.
 
 ## 실행 순서
 
diff --git a/journey/troubleshooting/README.md b/journey/troubleshooting/README.md
index a2cfe29..2269b53 100644
--- a/journey/troubleshooting/README.md
+++ b/journey/troubleshooting/README.md
@@ -39,8 +39,6 @@
   - 상태: 열림
 - [260311_prompt_db_partial_adoption_and_hardcoded_prompts.md](./260311_prompt_db_partial_adoption_and_hardcoded_prompts.md)
   - 상태: 열림
-- [260312_companyx_rag_answer_composition_regression.md](./260312_companyx_rag_answer_composition_regression.md)
-  - 상태: 범위 조정 중
 - [260312_rb8001_memory_chromadb_768_384_dimension_drift.md](./260312_rb8001_memory_chromadb_768_384_dimension_drift.md)
   - 상태: 열림
 
diff --git a/journey/worklog/260323_companyx_grounding_마커기반라우팅복원_및_fallback복구_검증완료.md b/journey/worklog/260323_companyx_grounding_마커기반라우팅복원_및_fallback복구_검증완료.md
new file mode 100644
index 0000000..6d7693e
--- /dev/null
+++ b/journey/worklog/260323_companyx_grounding_마커기반라우팅복원_및_fallback복구_검증완료.md
@@ -0,0 +1,49 @@
+---
+type: worklog
+tags: [worklog, companyx, grounding, routing, fallback, rb8001]
+work_date: 2026-03-23
+---
+
+# 260323 Company X grounding 마커 기반 라우팅 복원 및 fallback 복구 검증 완료
+
+## 배경
+
+- `260321_하이브리드검색_품질개선_계획.md`의 P1-5에서 Company X team_id 사용자는 마커 없이도 grounding을 우선 시도하도록 완화했다.
+- 이후 일반 대화까지 grounding 경로에 과잉 진입할 수 있다는 협업 검토가 나왔고, 23/24 서버 에이전트가 최종적으로 마커 기반 복원에 합의했다.
+
+## 조치
+
+1. `rb8001` `91b92da`
+   - `should_handle_companyx_grounding()`를 `team_id + marker(intent/domain)` 기준으로 복원
+   - `try_companyx_grounding()`에서 검색 결과 0건이면 `None`을 반환해 일반 스킬 경로로 fallback 복구
+2. `DOCS` `c1d9cc2`
+   - `skills/companyx-rag/SKILL.md` Trigger를 마커 기반 진입으로 정렬
+   - `workflow/03_rag/companyx_grounding_pipeline.md` 처리 순서와 실패 분기를 현재 코드 기준으로 정렬
+
+## 검증
+
+- 코드 실물 확인:
+  - `rb8001` HEAD `91b92da`
+  - `should_handle_companyx_grounding()`는 `team_id == COMPANYX_TEAM_ID`이면서 marker 매칭일 때만 grounding 진입
+  - `try_companyx_grounding()`는 `top_results` 0건일 때 `None` 반환
+- 문서 실물 확인:
+  - `DOCS` HEAD `c1d9cc2`
+  - `SKILL.md`, `companyx_grounding_pipeline.md`가 코드 기준과 일치
+- 통합 테스트 완료 보고:
+  - `[24]_260323_통합테스트_완료_24codex.md`
+  - Company X 사용자 + marker 있음 → grounding 진입 PASS
+  - Company X 사용자 + marker 없음 → 일반 경로 PASS
+  - 비 Company X 사용자 + marker 있음 → 일반 경로 PASS
+  - 검색 0건 fallback 분기 → patch 기반 통합 호출 PASS
+
+## 결과
+
+- 현재 운영 기준은 `team_id 단독 진입`이 아니라 `team_id + marker`다.
+- 일반 질문은 grounding에 과잉 진입하지 않고, 문서 질문만 grounding으로 들어간다.
+- 문서 검색 결과가 0건이면 grounding 실패 응답으로 고정하지 않고 일반 경로로 되돌린다.
+
+## 관련 문서
+
+- [260321 하이브리드 검색 품질 개선 계획](../plans/260321_하이브리드검색_품질개선_계획.md)
+- [260322 검색 품질 2차 — 파일명 보조 검색 + 대화 맥락 전달](../plans/260322_검색품질2차_파일명보조검색_대화맥락전달_계획.md)
+- [Company X RAG LLM 판단 과보수 + 대화 맥락 미연결](../troubleshooting/260322_companyx_rag_LLM판단보수_대화맥락미연결.md)