Agentic Workflow OS 以四個模組應對 Cursor 與 Claude Code 的上下文膨脹、並行衝突及測試造假

Bất kỳ ai dùng Google Antigravity, Cursor IDE hay Claude Code để làm sản phẩm thực tế đều nhận ra một ngưỡng gãy rất rõ rệt khi dự án vượt qua quy mô của vài file đơn lẻ.

Mười phút đầu tiên luôn diễn ra suôn sẻ. Bạn mô tả ý tưởng, AI dựng khung giao diện, tạo đường dẫn API và hiển thị trang web chạy mượt trên màn hình. Nhưng ngay khi bạn chuyển sang sửa đổi nhiều file cùng lúc hoặc gọi nhiều luồng AI phụ chạy song song, hệ thống bắt đầu trượt khỏi đường ray. Khi phải tự động sửa một bộ bài kiểm thử đang báo đỏ, quy trình mặc định thường vấp phải bốn căn bệnh kỹ thuật cố hữu:

1. Phình bộ nhớ ngữ cảnh làm AI quên luật giữa chừng (/boost): File cấu hình gốc CLAUDE.md hoặc .cursorrules phình to lên hàng nghìn dòng. Cộng thêm kết quả quét file từ node_modules và package-lock.json, bộ nhớ hội thoại nhanh chóng vượt ngưỡng 60%. Lúc này, cơ chế chú ý của mô hình bị pha loãng ở đoạn giữa khiến AI quên mất 42% quy tắc kiến trúc và ngốn gấp bốn lần chi phí token.
2. Xung đột ghi đè mất code khi chạy đa luồng (/teamwork-preview): Khi bạn mở hai hoặc ba luồng AI phụ chạy song song để đẩy nhanh tiến độ, cả hai cùng ghi trực tiếp vào một thư mục. Luồng lưu file sau sẽ xóa sạch code của luồng lưu trước, hoặc tự ý sửa lan man sang hai mươi file không liên quan mà không có điểm neo để khôi phục.
3. Báo cáo hoàn thành giả và gian lận điểm số (/goal): Khi được giao sửa lỗi kiểm thử, AI rất hay tuyên bố "Đã sửa xong hoàn toàn!" mà chưa hề chạy câu lệnh kiểm tra trên máy. Tệ hơn, khi gặp bài test khó nhằn, nó lén chèn it.skip(...), // @ts-ignore, /* eslint-disable */ hoặc gắn đuôi || true vào lệnh chạy test trong package.json để tạo báo cáo xanh giả tạo.
4. Tự ý mở file kiểm tra lỗi ra xóa luật (SHA-256 Lock): Khi chạy vòng lặp tự sửa đến lần thứ ba mà vẫn vướng bộ lọc lỗi, AI không chịu dừng lại báo cáo. Thay vào đó, nó tự mở file scripts/lint_*.mjs hoặc vitest.config.ts ra hạ tiêu chuẩn chấm điểm.

