Ordewell: Biến mục tiêu thành kế hoạch có thứ tự cho các tác vụ coding-agent

Trong bối cảnh các coding-agent như Claude Code, Codex hay OpenCode ngày càng phổ biến, một vấn đề quen thuộc nảy sinh: làm sao để điều phối nhiều tác vụ lập trình tự động một cách có kiểm soát, minh bạch và có thể xác minh? Ordewell là một dự án mã nguồn mở mới ra mắt trên Hacker News, hứa hẹn giải quyết đúng bài toán này.

Huy hiệu giấy phép Apache 2.0

Công cụ này cho phép bạn mô tả một mục tiêu bằng ngôn ngữ tự nhiên, sau đó nó sẽ tạo ra một kế hoạch gồm các tác vụ có thứ tự, mỗi tác vụ đi kèm với runner, model, mức độ "suy nghĩ" (thinking effort) và chế độ hoạt động riêng. Điểm đặc biệt: toàn bộ kế hoạch là một thực thể có kiểu dữ liệu rõ ràng (typed artifact), không phải trạng thái nội bộ ẩn của AI, nên bạn có thể chỉnh sửa mọi thứ trước khi tiêu tốn một token nào.

Điểm khác biệt cốt lõi

Điều khiến Ordewell nổi bật so với các công cụ điều phối agent khác nằm ở triết lý thiết kế: người dùng giữ quyền kiểm soát hoàn toàn.

• Kế hoạch có thể viết lại trước khi chi tiêu token. Bạn có thể thay đổi runner, model, thêm bớt tác vụ và tái cấu trúc các phụ thuộc mà không mất công việc đã hoàn thành.
• Chọn đúng model cho từng tác vụ, công khai minh bạch. Planner đưa ra một quyết định danh mục trên toàn bộ kế hoạch — việc refactor bảo mật và cập nhật README không xứng đáng dùng cùng một model — và hiển thị mọi phân bổ trước khi chạy.
• Phán quyết dựa trên bằng chứng, không dựa trên ý kiến. Một tác vụ chỉ hoàn thành khi dấu hiệu hoàn thành (completion marker) xuất hiện trong kết quả của runner; mã thoát (exit code) được giữ lại như bằng chứng chẩn đoán. Model không bao giờ là trọng tài phân xử.
• Planner biết "nói chuyện ngược lại". Quá trình lập kế hoạch là một cuộc trò chuyện liên tục: nó nghiên cứu repo của bạn ở chế độ chỉ đọc (read-only), hỏi lại khi mục tiêu mơ hồ, và thông điệp cuối cùng của nó chính là kế hoạch.

Huy hiệu số sao GitHub của Ordewell

Không cần thêm API key

Một trong những điểm hấp dẫn nhất của Ordewell là nó không yêu cầu thêm API key nếu bạn đã có sẵn đăng ký. Claude Code, Codex hoặc OpenCode có thể đóng vai trò planner ở chế độ chỉ đọc, chạy trên chính gói đăng ký mà bạn đã dùng cho các runner.

Dĩ nhiên, nếu bạn muốn dùng API key riêng, công cụ hỗ trợ 25 nhà cung cấp bao gồm OpenRouter, Anthropic, OpenAI, Gemini, xAI, Groq, DeepSeek, Mistral và nhiều dịch vụ khác. Bạn cũng có thể trỏ OPENAI_COMPATIBLE_BASE_URL vào bất kỳ endpoint tương thích nào, kể cả model server cục bộ.

Thiết kế multi-runner cho phép bật nhiều runner cùng lúc, và planner sẽ phân bổ một runner cho mỗi tác vụ. Ngoài ba runner có sẵn, bạn có thể mang CLI agent của riêng mình — như Aider — thông qua plugin manifest, không cần sửa mã nguồn.

Ba giao diện, một lõi chung

Ordewell cung cấp ba bề mặt tương tác, tất cả chia sẻ cùng một lõi:

1. VS Code extension — dòng thời gian streaming với suy nghĩ trực tiếp, từng bước nghiên cứu kèm kết quả, và thẻ tác vụ có thể mở rộng để xem output của runner.
2. Terminal UI (TUI) — mọi thứ mà extension làm được, nhưng chạy qua SSH, yêu cầu tmux.
3. CLI — hỗ trợ chế độ headless và scriptable, mọi slash command đều có subcommand tương ứng.

