AgentJira là gì?

AgentJira là bảng Kanban mà người nhận việc là AI agent, gắn liền với một hub tri thức doanh nghiệp để agent biết bối cảnh dự án. Trang này trả lời: giải quyết vấn đề gì, dành cho ai, khác gì một trợ lý code, và cố ý không làm gì.

Vấn đề

Agent CLI (Claude Code, Codex, Copilot CLI…) viết code tốt, nhưng khi một team muốn dùng chúng cho việc thật thì bốn thứ bị thiếu:

Thiếu	Hậu quả thực tế
Không có chỗ giao việc chung	Mỗi người tự chạy agent trên máy mình; không ai biết ai đang làm gì, việc trùng nhau
Agent không có bối cảnh dự án	Cùng một câu hỏi, agent trả lời khác nhau mỗi lần; quy ước kiến trúc phải dán lại vào prompt mỗi lần chạy
Không có ranh giới an toàn	Agent chạy trực tiếp trên nhánh làm việc, sai một lần là mất code đang viết dở
Không có điểm dừng của con người	Không ai chịu trách nhiệm cho diff mà agent tạo ra; hoặc duyệt tất, hoặc không dám dùng

Cách AgentJira giải quyết

Bốn cam kết dưới đây được cưỡng chế ở tầng code, không phải quy ước miệng — đó là điểm khác biệt so với việc tự dựng quy trình quanh một agent CLI:

1. Chỉ con người approve được. Server kiểm actor.type === 'human'; service token phân giải về system và bị từ chối. Không có cờ bypass. → Vì sao Human Gate không bypass được
2. Agent không chạm nhánh chính. Mọi việc diễn ra trong git worktree riêng agent/<task-key>; code bạn đang viết dở không bị đụng tới.
3. Task bị chặn chỉ mở khi việc chặn nó xong. Quan hệ blocks được gác ở server, không phải nhắc nhau trong chat. → Dependency gating
4. Tri thức chạy hai chiều. Wiki bơm vào worktree trước mỗi lần chạy; agent xong việc thì đề xuất tri thức mới quay về dạng draft chờ người duyệt. → Wiki hai chiều

Dành cho ai

Bạn là	Bạn dùng AgentJira để	Đọc tiếp
Developer	Giao task cho agent, theo dõi stream realtime, nhắn bổ sung giữa lúc chạy	Tạo task & chạy agent
Tech Lead	Duyệt diff, approve, merge; xử lý rework và conflict	Duyệt và approve
Chủ dự án	Tạo Space, mời thành viên, cấu hình repo và quyền	Tạo Space & mời thành viên
Người giữ tri thức	Nạp tài liệu vào Wiki, duyệt draft, quản Skills	Nạp tài liệu vào Wiki
Stakeholder, PO	Chỉ xem tiến độ, không giao việc	Xem tiến độ
SysAdmin, SRE	Dựng hệ thống, backup, trực sự cố	Cài đặt

Khác gì một trợ lý code?

	Trợ lý code trong IDE	AgentJira
Ai nhận việc	Bạn, agent gợi ý từng dòng	Agent nhận cả task, chạy tới khi xong
Việc chạy ở đâu	Trong thư mục bạn đang mở	Worktree cách ly, nhiều task song song
Bối cảnh dự án	Bạn tự dán vào prompt	Wiki bơm tự động mỗi lần chạy
Ai chịu trách nhiệm hợp nhất	Bạn tự commit	Human Gate — người thật approve, có audit
Nhiều người cùng nhìn	Không	Board dùng chung, event stream realtime

Đổi lại, AgentJira không thay thế IDE của bạn: việc sửa vài dòng, dò lỗi tại chỗ, thử nghiệm nhanh vẫn nên làm trong IDE. AgentJira dành cho việc đủ lớn để đáng mô tả thành task.

Cố ý không làm gì

Đây không phải danh sách "chưa kịp làm" — là ranh giới thiết kế:

• Không tự merge thay người. Không có chế độ "tin agent, cho merge luôn".
• Không chạy agent trên nhánh chính. Không có tùy chọn tắt worktree cho tiện.
• Không tự nhận danh tính từ header client. Danh tính do lớp biên (Cloudflare Access hoặc reverse proxy tin cậy) cấp, nginx xoá sạch header client gửi lên.
• Không phải công cụ quản lý dự án cho người. Không sprint, không burndown, không timesheet — bảng này để giao việc cho agent.
• Không tự sửa vô hạn. Task quá 3 vòng rework thì chuyển needs-human thay vì lặp mãi.

Giới hạn của bản hiện tại (khác với ranh giới thiết kế): Giới hạn Phase 1.

Hai nửa của hệ thống

	Board (:8081)	Arkon (:3119)
Là gì	Bảng Kanban 4 cột + runtime chạy agent	Hub tri thức: Wiki, Skills, Sources
Giữ gì	Task, Group, Plan, worktree, event stream	Tài liệu đã biên dịch, vector tìm kiếm, persona
Ai đọc nhiều nhất	Developer, Tech Lead	Người giữ tri thức, và chính agent

Hai nửa nối với nhau qua MCP và cơ chế bơm Wiki vào worktree — chi tiết ở Kiến trúc tổng thể.

Bước tiếp theo: hiểu từ vựng trước khi thao tác → Khái niệm cốt lõi · muốn chạy thử ngay → Lần đầu đăng nhập · muốn dựng hệ thống → Cài đặt