[CLAUDE] Docs: chốt Session 21 turn 2 — RAG Hybrid setup planning + Cách A validation

Sau S21 turn 1 chốt cicd-monitor, bro clarify 5 dự án future > 1M MD tokens → discussion deep ~15 turn về RAG infrastructure. Em main solo (no SOLUTION_ERP sub-agent spawn), delegate claude-code-guide × 2 research Anthropic + community practice.

Quyết định chốt:
- Cách A defensive (giữ blanket 120K em main + RAG retrieve supplement)
- Bỏ Cách B aggressive (cắt 60-70% blanket) — vi phạm priority em main control flow strong
- Industry-validated cross 4 Anthropic blog + 5 community tools (Cursor/Continue/Cline/Aider all hybrid)
- 3-layer pattern Phase 1-3 incremental rollout (vector → +BM25 → +reranking, recall ~70% → ~92%)
- Stack: Voyage-3-large + Qdrant local + FastMCP Python + Streamlit dashboard

Multi-agent cost reality clarify (post-S21 t2):
- Em main blanket: ~120K
- 4 sub-agents spawn cumulative: ~400K
- Total billed heavy session: ~560K Cách A vs ~700K lazy
- Saving -20% từ multi-agent shared cache 70-90%
- Anthropic acknowledge 8-10× multiplier multi-agent

Files updated:
- docs/STATUS.md (Last updated S21 turn 2 + Recently Done row top)
- docs/HANDOFF.md (TL;DR Session 21 turn 2 section + Last updated)
- docs/rag-setup-plan.md (+Section 13 multi-agent cost reality + Section 14 3-layer hybrid Phase 1-3, +355 LOC)
- docs/changelog/sessions/2026-05-12-1800-s21-turn2-rag-planning.md (new session log)

Memory user-level update (outside repo, separate update):
- feedback_rag_hybrid_pattern.md (NEW cross-project pattern reusable)
- MEMORY.md index (+1 entry pointer)

Plan I NEW deferred — trigger bro confirm 5 dự án path + stack + pilot + Voyage API + disk cleanup → dedicated session 10-14h weekend (per feedback_drastic_refactor_scope rule).

Stats:
- 17 memory entries (+1 RAG hybrid)
- 1 plan file rag-setup-plan.md (1500 LOC final)
- 4 sub-agents seeds-only unchanged
- 81 test unchanged
- 4 commits S21 cumulative (f1c61c9 + 3a34831 + 1f8e9af + this)

CI skip per path filter (all .md).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

docs/HANDOFF.md

@@ -1,6 +1,112 @@
 # HANDOFF — Brief 5 phút cho session tiếp theo
 
