spec-gate-build

# SEOSONA — Spec → Gate → Build → Verify Nguyên tắc chủ đạo của toàn hệ: **"AI quyết NỘI DUNG · code deterministic dựng PIXEL"** + không làm-một-phát. Áp cho mọi thứ có cấu trúc (workflow, pipeline gen, trang, asset-set). ## 4 bước (làm đủ, không nhảy cóc) ### 1. SPEC — viết đặc tả JSON cô đọng TRƯỚC - Mục tiêu (1 câu), đầu ra mong đợi, ràng buộc, **out-of-scope** (nêu rõ cái KHÔNG làm). - Với workflow: `{name, category_id, nodes:[{type,data}], edges}` đúng catalog (skill seosona-workflow-architect). - Spec là hợp đồng — mọi bước sau chiếu về nó. ### 2. GATE — validate spec TRƯỚC khi build - Kiểm spec đủ/hợp lệ chưa; thiếu thì HỎI hoặc giả định-ghi-rõ, KHÔNG build vội. - Với workflow: `wf-framework/cli.js validate` = 0 error. Với gen: prompt đủ neo? provider hợp? chi phí ước lượng (CostEstimator) chấp nhận được? - Gate FAIL → sửa spec, chưa build. ### 3. BUILD — làm từng PASS deterministic, nhỏ - Chia thành pass độc lập (blockout → chi tiết → hoàn thiện), mỗi pass 1 trách nhiệm. - Ưu tiên code/công cụ deterministic cho phần "dựng pixel/cấu trúc"; để model lo phần "quyết nội dung". - Idempotent: làm lại 1 pass không phá pass khác (đổi copy chỉ re-render overlay, không sinh lại ảnh). ### 4. VERIFY — visual/LLM-diff, token CHỈ cho phán xét - Đối chiếu kết quả từng pass với SPEC bằng 1 lượt review (skill image-qa cho ảnh; validate cho workflow). - Pre-filter rẻ trước (JS: blur/black-frame/dup, byte-check) → chỉ gọi model/vision cho phần cần phán xét. - Lệch spec → quay lại BUILD (hoặc SPEC nếu sai gốc). Lặp tới khi diff pass. ## Output contract 1. **SPEC** (JSON/bullet cô đọng) + out-of-scope. 2. **Kết quả GATE** (0 error / các giả định). 3. **Các PASS** đã build (mỗi pass = 1 đơn vị verify được). 4. **VERIFY**: diff vs spec + verdict; nếu chưa đạt → pass nào làm lại. ## Cấm - Build khi chưa qua GATE. - Khẳng định "xong/chạy được" khi chưa VERIFY. - Gộp nhiều bước vào 1 pass không verify được. - Tốn token model cho việc code làm được (đo/so/gate).