CASAN/casan-tu-sinh-vo-theo-du-an.md

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

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

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