-**Last updated:** 2026-05-12 (Session 21 turn 1 — **🎯 Add con thứ 4 cicd-monitor (Path A — post-deploy verifier). 1 commit `f1c61c9` pushed `36e21c8..f1c61c9 main -> main`. CI skipped per path filter (3 file `.md`). Cost reality update: ~750K spawn (3 → 4 agents) · ~1.35M heavy / ~700K optimized. Stats: 4 sub-agents seeds-only · 16 memory · 27 mig · 59 tables · ~142 endpoints · 81 test · 44 gotcha · 6 skills unchanged. KHÔNG flush 3 agent MEMORY.md (chưa spawn work — em main solo). Trial Week 1 kick-off S21 turn 2+ Plan B Contract V2 wire mirror PE pattern.**)
+**Last updated:** 2026-05-12 (Session 21 turn 2 — **🎯 RAG Hybrid setup planning + Cách A validation deep dive. 2 commit (`1f8e9af` plan save 1223 LOC + this chốt). KHÔNG implement, plan only — defer chờ bro confirm 5 dự án future. Decision chốt: Cách A defensive (giữ blanket 120K em main + RAG retrieve) over Cách B aggressive (cắt 60-70% blanket). Industry-validated cross 4 Anthropic blog + 5 community tools (Cursor/Continue/Cline/Aider). Stack: Voyage-3-large + Qdrant + FastMCP + Streamlit dashboard. Multi-agent cost reality: 4 agents → ~520K cumulative blanket → heavy session ~560K (Cách A) vs ~700K (lazy). 3-layer pattern Phase 1-3 rollout (embeddings + BM25 + reranking, ~70% → ~92% recall). Stats: +1 memory entry (`feedback_rag_hybrid_pattern`) +1 plan file (`rag-setup-plan.md` 1500 LOC). Sub-agents vẫn 4 seeds-only, em main solo session.**)
+**S21 turn 1:** 2026-05-12 0030 (Session 21 turn 1 — **🎯 Add con thứ 4 cicd-monitor (Path A — post-deploy verifier). 1 commit `f1c61c9` pushed `36e21c8..f1c61c9 main -> main`. CI skipped per path filter (3 file `.md`). Cost reality update: ~750K spawn (3 → 4 agents) · ~1.35M heavy / ~700K optimized. Stats: 4 sub-agents seeds-only · 16 memory · 27 mig · 59 tables · ~142 endpoints · 81 test · 44 gotcha · 6 skills unchanged. KHÔNG flush 3 agent MEMORY.md (chưa spawn work — em main solo). Trial Week 1 kick-off S21 turn 2+ Plan B Contract V2 wire mirror PE pattern.**)
+
+## TL;DR Session 21 turn 2 — RAG Hybrid setup planning (Cách A chốt + 3-layer pattern)
+
+User clarify 5 dự án future > 1M MD tokens → cuộc thảo luận deep ~15 turn về RAG infrastructure. Em main solo (no SOLUTION_ERP sub-agent spawn), delegate 2 lần claude-code-guide agent research Anthropic + community practice.
+
+### Q&A deep dive 10 topics
+
+1. RAG fundamentals + Vector DB role (Qdrant)
+2. Embedding "AI nhúng" + Voyage AI cost mechanics ($0.18/M tokens)
+3. Multi-project shared architecture (5 projects → single Qdrant + per-collection)
+4. Audit procedure 3-tier (weekly auto + monthly deep + quarterly major)
+5. UI/UX Streamlit dashboard 7 pages design
+6. Cách A defensive (giữ blanket 120K) vs Cách B aggressive (cắt 60-70%)
+7. Reasoning depth comparison: lazy 60% → A 90% → B 75-80%
+8. Industry validation: Anthropic + Cursor + Continue + Cline + Aider all hybrid
+9. Multi-agent cost reality: 8-10× multiplier, ~520K cumulative blanket 5 entities
+10. 3-layer hybrid pattern (Anthropic Contextual Retrieval Sept 2024)
+
+### Quyết định chốt — Cách A vs Cách B
+
+**Chọn Cách A** (defensive hybrid):
+- Blanket: GIỮ NGUYÊN 120K em main + RAG retrieve supplement
+- Sub-agent spawn baseline: ~80-100K each (4 agents = ~400K cumulative)
+- Heavy session billed: ~560K (saving -20% vs lazy 700K)
+- Quality recall: ~85% (vs Cách B 75-80% do fragmentation)
+
+**Why Cách A** (bro priority chốt):
+- ✅ Em main control flow strong (state ownership direct, response fast)
+- ✅ Decision quality 90% (multi-source cohesive reasoning)
+- ✅ Wall-clock per task -20% (12 phút vs Cách B 16 phút)
+- ✅ Risk-averse (graceful fallback blanket nếu RAG fail)
+- ✅ Multi-agent leverage cache 70-90% hit common queries
+- ✅ Industry-validated (Anthropic + Cursor + Continue + Cline + Aider)
+
+### 3-layer hybrid Phase rollout (Anthropic Contextual Retrieval)
+
+| Phase | Layers | Recall | Cost/mo |
+|---|---|---|---|
+| Phase 1 (Week 1-4) | Vector embedding only (Voyage-3-large) | ~70% | ~$1.50 |
+| Phase 2 (Month 2) | + BM25 hybrid (bm25s free local) | ~78% | ~$1.50 |
+| Phase 3 (Month 3) | + Voyage rerank-2 + Contextual prefix | ~92% | ~$4-5 |
+
+### Stack validated cross-industry
+
+- Voyage AI embedding (Anthropic partner, multilingual 26 lang)
+- Qdrant local (Rust binary, "leading agent memory backend 2026")
+- FastMCP Python (official Anthropic SDK)
+- SQLite event log + Streamlit dashboard 7 pages
+- Pre-commit hook re-index delta
+
+### Multi-agent cost reality (Anthropic warn 8-10× multiplier)
+
+```
+Per entity blanket Cách A:
+  Em main: ~120K
+  4 sub-agents × ~100K spawn = 400K cumulative
+  Total: ~520K cumulative billed (not single context window)
+
+Heavy session 4-agent spawn:
+  Lazy: ~700K effective billed
+  Cách A: ~560K (-20% from multi-agent shared cache)
+```
+
+### Plan I NEW — RAG Setup Implementation (defer)
+
+**Trigger:** Bro confirm 5 dự án path + stack + pilot choice + Voyage API key + disk cleanup 5-8GB.
+
+**Schedule:** Dedicated session 10-14h weekend (per `feedback_drastic_refactor_scope`).
+
+**Phase rollout:**
+- Phase 1 single project pilot 4-week trial
+- Phase 2-3 upgrade incremental conditional on Phase 1 success
+- Cost realistic: ~$2-5/month total cho 5 projects
+
+### Deliverables
+
+- ✅ `docs/rag-setup-plan.md` (commit `1f8e9af` 1223 LOC + extend S21 t2 ~300 LOC = ~1500 LOC final)
+- ✅ Memory `feedback_rag_hybrid_pattern.md` (NEW cross-project reusable)
+- ✅ MEMORY.md index +1 entry
+- ✅ Session log this chốt
+- ⏭ Implementation defer chờ trigger
+
+### Em main solo S21 turn 2 (no SOLUTION_ERP sub-agent spawn)
+
+3 spawn này session — KHÔNG phải 4 SOLUTION_ERP sub-agents:
+- claude-code-guide × 2 (generic agent for Anthropic + industry research)
+- 4 SOLUTION_ERP sub-agents (Inv/Imp/Rev/CICD) vẫn seeds-only
+
+### State chốt S21 turn 2
+
+| Metric | Trước | Sau | Δ |
+|---|---|---|---|
+| DB tables | 59 | 59 | 0 |
+| Migrations | 27 | 27 | 0 |
+| Endpoints | ~142 | ~142 | 0 |
+| FE pages | 34 | 34 | 0 |
+| Unit tests | 81 | 81 | 0 |
+| Gotchas | 44 | 44 | 0 |
+| **Memory entries** | 16 | **17** | **+1** (RAG hybrid pattern) |
+| Skills | 6 | 6 | 0 |
+| Sub-agents | 4 seeds-only | 4 seeds-only | 0 |
+| **Commits S21 cumulative** | 2 | **4** | **+2** |
+| **Plan files** | 0 | **1** (`rag-setup-plan.md`) | **+1** |
+
+---
 
 ## TL;DR Session 21 turn 1 — Add cicd-monitor (4th sub-agent, Path A chốt)