Kit chạy được, đã committed: ~/Documents/tony/personal-operator-kit (git d6e92ef).

Đo trên máy thật 2026-07-12: Claude Code CLI 2.1.207 · Claude Desktop 1.20186.1 (build 2026-07-10, bản có in-app browser + đã hết bug PATH T18).

Luận điểm gốc: CLI + MCP thiết kế CÓ CHỦ ĐÍCH cho đời mình dễ hơn general computer use.

OpenClaw gọi thẳng xuống Claude Code qua ACP, dùng lại login Claude Code (docs/tools/acp-agents.md). Agent loop = while-loop tầm thường (packages/agent-core/src/agent-loop.ts).

Nous tự khuyên đừng dùng model của họ làm bộ não. Docs OpenClaw thừa nhận API key là "the most predictable option" cho daemon — tức subscription hợp desktop hơn.

Vì bán cho người lạ nên phải general: 152 extension, module "dreaming" 14k dòng để tự nhớ. Phục vụ một người thì quyết sẵn từng lệnh, việc đã thành lệnh không cần nhớ.

Model + giá: Claude Code = Opus trên gói Max cố định. OpenClaw & Hermes bắt tự mang API key, trả theo token. 04/2026 Anthropic cấm OpenClaw dùng gói thuê bao vì user đốt "hàng trăm, hàng ngàn đô".

Công cụ: Bash gọi mọi CLI qua $PATH — không chợ plugin. OpenClaw = 152 extension, Hermes = 30 toolset.

Bộ nhớ truy hồi: chỗ Claude Code yếu (index phẳng, model tự đoán); OpenClaw mạnh (vector+keyword, tự dọn); Hermes yếu (snapshot lúc mở phiên).

Bộ não: cả 3 đều là Claude/GPT. OpenClaw gọi thẳng xuống Claude Code.

CLI + MCP thiết kế có chủ đích cho công việc của mình — không phải "general computer use" như OpenClaw/Hermes.

OpenClaw/Hermes buộc phải general (152 extension, chợ plugin) vì bán cho người lạ, không biết bạn làm gì.

Phục vụ một người → quyết sẵn từng câu lệnh: amy trello, gws, sk, qmd. Việc đã thành lệnh thì không cần nhớ.

Luồng: Ý định → Skill → Context+Workflow → Surface → Proof → Memory, khép bằng vòng chạy-thật → chấm → sửa.

Skill (đầu điều phối) biết khi nào chạy verb nào, đọc context gì, dừng ở ranh giới duyệt nào, ghi proof đâu. Verb (surface) chỉ làm một việc.

Đây là cấu trúc kit thật: .claude/skills/ + bin/ (verb) + hooks/+memory/ + docs.

Lỗ hổng thật của Claude Code chỉ có 1 nhóm: bộ nhớ + học hỏi. 12/16 dòng năng lực nó đã ngang hoặc thắng.

Không bán "tiết kiệm token" — bán "việc đó chạy xong".

Verb thật: bin/operator-verb weekly-close --json. Comment trong code ghi rõ:

SAFETY GUARDRAIL: this verb is READ-ONLY and runs on SAMPLE DATA only. A first win must never be a first incident.

Nguồn dữ liệu: bin/sample-data/board.json. Không ghi Trello/order/member/production. Guardrail baked vào code (Codex thêm).

Chạy trên máy 2026-07-16, output nguyên văn (rút gọn): total: 6, stuck gồm "Book the venue" (days_idle 15), "Legal review of terms" (days_idle 19), "Write welcome email" (days_idle 12).

days_idle tính động từ epoch trong sample board — verify: "trả JSON + proof, days-idle động".

Việc: lấy hết card từ board Trello thật (694bf0d4b8a51f36a088e2d5), gom theo list, chỉ ra card kẹt. Model haiku cả 2 bên. MỘT phiên, BA yêu cầu liên tiếp (--resume).

• Tự mò: 2,737,648 · 2,528,411 token, 65 & 43 lượt; yêu cầu 3 quá 9 phút → BỎ CUỘC. 2/3 xong.
• Lệnh sẵn (amy trello): ~58k–62k token, 2 lượt, ~6s mỗi yêu cầu. 3/3 xong, 17s tổng.

