update first - 84

2026-06-30 02:21:39 +09:00
commit 07ac1bdcdd
561 changed files with 88164 additions and 0 deletions
@@ -0,0 +1,97 @@
+# Kế hoạch: CASAN tự sinh vỏ theo dự án (closed-loop, đóng gói tái dùng)
+
+> Mục tiêu: biến CASAN từ "1 vỏ OKR cố định" thành **lõi tái dùng + vỏ tự sinh** cho mọi dự án, qua vòng lặp khép kín: Local AI sinh nháp → harness tự chấm → AI xịn review/vá → đóng gói. Dùng được ở 3 mức: ý tưởng, project có sẵn, vấn đề cần giải.
+
+---
+
+## 1. Tách lớp: lõi cố định vs vỏ tùy dự án
+
+| Lớp | Thành phần | Tính chất |
+|---|---|---|
+| **Lõi (casan-core)** | `security-check.sh`, `governance-check.sh`, `casan-harness.sh`, `drift-detect.sh`, `rollback-manager.sh`, `model-fallback.sh`, `verify-audit-chain.sh`, `tool-registry-gate.sh`, `pii-mask.py`, `hallucination-scan.py` | Project-agnostic, đóng gói versioned, KHÔNG sửa mỗi dự án |
+| **Vỏ (project-shell)** | `run-casan-pipeline.mjs`, `casan-step.mjs`, requirement, golden runs, agent stubs, policy yaml | Tự sinh theo dự án |
+
+Manifest điều khiển vỏ: `casan.config.yaml`
+```yaml
+feature-id: <id>
+tech-stack: <stack>
+steps: [srs, bd, spec, plan, review, dd, testkit, tasks, reviewcode]
+agents: { srs: ..., plan: ..., review: ... }
+golden: .specify/golden/
+thresholds: { H1:80, ..., H7:80 }
+```
+
+---
+
+## 2. Kiến trúc closed-loop
+
+```mermaid
+graph LR
+  IN[3 cổng vào: idea / repo / problem] --> SCAF[Local AI: sinh vỏ nháp]
+  SCAF --> RUN[casan-core: test+gate+audit] --> SCORE{mọi H>=ngưỡng?}
+  SCORE -->|no| REV[AI xịn: review+vá] --> RUN
+  SCORE -->|yes| PKG[casan-pack export] --> REG[(registry)]
+  REG --> REUSE[Dự án sau tái dùng]
+```
+
+- **Local AI** (rẻ): sinh nháp + vá vòng đầu, chạy nhiều lần.
+- **AI xịn** (đắt): chỉ vào khi local kẹt — sửa golden, siết policy, fix orchestration.
+- **Harness lõi**: trọng tài khách quan, chấm 7 điểm, không bịa.
+
+---
+
+## 3. Ba mức cổng vào
+
+| Mức | Input | Vỏ sinh ra | Golden |
+|---|---|---|---|
+| Ý tưởng | mô tả ngắn | SRS+spec+plan phác | sinh từ spec |
+| Project sẵn | repo | feature-inventory + pipeline | từ test thật |
+| Vấn đề | bug/yêu cầu | mini-pipeline 1 luồng | từ kỳ vọng |
+
+---
+
+## 4. Lộ trình 5 giai đoạn
+
+### GĐ1 — Tách lõi
+- Gom script agnostic → `casan-core/` versioned (semver).
+- Tạo template vỏ rỗng + `casan.config.yaml`.
+- Tiêu chí: chạy lõi không cần vỏ OKR.
+
+### GĐ2 — Local AI sinh vỏ
+- Sinh pipeline + agent stub + requirement + golden draft từ 1 trong 3 mức.
+- Tiêu chí: vỏ mới boot pipeline không lỗi cú pháp.
+
+### GĐ3 — Loop tự chấm
+- Chạy lõi → JSON điểm 7 harness; <ngưỡng → diff cho AI vá; lặp tới đạt.
+- Tiêu chí: loop dừng đúng khi ≥80 mọi harness.
+
+### GĐ4 — AI xịn review
+- Cổng escalate: local kẹt N vòng → AI xịn sửa golden/policy/orchestration.
+- Tiêu chí: token tiết kiệm, chỉ gọi khi cần.
+
+### GĐ5 — Đóng gói + tái dùng
+- `casan-pack export` → template + đăng ký registry.
+- Chứng minh dùng chéo ≥2 project (đóng gap H2 → tiến L5).
+
+---
+
+## 5. Cấu trúc gói đề xuất
+```
+casan-core/        # lõi versioned (không sửa)
+casan-shell-tpl/   # vỏ rỗng + casan.config.yaml
+casan-pack/        # CLI: init / scaffold / loop / review / export
+registry/          # gói dự án đã đóng + harness-version map
+```
+
+## 6. Rủi ro & ngưỡng dừng
+- Loop vô hạn → cap số vòng + escalate AI xịn.
+- Local AI golden ảo → bắt qua drift thật (so run trước, không tự-so).
+- Token đắt → local lo 80%, AI xịn chỉ chốt.
+
+## 7. Bước tiếp
+- [ ] Tách `casan-core` khỏi vỏ OKR
+- [ ] Viết `casan.config.yaml` mẫu
+- [ ] PoC local-scaffold 1 dự án mới
+- [ ] Loop tự chấm + escalate
+- [ ] `casan-pack export` + dùng chéo 2 project
+