KB-7B8C

Opus Assessment — Pack 2A Description/Birth Contract Discovery

4 min read Revision 1
iu-0pack-2adescriptionbirth-contractopus-assessment

Opus Assessment — Pack 2A Description/Birth Contract Discovery

Date: 2026-05-04 Input: iu0-pack2a-description-birth-contract-discovery.md rev 1

Agent report: PASS — 9/9 câu hỏi, evidence/interpretation/unknowns tách rõ

Phát hiện then chốt + Opus recommendation

1. governance_role = observed — CONFIRMED bằng evidence

Evidence:

  • Q2: fn_description_birth_guard auto-gen template CHỈ cho governance_role='governed' + empty description. Observed → không auto-gen, chỉ warn.
  • HC-SCHEMA: governed + thiếu cột description → CRITICAL. information_unit KHÔNG có cột description.
  • Q3: Convention cho observed: mô tả ngắn gọn chức năng + scope. Governed: mô tả + luật quản lý chi tiết hơn.

observed không phải "né luật" mà là trạng thái pilot/readiness hợp pháp. Nâng governed khi: (a) giải quyết IU description vs identity_profile, (b) species registration, (c) birth trigger deploy.

2. source_kind = pg_table — evidence từ Q7

Convention: bảng PG trực tiếp → primary hoặc pg_table. Nhưng Q7 tool whitelist chỉ cho registry|native|derived|policy, KHÔNG có pg_table dù DB có giá trị đó.

UNKNOWN — needs verify: nếu tool reject --source_kind pg_table vì ngoài whitelist, cần dùng giá trị nào? Likely native (closest semantic). Hoặc bỏ qua flag (để NULL).

3. migration_state = pilot — evidence rõ

Tool whitelist: unclassified|classified|pilot|stable. IU-0 rõ ràng là pilot. → pilot.

4. storage_role = primary — evidence từ Q7

Convention: governed/observed core tables → primary. Tool whitelist: primary|junction|log|system. information_unit = primary data table. unit_version = history table, có thể primary hoặc log. → Recommend cả 2 = primary.

5. description — theo Đ3 §A.3 Collection format

Form: [Vai trò governance]. Chứa [nội dung chính]. Lớp [Não/Kho/Cổng]. Thuộc [Luật]. [FK chính].

Đề xuất (Đ3 C1-C4 compliant: tiếng Việt có dấu, ≥30 chars, không gaming):

  • information_unit: [observed] Chứa đơn vị thông tin có version và birth gate 2 lớp. Lớp Kho. Thuộc Đ44 (IU-0 pilot). FK tới unit_version.
  • unit_version: [observed] Chứa lịch sử version cho information units, immutable per version. Lớp Kho. Thuộc Đ44 (IU-0 pilot). FK tới information_unit.

6. provenance: accept PROV-DOT — tool limitation, non-blocking

Q9: mọi collection_registry row đều PROV-DOT. Tool không có flag --description-provenance. Mở rộng tool = scope creep. Accept PROV-DOT cho DOT-channel writes, ghi nhận tech debt.

7. species: SKIP cho Pack 2A

Q6: không có IU species. Nhưng observed không yêu cầu species mapping (convention S128: chỉ governed cần species). Tạo species = scope creep. Skip, ghi nhận cho Pack khi nâng governed.

8. rollback: forward-only cho Pack 2A

Q5: không có unregister/rollback tool. Tạo tool mới = scope creep. Nếu registration sai → --update mode sửa. Nếu cần xoá hoàn toàn → design decision riêng, không thuộc Pack 2A.

Đề xuất bước tiếp

  1. GPT confirm 8 điểm trên (đặc biệt governance_role + source_kind unknowns)
  2. Opus soạn 12a (compile decisions) + patch file 12 rev2
  3. Sau GPT review 12 rev2 → dispatch Claude Code write

7 design decisions từ report — disposition

# Decision Opus recommendation Blocking Pack 2A?
1 Rollback strategy Forward-only, dùng --update nếu sai No
2 IU species Skip, chưa cần cho observed No
3 storage_role primary cho cả 2 No
4 Provenance mislabel Accept PROV-DOT, ghi tech debt No
5 Duplicate birth triggers Pre-existing tech debt, log No
6 law_artifact role Không dùng cho IU No
7 Tool whitelist gaps Pre-existing, không blocking No — nhưng source_kind cần verify
Back to Knowledge Hub knowledge/dev/laws/dieu44-trien-khai/reviews/opus-assessment-pack2a-description-birth-discovery-2026-05-04.md