[CLAUDE] Docs: setup RAG Framework v1.3 governance + eval framework
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 3m52s
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:
81
docs/governance/README.md
Normal file
81
docs/governance/README.md
Normal 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
|
||||
Reference in New Issue
Block a user