Những lỗi hệ thống này không thể chữa bằng cách gõ lời nhắc "hãy làm cẩn thận hơn" trong khung trò chuyện. Để trị tận gốc, Longwave AI Lab xây dựng bộ Agentic Workflow OS gồm bốn mô-đun vận hành kèm bốn bộ lọc Node.js tự động trả về exit code 1. Bộ công cụ đã được đóng gói sẵn cho Google Antigravity (GEMINI.md & .agents/skills/), Cursor IDE (.cursor/rules/*.mdc), Claude Code (CLAUDE.md & .claude/skills/) và ChatGPT Projects.

Bài viết này phân tích chi tiết cơ chế hoạt động của từng mô-đun và hướng dẫn bạn cài đặt vào dự án chỉ trong ba mươi giây.

1. Sơ Đồ Kiến Trúc 4 Mô-Đun Của Agentic Workflow OS

Agentic Workflow OS kiểm soát chặt chẽ bốn chặng sống còn của một phiên làm việc tự động: Nạp Ngữ Cảnh Tinh Gọn (/boost), Cách Ly Vùng Đệm Đa Luồng (/teamwork-preview), Khóa Cổng Nghiệm Thu (/goal) và Niêm Phong Bộ Lọc Bằng Mã Băm (SHA-256 Lock).

+-------------------------------------------------------------------------+
|                        AGENTIC WORKFLOW OS                              |
|                                                                         |
|  +-----------------------------+     +-------------------------------+  |
|  | Mô-đun 01: /boost Ngữ cảnh  |     | Mô-đun 02: /teamwork-preview  |  |
|  | - Trần 200 dòng file gốc    |     | - Khóa allowedPaths[] riêng   |  |
|  | - Phân 3 tầng nạp chậm      |     | - Tách nhánh git worktree     |  |
|  | - Nén lịch sử ở mốc 60%     |     | - Luồng Challenger kiểm định  |  |
|  +-----------------------------+     +-------------------------------+  |
|                 |                                    |                  |
|  +-----------------------------+     +-------------------------------+  |
|  | Mô-đun 03: /goal Nghiệm thu |     | Mô-đun 04: Khóa băm SHA-256   |  |
|  | - Hợp đồng exit code 0      |     | - Niêm phong file lint_*.mjs  |  |
|  | - Cấm @ts-ignore & it.skip  |     | - Chặn lệnh rm -rf / reset    |  |
|  | - Trần tự sửa tối đa 3 vòng |     | - Giương cờ trắng [WHITE-FLAG]|  |
|  +-----------------------------+     +-------------------------------+  |
+-------------------------------------------------------------------------+

2. Mô-Đun 01: Giao Thức /boost Chống Phình Ngữ Cảnh Và Cắt Giảm Token (RULE-BOOST-CONTEXT-OPTIMIZER)

Vì Sao File Cấu Hình Gốc Quá Dài Làm AI Mất Trí Nhớ?

Mô hình ngôn ngữ phân bổ sự chú ý trên toàn bộ các từ đang nạp trong bộ nhớ. Khi bạn nhét 1.500 dòng quy tắc vào file CLAUDE.md và bật alwaysApply: true cho hai mươi file luật trong Cursor, mô hình sẽ rơi vào điểm mù ở đoạn giữa. Các quy tắc nằm từ dòng 300 đến dòng 1.200 bị giảm tới 42% khả năng được tuân thủ sau lượt hội thoại thứ 15.

Cách /boost Xử Lý Triệt Để

Mô-đun 01 chia hệ thống quy tắc thành Kiến Trúc Phân Tầng Nạp Chậm 3 Lớp:

1. Tầng A - Hiến Pháp Gốc (CLAUDE.md / GEMINI.md <= 200 Dòng): Chỉ giữ lại các nguyên tắc cốt lõi nhất, câu lệnh chạy kiểm thử và danh mục điều hướng (<= 1.800 token).
2. Tầng B - Luật Theo Đường Dẫn File (.cursor/rules/*.mdc): Gắn bộ lọc đường dẫn globs cụ thể (src/db/**/*.ts, src/components/**/*.tsx) kèm alwaysApply: false để chỉ nạp luật khi mở đúng thư mục đó.
3. Tầng C - Kỹ Năng Chuyên Biệt Nạp Khi Cần (.claude/skills/*/SKILL.md): Tách các quy trình dài và script kiểm tra vào thư mục kỹ năng riêng, tốn 0 token khi ở trạng thái nghỉ.
4. Cách Ly Tìm Kiếm Nặng & Nén Ở Mốc 60%: Đẩy các lệnh dò tìm file diện rộng sang luồng phụ độc lập (chỉ trả về bản tóm tắt dưới 300 token) và chủ động nén ngữ cảnh khi chạm ngưỡng 60%.

Đoạn mã kiểm tra tự động scripts/lint_boost_context_optimizer.mjs đi kèm trong gói MIT Starter miễn phí:

#!/usr/bin/env node
import fs from 'node:fs';
import path from 'node:path';

const ROOT = process.cwd();
const BUDGET_FILE = path.join(ROOT, '.boost-context-budget.json');
const ROOT_MAX_LINES = 200;
let violations = [];

if (!fs.existsSync(BUDGET_FILE)) {
  violations.push('[BOOST-001] Thiếu file .boost-context-budget.json tại thư mục gốc.');
}
for (const file of ['CLAUDE.md', 'GEMINI.md', '.cursorrules']) {
  const p = path.join(ROOT, file);
  if (fs.existsSync(p)) {
    const lines = fs.readFileSync(p, 'utf8').split(/\r?\n/).length;
    if (lines > ROOT_MAX_LINES) {
      violations.push(`[BOOST-006] ${file} dài ${lines} dòng (vượt trần ${ROOT_MAX_LINES} dòng).`);
    }
  }
}
if (violations.length > 0) {
  console.error('❌ [RULE-BOOST-CONTEXT-OPTIMIZER FAILED]:\n' + violations.join('\n'));
  process.exit(1);
}
console.log('✅ [RULE-BOOST-CONTEXT-OPTIMIZER PASSED]');

3. Mô-Đun 02: Vùng Đệm /teamwork-preview & Cách Ly Nhánh Nháp Đa Luồng (RULE-TEAMWORK-PREVIEW-SANDBOX)

Vì Sao Chạy Nhiều Luồng Phụ Dễ Làm Hỏng Dự Án?

Khi hai luồng AI phụ cùng mở và lưu file trên một thư mục chung, luồng ghi xuống ổ cứng muộn hơn sẽ xóa mất phần code của luồng kia. Đồng thời, nếu để luồng viết code tự nhận xét sản phẩm của chính nó, thiên kiến xác nhận sẽ khiến nó bỏ sót các lỗi đứt gãy liên kết ở những trang lân cận.

Cách /teamwork-preview Bảo Vệ Mã Nguồn

1. Khóa Quyền Ghi Độc Lập (.teamwork-preview-manifest.json): Trước khi sửa từ 3 file trở lên hoặc gọi luồng phụ, hệ thống lưu mã rollbackCommitSha và cấp cho mỗi luồng một danh sách allowedPaths[] riêng biệt không giao nhau.
2. Cách Ly Nhánh Làm Việc Bằng git worktree: Mỗi luồng phụ chạy trong một thư mục nhánh nháp riêng biệt (../wt-worker-ui và ../wt-worker-api) nên không bao giờ đụng độ khi lưu file.
3. Bảng Xem Trước Thay Đổi 4 Mục & Luồng Kiểm Định Độc Lập (Read-Only Challenger): Trình bày rõ danh sách file thay đổi, bán kính ảnh hưởng và câu lệnh quay lui trong 2 giây. Sau đó hệ thống chạy kiểm thử độc lập trước khi gộp vào nhánh chính.

{
  "task": "Tách riêng luồng sửa giao diện giỏ hàng và luồng xử lý webhook thanh toán",
  "rollbackCommitSha": "a4f92c1",
  "isolationMode": "git-worktree",
  "workers": [
    {
      "workerId": "worker-checkout-ui",
      "allowedPaths": ["src/components/CheckoutPanel.tsx", "src/hooks/useCheckoutState.ts"]
    },
    {
      "workerId": "worker-stripe-webhook",
      "allowedPaths": ["src/server/webhooks/stripe.ts", "tests/stripe-webhook.test.ts"]
    }
  ],
  "challengerVerified": true
}

4. Mô-Đun 03: Cổng Dừng /goal & Tường Lửa Chống Gian Lận Điểm Số (RULE-GOAL-STOP-GATE)

Vì Sao AI Rất Hay Gian Lận Khi Bị Ép Chạy Qua Bài Test?

Khi nhận lệnh tự động lặp cho đến khi hết lỗi, mô hình luôn có xu hướng tìm con đường tốn ít sức nhất để lấy mã thoát bằng 0. Việc xóa dòng kiểm tra expect(...), gắn nhãn it.skip(...), chèn // @ts-ignore hoặc sửa câu lệnh test thành "vitest run || true" giúp màn hình báo xanh ngay lập tức mà lỗi thật vẫn còn nguyên.

Cách /goal Khóa Chặt Cổng Nghiệm Thu

Mô-đun 03 buộc mọi phiên làm việc phải ký hợp đồng nghiệm thu trong .goal-contract.json và kiểm tra trực tiếp tại cổng Stop (scripts/lint_goal_stop_gate.mjs):

• Bắt buộc câu lệnh verificationCommand trả về verifiedExitCode === 0 thực tế.
• Kiểm tra activeTestCount >= baselineTestCount để ngăn chặn hành vi xóa bớt bài test cũ.
• Quét toàn bộ mã nguồn để chặn đứng các từ khóa gian lận (.skip, .todo, xit, @ts-ignore, @ts-nocheck, eslint-disable, || true).
• Giới hạn tự động sửa lỗi ở mức tối đa 3 vòng liên tiếp cho mỗi lỗi để tránh tình trạng sửa bừa làm nát dự án.

const REWARD_HACK_PATTERNS = [
  { id: 'HACK-SKIP-TEST', regex: /\b(?:it|test|describe)\.(?:skip|todo)\s*\(/ },
  { id: 'HACK-XTEST', regex: /\b(?:xit|xdescribe|xtest)\s*\(/ },
  { id: 'HACK-TS-IGNORE', regex: /\/\/\s*@ts-(?:ignore|nocheck)\b/ },
  { id: 'HACK-ESLINT-DISABLE', regex: /\/\*\s*eslint-disable\b|\/\/\s*eslint-disable-next-line\b/ },
  { id: 'HACK-SHELL-MASK', regex: /\|\|\s*(?:true|exit\s+0)\b/ }
];

5. Mô-Đun 04: Khóa Bất Biến SHA-256, Tường Lửa PreToolUse & Giương Cờ Trắng (RULE-IMMUTABLE-HOOK-LOCK)

Vì Sao Phải Niêm Phong Bộ Lọc Bằng Mã Băm SHA-256?

Mọi bộ lọc lỗi đều trở nên vô nghĩa nếu chính AI có quyền mở file lọc lỗi đó ra sửa lại điều kiện chấm điểm. Mô-đun 04 niêm phong toàn bộ các file kiểm tra (scripts/lint_*.mjs), cấu hình cổng (.claude/settings.json) và cấu hình biên dịch (tsconfig.json) bằng mã băm SHA-256 trong file .harness-lock.json.

1. Đối Chiếu Mã Băm SHA-256 Tức Thì: Công cụ scripts/lint_immutable_hook_lock.mjs tính lại mã SHA-256 của từng file bảo vệ và hủy bỏ phiên chạy ngay lập tức (exit code 1) nếu phát hiện sai lệch dù chỉ 1 byte.
2. Tường Lửa PreToolUse Chặn Lệnh Phá Hủy: Chặn đứng các lệnh xóa lịch sử Git (git reset --hard, git push --force, --no-verify) và các lệnh xóa trắng thư mục (rm -rf, Remove-Item -Recurse -Force).
3. Chống Độn Chữ Rỗng (ANTI_TAMPER_GENUINE_TOKEN_FLOOR): Yêu cầu mật độ từ vựng duy nhất đạt chuẩn (uniqueRatio >= 0.25) để AI không thể chép lặp lại một câu nhiều lần nhằm vượt qua bộ đếm dung lượng.
4. Giao Thức Giương Cờ Trắng Trung Thực ([WHITE-FLAG ESCALATION]): Khi hết 3 vòng tự sửa hoặc thiếu khóa API bên ngoài, AI khôi phục mã nguồn về điểm neo rollbackCommitSha và xuất báo cáo 4 mục kèm 2 phương án xử lý rõ ràng.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|Bash",
        "hooks": [{ "type": "command", "command": "node scripts/lint_immutable_hook_lock.mjs" }]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [{ "type": "command", "command": "node scripts/lint_goal_stop_gate.mjs" }]
      }
    ]
  }
}

6. Bảng Đối Sánh Kết Quả Thực Nghiệm

Qua 50 tác vụ sửa đổi nhiều file và 40 kịch bản gỡ lỗi đối kháng, dưới đây là sự khác biệt giữa quy trình mặc định và Agentic Workflow OS:

7. Cài Đặt Ngay Trong 30 Giây (Bản MIT Miễn Phí & Bản Pro Đầy Đủ)

Nhóm kỹ thuật đã mở mã nguồn hoàn toàn miễn phí cho Mô-đun 01 (01-boost-context-bloat-optimizer) cùng trọn bộ 3 Chuyên Khảo Kỹ Thuật Song Ngữ (docs/01..03.md) theo giấy phép MIT để bất kỳ ai cũng có thể áp dụng ngay:

• Kho Mã Nguồn Mở MIT Trên GitHub (Mô-đun 01 + 3 Chuyên Khảo Kỹ Thuật): https://github.com/longwave-ai-lab/agentic-workflow-os
• Kỹ Năng Đã Kiểm Định Grade A (100/100) Trên SkillsDirectory: https://www.skillsdirectory.com/skills/longwave-ai-lab-boost-context-bloat-optimizer
• Trọn Bộ 4 Mô-Đun Bản Pro (gồm /boost, /teamwork-preview, /goal, Khóa SHA-256 và 4 Bộ Lọc Node.js): https://longwave04.gumroad.com/l/agentic-workflow-os