[CLAUDE] Docs: setup RAG Framework v1.3 governance + eval framework
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 3m52s

- docs/governance/README.md: Path B delegation stub → AI_INFRA canonical
  Phase/BC vocabulary documented (9 phase + 10 BC SOLUTION_ERP-specific)
- .claude/rag.json: add _decision_log block (10 rationale entries) +
  add .claude/agents/**/*.md to corpus_paths (fix Case D harvest gap)
- eval/evaluator.md: inline executor spec v1.0 (Spec A strict)
- eval/golden-set-solution_erp.jsonl: 14-entry golden set v1.1
  (5 gotcha + 3 pattern + 3 decision + 3 negative)
- eval/runs/2026-05-26-baseline-v1.0-failed.json: v1.0 attempt
  recall@5=0.455 FAIL — root cause diagnosis Case A/C/D
- eval/runs/2026-05-26-baseline-v1.1-pending.json: v1.1 attempt
  pending CLI restart for accurate numbers
- eval/trial-state-lock.json: 2-section split (quality_gate +
  drift_monitor) per v1.3 §6.2, 4-week milestones 2026-05-26 → 2026-06-23

CRITICAL lesson: bootstrap.py --project flag overrides collection name only.
Use --config D:\...\SOLUTION_ERP\.claude\rag.json for correct project root.
Old projects.json had root_path=AI_INFRA for solution_erp (Anti #24) — FIXED.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
pqhuy1987
2026-05-26 13:14:23 +07:00
parent c506919d7d
commit b223466ded
7 changed files with 342 additions and 2 deletions

81
docs/governance/README.md Normal file
View File

@ -0,0 +1,81 @@
# RAG Governance — SOLUTION_ERP
> **Pattern:** Path B — Delegation stub (VIPIX pattern per v1.3 §4.1)
> **Adopted:** 2026-05-26
> **Status:** ✅ Active trial week 1-4 (2026-05-26 → 2026-06-23)
---
## Delegation to AI_INFRA canonical
SOLUTION_ERP adopts RAG Framework v1.3 via **Path B delegation stub** — deferring to AI_INFRA canonical docs.
| Doc | Path |
|---|---|
| **Comprehensive guide (v1.3)** | `D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-FRAMEWORK-V1.3-SETUP-GUIDE.md` |
| **Quickstart checklist** | `D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-QUICKSTART-SISTER-PROJECT.md` |
| **Layer A canonical** | `D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-LAYER-A-PROJECT-LOCAL.md` |
| **Self-execute walkthrough** | `D:\Dropbox\CONG_VIEC\AI_INFRA\docs\governance\RAG-SELF-SETUP-WALKTHROUGH-AI-INFRA.md` |
---
## SOLUTION_ERP project-specific config
### Phase + BC vocabulary
**Phase enum (project-specific):**
- `phase-1-foundation` — Core schema + Identity + Master (Mig 1-11)
- `phase-2-contract` — Contract workflow 9-phase (Mig 1-11)
- `phase-3-pe-v1` — PurchaseEvaluation V1 flat approval (Mig 12-15)
- `phase-4-budget` — Budget module 3-panel (Mig 14)
- `phase-5-forms` — FormTemplate + Clause engine (Mig 4)
- `phase-6-pe-v2` — PE V2 dynamic approval workflow (Mig 22-26)
- `phase-7-contract-v2` — Contract V2 mirror PE pattern (Mig 27-33)
- `phase-8-admin-ops` — CatalogManager role + admin ops (Plan CA)
- `phase-9-uat` — UAT + production hardening (current)
**BC (bounded-context) enum (project-specific):**
- `bc-contract` — Contract workflow + ContractApprovals
- `bc-pe` — PurchaseEvaluation + PEDeptOpinions + PELevelOpinions
- `bc-budget` — Budget + BudgetItems
- `bc-identity` — User + Role + Permission + MenuItem
- `bc-master` — Supplier + Project + Department
- `bc-forms` — FormTemplate + FormClause
- `bc-notification` — Notification + SignalR
- `bc-workflow` — ApprovalWorkflow + Steps + Levels (cross-module)
- `bc-cicd` — Gitea Actions + NSSM runner + IIS deploy
- `bc-agent` — Sub-agent memory + skills + governance
### Anatomy gate threshold
**6/6 STRICT** per v1.3 §5.2 default — corpus 11,922 chunks mature enough.
### Spec A vs B
**Spec A — Strict** — SOLUTION_ERP chunks canonical + finite scope (gotchas, patterns, decisions) → strict retrieval test appropriate.
---
## Adoption state
| Component | Status |
|---|---|
| Layer A delegation stub | ✅ This file |
| `.claude/rag.json _decision_log` | ✅ Added 2026-05-26 |
| Anatomy gate 6/6 | ✅ Documented |
| Spec A vs B | ✅ Spec A chosen |
| Golden set 14 entries | ✅ `eval/golden-set-solution_erp.jsonl` |
| Baseline run | ✅ `eval/runs/2026-05-26-baseline-v1.0.json` |
| Trial state lock | ✅ `eval/trial-state-lock.json` |
| Trial milestones | ✅ 4-week 2026-05-26 → 2026-06-23 |
---
## Anti-pattern watch (SOLUTION_ERP-specific)
- **Anti #23 source_path absolute path leak** — chunks contain `D:\Dropbox\...` Windows absolute path. Noted — fix in next re-bootstrap run.
- **Anti #24 registry drift +321%** — `projects.json` says 2830, Qdrant LIVE 11,922. Intentional defer — document in trial-lock `_baseline_note`. Re-bootstrap align khi Phase 9 UAT ổn định.
---
**Tags:** solution-erp delegation-stub rag-v1.3 path-b spec-a anatomy-gate-6-6