Herdr Cook Plan: mỗi phase một worker mới, coordinator chỉ lo chăn đàn

# Herdr Cook Plan: mỗi phase một worker mới, coordinator chỉ lo chăn đàn Nguồn: https://modernengineer.dev/vi/library/herdr-cook-plan > **Tóm tắt nhanh:** Herdr Cook Plan chạy một AgentKit plan có sẵn (`plan.md` và các file `phase-*.md`) qua [Herdr](https://herdr.dev). Mỗi phase được giao cho một agent mới trong pane riêng, tuần tự hoặc song song tùy dependency. Coordinator điều phối, xác minh và commit; nó không bao giờ tự implement. Đây là biến thể của [Orca Cook Plan](https://modernengineer.dev/vi/library/orca-cook-plan) cho ai dùng Herdr thay vì Orca. Bài mở cho mọi người, bộ file skill 1.0.0 tải miễn phí sau khi đăng nhập. Ghi chú: bản beta hiện tại của AgentKit (từ 3.0.0-beta.35, 21/10/2026) đã đổi format tên skill từ `ak:<tên>` sang `ak-<tên>`, nên lệnh trong bài đã cập nhật theo tên mới: Claude Code gõ `/ak-plan`, Codex gõ `$ak-plan`. Nếu bạn còn dùng bản cũ hơn, đổi `ak-` thành `ak:` là ra lệnh tương ứng. ## Vì sao cần skill này Chạy cả một plan nhiều phase trong một session sẽ hỏng theo những cách dễ đoán: - **Compaction dồn lên nhau.** Plan dài làm đầy context nhiều lần. Mỗi lần auto-compaction thay chi tiết bằng tóm tắt: đường dẫn file, quyết định, ràng buộc, mạch suy luận dang dở. Các phase sau xây trên bản tóm tắt thiếu hụt, chất lượng giảm dần; agent có thể làm lại việc đã xong hoặc bỏ bước nó tưởng đã làm. - **Nhiễu bị mang theo.** Log, lần thử hỏng, debug của phase 1 vẫn còn khi phase 4 bắt đầu. - **Tự chấm “xong”.** Agent viết code cũng tự quyết là đã xong; terminal im lặng bị coi là thành công. - **Bạn thành người điều phối.** Phải gõ “continue”, trả lời câu hỏi, phát hiện chỗ kẹt, nhớ phase kế tiếp. Skill xử lý theo cách khác: - Mỗi phase bắt đầu với context sạch. Worker cạn context thì để lại notes và handoff cho lần thử mới. - Coordinator luôn nhẹ. Trạng thái nằm trên đĩa (checkpoint, ledger, lease) nên khôi phục chính xác. - “Xong” nghĩa là có bằng chứng: report hoàn tất, diff đúng phạm vi, check pass, do một agent khác xác minh. - Mỗi phase một commit, cộng một ledger chỉ ghi thêm. - Song song khi an toàn; phase ghi chồng file thì chạy tuần tự. - Chỉ hỏi bạn những quyết định thật. Với `--auto`, coordinator tự quyết trong phạm vi plan và ghi lý do, không bao giờ tự mở rộng scope, publish hay làm thao tác phá hủy. ## Bạn nhận được gì - Bộ file `herdr-cook-plan` 1.0.0: `SKILL.md`, các file tham chiếu (`dispatch`, `mailbox`, `supervision`, `recovery`, `runtimes`, `selection`, `omp`), script `check-run-closed.py`, extension Context Guard cho OMP và test. - Trang giới thiệu song ngữ có minh hoạ một lần chạy, các bước, flags và Context Guard (tab “Bản tương tác”). Bộ file dùng cho riêng bạn, không chia sẻ lại. Bản tải miễn phí neo ở 1.0.0. Subscriber cài bộ file thẳng từ agent qua MCP và nhận mọi bản mới sau này mà không phải tải lại bằng tay. Repo [herdr-cook-plan](https://github.com/thieung/herdr-cook-plan) trên GitHub là bản công khai (MIT), cung cấp nguyên trạng; bản trong bài này là bản được duy trì, nơi các cải tiến vào trước. ## Sáu bước của mỗi lần chạy 1. **Kiểm cổng.** Đang ở trong pane Herdr, Herdr 0.9.1 trở lên, integration `current`. 2. **Lập bảng đợt.** Bảng các đợt thực hiện, mặc định tối đa hai worker song song. 3. **Dispatch.** Pane mới và agent mới cho mỗi lần thử; brief nạp từ file có kiểm tra. 4. **Giám sát.** Quét mailbox, chờ từng worker. Terminal idle không phải thành công, hết giờ không phải đồng ý. 5. **Nghiệm thu và commit.** Ghi ý định vào checkpoint trước, commit chỉ path của phase, ghi `phase-accepted` kèm SHA, đóng pane. 6. **Đóng run.** `implementation-summary.md`, `check-run-closed.py`, `run-completed`, nhả lease sau cùng.  *Mỗi phase một worker mới, coordinator chỉ nghiệm thu và commit.* Worker được đặt tên theo phase và lần thử: `p02a01` là phase 2, lần thử 1. Worker thay thế là `p02a02`, nên không bao giờ nhận nhầm câu trả lời của lần thử cũ. ## Chuẩn bị trước khi cài Skill chạy trên macOS và Linux. 1. **Herdr 0.9.1 trở lên.** Gọi skill bên trong một pane Herdr (`HERDR_ENV=1`). 2. **Herdr agent skill.** Bỏ `-g` nếu muốn cài theo dự án: ```bash npx skills add herdrdev/herdr --skill herdr -g ``` 1. **Integration `current` cho mỗi runtime worker.** Kiểm tra rồi cài cho runtime nào chưa current: ```bash herdr integration status herdr integration install <kind> ``` 1. **AgentKit Engineer Kit** trong runtime của worker, vì worker chạy `ak-cook`: `ak kit init engineer --target <runtime> --yes`. Mua AgentKit qua [link giới thiệu của mình](https://agentkit.best/?ref=OMG49S8R), giảm 30%. 2. **Python 3**, và rất nên dùng **Git**: có Git thì mỗi phase được nghiệm thu là một commit riêng. ## Cài từ bộ file Thành viên gói Subscriber đã nối [MCP server modernEngineer](https://modernengineer.dev/vi/mcp) không cần làm tay: dán câu lệnh ở phần Bộ file vào agent, agent tự tải, cài và cập nhật khi có bản mới. Tải bộ file ở cuối bài rồi giải nén. Thư mục skill nằm ở `herdr-cook-plan/herdr-cook-plan/` trong file zip. Chép nguyên thư mục vào thư mục skills của runtime: | Runtime | Theo dự án | Global | | --- | --- | --- | | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | Codex | `.agents/skills/` | `~/.agents/skills/` | | OMP | `.omp/skills/` | `~/.omp/agent/skills/` | | Pi | `.pi/skills/` | `~/.pi/agent/skills/` | | Cursor | `.cursor/skills/` | `~/.cursor/skills/` | | Grok CLI | `.grok/skills/` | `~/.grok/skills/` | Ví dụ cài global cho Claude Code: ```bash unzip herdr-cook-plan-v1.0.0.zip mkdir -p ~/.claude/skills test ! -e ~/.claude/skills/herdr-cook-plan && cp -R herdr-cook-plan/herdr-cook-plan ~/.claude/skills/ ``` Chạy test của skill để chắc bộ file nguyên vẹn: ```bash python3 herdr-cook-plan/herdr-cook-plan/tests/instruction-contract.test.py node --test herdr-cook-plan/herdr-cook-plan/tests/context-guard.test.mjs ``` ### Trên OMP: khởi động coordinator kèm guard Không có gì tự đăng ký guard. Khởi động coordinator kèm extension; coordinator tự gắn cùng extension cho mọi worker OMP nó mở: ```bash omp --extension ~/.omp/agent/skills/herdr-cook-plan/extensions/context-guard.mjs ``` Không dùng `--no-extensions`: nó tắt luôn integration OMP của Herdr, và trạng thái worker không còn đáng tin. ## Cách gọi Mở một pane Herdr, khởi động agent coordinator, rồi trỏ nó tới plan. Truyền file plan, hoặc thư mục chứa `plan.md`: | Runtime | Cú pháp | | --- | --- | | Claude Code, Cursor, Grok CLI | `/herdr-cook-plan plan.md --auto` | | OMP, Pi | `/skill:herdr-cook-plan plan.md --auto` | | Codex | `$herdr-cook-plan plan.md --select-agent --auto --advice` | ## Flags **Flags điều phối** | Flag | Ý nghĩa | | --- | --- | | `--runtime <kind>` | Runtime của worker cho cả run, theo agent kind của Herdr (`omp`, `claude`, `codex`...). Mặc định là kind của chính coordinator. Nhận `--runtime=omp` và `--runtime=current`; không nhận `--kind`. | | `--model <id>` | Model chính của worker, truyền qua argv gốc của kind. Coordinator đọc `--help` của kind trước, không tự đặt ra flag. | | `--select-agent` | Hỏi runtime và model của worker một lần trước dispatch đầu, giữ cho mọi phase, repair và lần khôi phục. `--auto` không trả lời thay câu hỏi này. | | `--auto` | Coordinator tự quyết các approval trong plan và ghi lý do. Worker không nhận `--auto` của cook, vẫn hỏi qua mailbox. Không bao gồm mở rộng scope, publish, deploy hay thao tác phá hủy. | | `--omp-advisor all\|none\|<phase,...>` | Bật advisor riêng của OMP cho từng worker OMP. Danh sách phase áp cả cho repair và worker thay thế. | | `--parallel` | Ưu tiên lập lịch, không truyền xuống worker. Dependency và ghi chồng file vẫn chạy tuần tự; mặc định tối đa hai worker. | **Chuyển xuống `ak-cook`**: `--advice` bật advisory protocol của AgentKit (các checkpoint kongming) cho mọi phase và repair; `--tdd` và các flag cook khác được đối chiếu với bản cook đã cài trong runtime của worker rồi mới chuyển xuống. `--advice` và `--omp-advisor` là hai cơ chế độc lập, bật cùng lúc được. Config global của OMP không bao giờ bị sửa; tắt advisor cho một run dùng overlay riêng của run đó. ## Khôi phục và Context Guard Mọi runtime khôi phục từ file (checkpoint, brief theo lần thử, mailbox, lease) ngay trong session đó. Riêng OMP có Context Guard: nó gắn vai trò và run cho mỗi session, và đòi khôi phục sau compaction, fallback, restart, đổi model hay khi context gần ngưỡng. Guard không đổi model, không chạy lệnh, không ghi checkpoint, không dispatch worker. Kiểm tra bằng `/herdr-cook-context-status`. Guard đã có unit test; hành vi dưới compaction thật mình chưa quan sát được. Nếu guard của Orca Cook Plan cũng có trong session, checkpoint của Herdr được ưu tiên; nếu guard Orca đang active, coordinator dừng và hỏi bạn. ## Giới hạn đã biết - Mỗi run chỉ một runtime cho worker; chưa gán runtime theo từng phase. - Guard tự động chỉ có trên OMP. - Live smoke còn giới hạn: một lượt hai phase với worker OMP. Các runtime worker khác và full cook E2E chưa được kiểm chứng. - Worker có thể ghi thêm `plans/journals/*` ngoài phạm vi. - Với Claude Code và Codex, `ak-cook` phải được dò trên máy trước lần dispatch đầu. Herdr và AgentKit là dự án riêng với điều khoản riêng.

unzip herdr-cook-plan-v1.0.0.zip
mkdir -p ~/.claude/skills
test ! -e ~/.claude/skills/herdr-cook-plan &&
  cp -R herdr-cook-plan/herdr-cook-plan ~/.claude/skills/

python3 herdr-cook-plan/herdr-cook-plan/tests/instruction-contract.test.py
node --test herdr-cook-plan/herdr-cook-plan/tests/context-guard.test.mjs

omp --extension ~/.omp/agent/skills/herdr-cook-plan/extensions/context-guard.mjs

Đọc bài "Herdr Cook Plan: mỗi phase một worker mới, coordinator chỉ lo chăn đàn" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "herdr-cook-plan". Nếu chưa nối MCP hoặc bị từ chối quyền, đọc thẳng trang https://modernengineer.dev/vi/library/herdr-cook-plan.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.

claude mcp add --transport http modernengineer \
  https://api.modernengineer.dev/mcp \
  --header "Authorization: Bearer <API key>"