Điểm chính không phải tiết kiệm token. Điểm chính là cách tự mò không làm xong việc.

Bẫy đo lường: chạy 3 lần riêng → overhead che chênh lệch (ra 1.5x vô nghĩa). Đúng: một phiên, context ấm → ra 29x.

Skill workflow-runner nói thẳng: một verb làm một việc; skill quyết KHI NÀO chạy, đọc gì trước, ranh giới ở đâu, proof ghi đâu.

Một lệnh chạy được thì chưa phải trợ lý. Nó là hạt giống đúng. Context, quy trình và skill mới làm nó biết khi nào cần chạy.

This IS a Claude Code project. Clone it, open it in Claude Code, and the skill loads automatically — no copy step.

Nguyên tắc số 1: copy-and-run. Script chỉ lo hai thứ thật sự cần thiết lập: memory hook (đường tuyệt đối) + đưa verb lên PATH.

Sửa lỗi thiết kế: bản đầu đánh số 00-context/…05-feedback-loop/ cho dễ đọc, NHƯNG đặt SKILL.md vào thư mục tài liệu → Claude Code không thấy skill. Tony bắt đúng.

Hai loại file, không lẫn: CC-load (CLAUDE.md, .claude/skills/*/SKILL.md, .claude/settings.json) vs người-đọc (docs/).

Verify: "skill ở đúng chỗ CC load ✅ .claude/skills/".

Tách hai thứ tự: 00→05 = logic hệ thống (cây); quick win → vertical slice → compound = logic trải nghiệm (README + deck).

Người mua đang mệt vì nhiều app. Bắt nuốt 4 khái niệm mới trước khi thấy gì chạy = bức tường. Kết quả trước, khung sau.

README 6 bước: kiểm máy → thắng lợi đầu (~10 phút) → biến verb thành operator → áp vào việc của bạn → compound → advanced.

Vòng vận hành: ý định → skill → bối cảnh → CLI/MCP → kết quả → nhớ lại.

Skill workflow-runner nạp context và workflow phù hợp, chọn tool, dừng ở chỗ cần xin xác nhận, rồi ghi proof về đúng nơi.

Act 5 = build một vertical slice (workflow + surface + skill), KHÔNG phải "build một CLI" — đơn vị nhỏ nhất đủ để thấy một Personal Operator hoạt động.

Skill bước 2: "Read CLAUDE.md (who they are, their rules) and docs/operating-contract.md (the approval boundary). These bind you."

Operating contract (repo CLAUDE.md): READ-ONLY chạy tự do; WRITES vào hệ thống thật (Trello, orders, members, production) phải hỏi trước, cho xem sẽ đổi gì; irreversible luôn confirm; mọi action để lại proof, không silent write.

Skill bước 1: "Find the brief in docs/workflow-brief.md. If none exists, ask the user to fill it first — don't improvise a workflow."

Brief chứa: trigger, steps, approval boundary, proof, done-when. Ví dụ có sẵn: docs/weekly-close.example.md.

Quyết định tranh cãi đã chốt: 02-surfaces ≠ 03-skills — KHÔNG gộp.

Verb = tay (làm một việc). Skill = đầu (biết khi nào chạy, đọc gì, xin xác nhận ở đâu, proof ghi đâu). Gộp = biến kit thành thư viện command, mất điểm bán "operator workflow".

workflow-runner là lớp nối chúng lại.

Demo bằng một yêu cầu weekly close an toàn hoặc đã sanitize — chính verb ở Peak 1, giờ đã bọc trong skill.

Skill: run the verb (prefer --json) → respect boundary (read-only chạy thẳng; writes STOP, show, wait yes) → save proof → report.

CLI cho việc deterministic mình sở hữu; MCP cho capability ngoài; giữ ở model cho phán đoán thay đổi. Không chọn theo trend.

Docs: docs/tool-sourcing-ladder.md + docs/cli-vs-mcp.md.

Guardrail deck: KHÔNG dạy cài neo hoặc CLI-Anything — đường nâng cao khi thật sự cần. Decision guide một phút, không cài, không demo.

• neo: dịch ngược browser API, gọi qua CDP auth sống — cho web app đã login nhưng không có API.
• CLI-Anything: SOP dựng CLI cho phần mềm desktop GUI (~90 app).

Kit chỉ trỏ về research (26), không copy nội dung: 90-advanced/see-research.md.

README bước 3: chọn một recurring job → dùng tool-sourcing ladder quyết CLI/MCP/model → tạo vertical slice đầu tiên.

Act 5 đổi: KHÔNG còn "build một CLI". Là "build một vertical slice gồm workflow + surface + skill".

Quick-win verb phải READ-ONLY hoặc chạy trên SAMPLE DATA. KHÔNG bao giờ là command ghi thẳng vào Trello / order / member / production.

Vì sao: 30 người học × "thắng lợi đầu bằng verb thật" = 30 card rác hoặc đụng hệ thống thật. "Thắng lợi đầu" thành "sự cố đầu".

Operating contract: writes phải confirm, cho xem sẽ đổi gì, chờ yes. Baked vào code.

README bước 4: thêm 04-memory/ khi có durable context cần giữ — SAU khi vertical slice chạy thật.

Việc đã thành lệnh thì không cần nhớ (đó là lý do OpenClaw cần module dreaming 14k dòng, kit này thì không). Memory chỉ giữ phần còn lại chưa thành verb.

Kiến trúc bị ép bởi hợp đồng hook (T1): PreCompact chỉ VETO (schema {"decision":"block",…}, không inject context) → phải ghi liên tục ở Stop, nạp lại ở SessionStart.

Đã VERIFY riêng lẻ: hook bắn trên Desktop; SessionStart(source=compact) chạy; fact sống qua /compact (ở phiên trước, kit cũ); merge không ghi đè hook người khác; idempotent; extractor ra fact có nhãn loại ([decision]/[constraint]/…), bỏ noise.

CHƯA VERIFY (khe hở duy nhất): "clone sạch → install → phiên Desktop THẬT → dạy fact → /compact → nhớ lại" liền một mạch trên kit MỚI. Cần Tony gõ vài câu trong Desktop.

⇒ Slide này dạy KIẾN TRÚC + giới hạn cài đặt. KHÔNG trình bày như live proof cho tới khi test pass.

19 bẫy không Google ra được. Vài cái đầu bảng:

• T19: đếm lượt theo session_id = KHÔNG BAO GIỜ chạy. Desktop sinh nhiều session (tab, /compact, resume); bộ đếm chết ở lượt 1. Fix: đếm dòng transcript chưa xử lý.
• T1: PreCompact chỉ veto, không ghi được.
• T12: hook gọi claude -p tự đầu độc bộ nhớ — ghi fact bịa rồi tin. Fix: --safe-mode --tools "".
• T8: timeout thiếu trên macOS → hook chết im lặng, cả phòng hỏng.

README trỏ đúng bẫy theo từng bước, không bắt đọc hết.

Loop: chạy → held / partial / broke → đề xuất sửa → người dùng duyệt → chạy lại.

Playbook có track record. Retrospective chỉ ĐỀ XUẤT sửa memory, skill hoặc SOP; chủ hệ thống mới là người approve/reject.

Hermes prompt vòng lặp tự học (agent/background_review.py:181-284): "Be ACTIVE — most sessions produce at least one skill update… A pass that does nothing is a missed learning opportunity."

Nhưng nó mù tín hiệu: skill_usage.py chỉ có view/use/patch count, curator tự bảo LLM bỏ qua. Consolidation thông minh mặc định TẮT. ⇒ tự học có thể học sai.

Đừng tự động hóa phán đoán. Hãy tự động hóa nhịp học. — retrospective đề xuất; chủ hệ thống duyệt hoặc từ chối.

Bạn không mang về tám thư mục để đọc. Bạn mang về một đường đi: chuẩn bị máy → gõ một lệnh thay cho dặn từng bước → để Claude tự làm từ đầu tới cuối → xem kết quả thật → cho nó nhớ điều cần nhớ → chấm lại và sửa.

Nhịp deck (đã chốt): mở bằng verb đang chạy → hỏi "tại sao một command chưa thành trợ lý" → reveal khung → đóng bằng CHÍNH verb ban đầu, giờ đã thành vertical slice.

Lỗ hổng thật của Claude Code chỉ 1 nhóm: bộ nhớ + học hỏi. Kit lấp đúng nhóm đó — không cần agent biết mọi thứ, cần operator biết hệ thống việc của bạn.