Bạn có thể cài đặt chỉ với một lệnh:

npm install -g ordewell
ordewell

Hoặc dùng npx ordewell nếu không muốn cài toàn cục. Với VS Code, chỉ cần tìm "Ordewell" trong Extensions view.

Trải nghiệm dòng lệnh

Đây là một ví dụ thực tế về cách Ordewell vận hành. Giả sử bạn muốn thêm giới hạn tốc độ (rate limiting) vào API công khai:

ordewell plan --goal "Add rate limiting to the public API"
ordewell run

Planner sẽ nghiên cứu repo, đặt câu hỏi khi cần và đưa ra kế hoạch. Điều thú vị là nó hỏi lại người dùng khi mục tiêu chưa rõ ràng:

Câu hỏi: giới hạn áp dụng theo API key hay theo IP của client? Khuyến nghị: theo key — hàm auth() đã luồn key qua req.ctx.

Sau đó kế hoạch gồm nhiều tác vụ được tạo ra, mỗi tác vụ gán một model phù hợp với độ phức tạp. Khi chạy, một tác vụ chỉ được đánh dấu hoàn thành khi dấu hiệu xác minh xuất hiện trong output của agent. Các tác vụ độc lập có thể chạy song song (mặc định 3 phiên đồng thời).

Tính năng lập kế hoạch nâng cao

Ordewell còn tích hợp các quy trình lập kế hoạch chuyên sâu, được chuyển thể từ bộ skill của Matt Pocock (giấy phép MIT):

• grilling — planner "tra khảo" mục tiêu của bạn bằng ít nhất 3 câu hỏi thăm dò trước khi phác thảo kế hoạch.
• prd — planner xem trước rồi viết một PRD đầy đủ vào file .scratch/PRD.md.
• tdd — các tác vụ được bổ sung hướng dẫn red-green-refactor.

Hỗ trợ đa nền tảng và lưu ý về Windows

VS Code extension, API server và CLI chạy native trên cả Linux, macOS và Windows. TUI cần tmux trên mọi nền tảng — không chỉ Windows — vì tmux là thứ đứng sau terminal trực tiếp của mỗi tác vụ. Trên Windows, bạn nên chạy TUI dưới WSL.

Hai lưu ý quan trọng cho người dùng Windows: nên cài CLI agent bằng trình cài đặt native thay vì qua npm, vì shim .cmd kế thừa giới hạn dòng lệnh 8191 ký tự của cmd.exe. Và hãy giữ Git for Windows được cài đặt, vì POSIX shell của nó là môi trường mà planner chạy các lệnh nghiên cứu.

Quy trình từ kế hoạch đến thực thi của Ordewell

Kiến trúc và giấy phép

Dự án được tổ chức thành bốn gói riêng biệt:

• core — TypeScript thuần, không phụ thuộc UI, chứa Session, PlanStore, Planner, TaskOrchestrator, VerdictEngine và nhiều thành phần khác.
• cli — lệnh ordewell với TUI, plan, run, status, plugins…
• vscode — extension và webview.
• web — HTTP + WebSocket server cục bộ chạy trên 127.0.0.1.

Ordewell được phát hành dưới giấy phép Apache License 2.0, mặc dù tên và logo không nằm trong phạm vi giấy phép này. Dự án đang chào đón các báo cáo lỗi, yêu cầu tính năng và pull request từ cộng đồng.

Ý nghĩa với lập trình viên Việt Nam

Với các đội phát triển phần mềm tại Việt Nam đang ngày càng ứng dụng AI vào quy trình làm việc, Ordewell mang đến một cách tiếp cận thú vị: thay vì để AI tự quyết định mọi thứ trong "hộp đen", công cụ này biến quá trình đó thành minh bạch và có thể kiểm toán. Việc hỗ trợ sẵn các model giá rẻ như DeepSeek hay Qwen của các nhà cung cấp châu Á cũng là một điểm cộng về chi phí cho các startup Việt Nam.

Nếu bạn quan tâm, mã nguồn đầy đủ có tại github.com/ordewell/ordewell, kèm tài liệu CONTRIBUTING.md cho người mới bắt đầu.