KB-1156 rev 4

Mission Template v5.0 — +§0-AW Automation Checklist

4 min read Revision 4
mission-templatessotv5.0automation§0-AW

Mission Template — Agent Operating Procedure (v5.0)

EVERY mission MUST follow this template. No exceptions. v5.0: +§0-AW Automation Checklist BẮT BUỘC. +CẤM --admin, +CẤM manual deploy, +1 PR/1 commit, +test local.


Step 0: CHECKPOINT BẮT BUỘC (S135H pattern)

Nếu Step 0 bị bỏ qua → mission INVALID. Không có ngoại lệ.

Before ANY code or action:

  1. Read Operating Rules: search_knowledge("operating rules SSOT")Quote nguyên văn dòng "v5.xx" đầu tiên để chứng minh đã đọc.
  2. Read .claude/skills/incomex-rules.mdQuote dòng merge rule để chứng minh đã đọc.
  3. Quote VERIFY NUXT rule: Quote "Nuxt URL:" format.
  4. Assembly Gate 6 câu: Trả lời Q0-Q5.
  5. Search existing solutions: search_knowledge("<topic>") — Assembly First.

Thiếu BẤT KỲ quote nào → mission INVALID.


MERGE + DEPLOY RULES (ĐỌC TRƯỚC MỌI THỨ)

4 required GREEN = MERGE NGAY. Lệnh: gh pr merge [PR] --squash --delete-branch. TUYỆT ĐỐI CẤM:

  • --admin hoặc bypass branch protection (§0-AB)
  • Manual deploy khi auto-deploy hoạt động (§0-AD)
  • Push commit lẻ — gộp vào 1 commit (§CODE DISCIPLINE)
  • Dùng CI làm debugger — test local TRƯỚC push

Queued → ĐỢI. FAIL → DỪNG, fix, amend+force-push. TỐI ĐA 1 PR. Sửa lắt nhắt nhiều vòng CI = LÃNG PHÍ thời gian user.


Step 1: Plan

  • Describe what you will do
  • List files to modify
  • Identify risks

Step 2: Execute

  • Test local: cd web && npx nuxt build — PHẢI pass.
  • Gộp tất cả vào 1 commit. git commit --amend nếu cần sửa.
  • Push 1 lần. KHÔNG push từng fix lẻ.

Step 3: CI GREEN + Merge

  • 4 required GREEN → merge. KHÔNG đợi non-blocking.
  • CẤM --admin. CẤM manual deploy.

Step 4: VERIFY NUXT (★★★ BẮT BUỘC)

Bước này KHÔNG THỂ BỎ QUA. Thiếu = report bị từ chối.

Format BẮT BUỘC:

VERIFY NUXT:
- Nuxt URL: [url thực]
  [Mục]: hiện [giá trị]. PG: [giá trị]. KHỚP/SAI.

Step 4.5: §0-AW AUTOMATION CHECKLIST (★★★ BẮT BUỘC — v5.0)

Thiếu bước này = mission CHƯA DONE dù chức năng đã chạy.

Trả lời 3 câu:

§0-AW AUTOMATION CHECK:
1. Feature chạy TỰ ĐỘNG chưa? [CÓ/KHÔNG]. Nếu KHÔNG → phải fix trước DONE.
2. DUAL-TRIGGER (cron + on-demand) cho mỗi automation? [CÓ/KHÔNG]. Chi tiết:
   - [tên feature]: cron=[có/không, tần suất], on-demand=[có/không, endpoint].
3. Chuỗi dữ liệu end-to-end liền mạch? PG → Directus → Nuxt UI tự cập nhật? [CÓ/KHÔNG]. Nếu KHÔNG → chỗ nào đứt?

Step 5: Report

Upload tại: knowledge/current-state/reports/[session]-report.md

Report PHẢI có: Step 0 quotes, "Local build: PASS", "PRs: 1", "Manual deploys: 0", VERIFY NUXT section, §0-AW Automation Check section. Thiếu = BỊ TỪ CHỐI.


Checklist trước khi báo COMPLETE

# Kiểm tra
1 Step 0 quotes đầy đủ?
2 Local build PASS trước push?
3 1 PR, 1 commit?
4 CI GREEN (không --admin)?
5 0 manual deploy?
6 VERIFY NUXT section đầy đủ?
7 §0-AW: Feature tự động? DUAL-TRIGGER? Chuỗi liền mạch?
8 Report uploaded?