72bbfa56a5
- Install 3 federated adoption slash-commands (/adap-apply|report|request) in .claude/commands/ (read AI_INFRA outbox read-only, apply own repo, write adap-report; AI_INFRA /adap-audit reads cross-repo) - Broadcast #1 (Memory-store-memory-strip-global): strip store_memory from all 8 sub-agents -> lead = sole RAG-writer; 4 RAG-read retained; agents/README synced + G-015 note - Broadcast #2 (Agent-frontend-designer-floor): frontend-designer 8th agent (pink) -- forked AI_INFRA canonical FD1-FD10 visual-verification floor, tailored SE stack + use-existing-DS + boundary vs implementer-frontend; memory seed; roster doc 7->8 - Broadcast #3 (Governance-gov-v2): already-applied S44 -- delta report (gap: no formal error-ledger/L.b checklist) - 3 adap-reports (5-field LOCK) in docs/governance/adap-reports/ + adoption-ledger row - All nac executed-file/verified-pending (restart + spawn-test). 0 agents spawned. No product code. Test gate 181 unchanged. CI-skip (all .md). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
94 lines
4.7 KiB
Markdown
94 lines
4.7 KiB
Markdown
# 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 **~2,409 chunks** (post-S41 cleanup 2026-05-29; was 11,922 pre-cleanup inflated) 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** — ✅ resolved S41 re-bootstrap (2026-05-29): node_modules/_archive excluded, slug fixed. Some `(manual)` store_memory chunks retain absolute path (cosmetic, non-blocking).
|
||
- **Anti #24 registry drift +321%** — ✅ resolved S41: re-bootstrap host-side `--config` → Qdrant **2,406** (−674 junk), registry aligned. (Was: projects.json 2830 / Qdrant LIVE 11,922 inflated.) ⚠️ `eval/trial-state-lock.json` baseline still cites old number → AI_INFRA to reconcile.
|
||
|
||
---
|
||
|
||
## Cross-Project Adoption Ledger (AI_INFRA bundles)
|
||
|
||
| Bundle date | Adopted | Evidence |
|
||
|---|---|---|
|
||
| **2026-05-29** (charter v2 / tiered-mem / session-cmd / RAG v1.3) | 4/4 | `6f08d1f` (Tiered Memory v1) + `c8ff5e1` (/session-start /session-end) · RAG re-bootstrap 3080→2406 |
|
||
| **2026-06-01** (RAG T1/T2 · Gov-v2 · hygiene · session-cmd #4) | §A auto · §B align · §C wording ×7 · §D #4 step · §E/§F · ✅ **VERIFIED 2-way** (AI_INFRA RT3 confirm) | S44 audit (docs-only) — chain `ae30f8f→071c25c` tree-clean — [`BROADCAST-OUT-SOLUTION-ERP-2026-06-01.md`](BROADCAST-OUT-SOLUTION-ERP-2026-06-01.md) |
|
||
| **2026-06-02** (adap-* channel + Memory-strip + frontend-designer + Gov-v2 re-confirm) | 3-cmd channel installed · #1 strip `store_memory` 8 subs (lead=sole RAG-writer) · #2 frontend-designer 8th agent ADOPT · #3 Gov-v2 already-S44 delta | S47 — `docs/governance/adap-reports/` 3 files (5-field LOCK) · nấc **executed / verified-pending restart** (spawn-test FD2) · AI_INFRA `/adap-audit` reads cross-repo |
|
||
|
||
**Cadence #4 (self-sustaining):** `/session-end` Phase 6.3 auto-generates §E adoption-report when infra adopted → em main `/session-start` next watches + double-checks (2-way loop).
|
||
|
||
---
|
||
|
||
**Tags:** solution-erp delegation-stub rag-v1.3 path-b spec-a anatomy-gate-6-6 adoption-ledger
|