v2.1 · MIT License · AI Orchestration Framework

AI không chỉ
trợ lý —
AI thực thi.

OT-Kit chuẩn hóa toàn bộ quy trình phát triển thành hệ thống có cấu trúc: 14 agents chuyên biệt, 33+ workflows, và một vòng lặp nhất quán cho mọi dự án.

14
AI Agents
33+
Workflows
3
Tầng kiến trúc
# Greenfield project — bắt đầu đúng từ ngày 1
/bootstrap "E-commerce API · Node.js · PostgreSQL"
→ Tạo cấu trúc, docs, tsconfig...

/plan "Authentication system"
→ Research + phân rã phase-01 ... phase-04

/code "plans/2025-auth/phase-01.md"
→ Thực thi 6 bước có kiểm soát...
✓ GATE 5/6 — Chờ approve của bạn

/fix-test
✓ 47/47 tests passed · 100% coverage

/docs-update /git-cp "feat: auth system"
✓ Pushed · Docs synced · Done.
Vấn Đề

Developer hiện đại
gánh quá nhiều overhead.

~45 phút/ngày
Mất vào overhead không tạo giá trị sáng tạo: commit, format, document...
Convention lệch
Mỗi người một style. Mỗi sprint một cách làm. Codebase mất nhất quán dần.
Context mất
AI không nhớ session trước, phải giải thích lại từ đầu mỗi lần làm việc.
Knowledge decay
Tài liệu viết xong rồi cũ dần. Chỉ người lâu năm biết codebase thực sự.
Luận Điểm 01

Kiến Trúc 3 Tầng

Phân tách rõ điều gì (Rules), ai làm (Agents), và làm như thế nào (Workflows) — mở rộng mà không mất kiểm soát.

TẦNG 01 · GOVERNANCE
Rules — Hiến Pháp

"Hiến pháp" bất biến chi phối toàn bộ hành vi AI. Đảm bảo nhất quán bất kể agent nào được gọi.

YAGNI KISS DRY kebab-case 200 dòng/file conventional commits
TẦNG 02 · SPECIALISTS
Agents — 14 Chuyên Gia

14 AI persona với vai trò cố định — mỗi agent tối ưu cho đúng một loại task.

planner · researcher
brainstormer · scout
fullstack-developer
ui-ux-designer
tester · debugger
docs-manager
TẦNG 03 · EXECUTION
Workflows — 33+ Lệnh

Mỗi slash-command là một playbook đã chuẩn hóa. Gọi một lệnh — AI thực thi toàn bộ quy trình.

/plan /code /fix /docs /git /debug /bootstrap +26 more
Luận Điểm 02

Vòng Lặp 5 Bước

Sức mạnh nằm ở tính nhất quán — cùng một vòng lặp, mọi feature, mọi dự án. Không còn "nên bắt đầu từ đâu?"

BƯỚC 01
/plan
Research + phân rã thành phase files có cấu trúc
→ plans/YYYYMMDD/phase-*.md
BƯỚC 02
/code
Thực thi 6 bước có kiểm soát, bắt buộc approve ở bước 5
→ Code + tests + review
BƯỚC 03
/fix-test
Lặp tự động đến khi toàn bộ test suite 100% pass
→ 100% green ✓
BƯỚC 04
/docs-update
Đồng bộ tất cả docs với implementation mới nhất
→ Docs luôn up-to-date
BƯỚC 05
/git-cp
Conventional commit chuẩn + push lên remote
→ History sạch, rõ ràng
Không mất hướngLuôn có bước tiếp theo rõ ràng trong mọi tình huống.
Tests bắt buộc/fix-test loop đến khi xanh — không thể bỏ qua.
Docs không tụtCập nhật trong cùng quy trình với code.
History có nghĩaKhông còn "fix bug 2" hay "update stuff".
Luận Điểm 03

Decision Matrix

OT-Kit không phải một-lệnh-cho-tất-cả. Mỗi tình huống có workflow phù hợp — chọn đúng, tiết kiệm hàng giờ.

Tình Huống
Workflow
Thời Gian
Feature phức tạp
/plan → /code
4–8h
Feature đơn giản
/plan-fast → /code
1–3h
Bug rõ nguyên nhân
/fix-fast
15–30 min
Bug cần điều tra
/fix-hard
2–4h
Tests thất bại
/fix-test (loop)
30min–2h
Lỗi UI/UX
/fix-ui
30min–2h
Project mới từ đầu
/bootstrap
1–2h
Onboard codebase cũ
/docs-init → /review
2–4h
Thu thập yêu cầu
/interview "feature"
10–20 min
Lưu context phiên
/save
1–2 min
Xem trạng thái project
/watzup
2–5 min

* /fix tự động route sang /fix-fast hoặc /fix-hard tùy độ phức tạp — AI phân tích, không cần bạn đoán.

Luận Điểm 04

Greenfield & Brownfield

Hai paradigm triển khai hoàn toàn khác nhau — cùng một framework xử lý tốt cả hai với entry point phù hợp.

🌱 Dự Án Mới · Greenfield
Bắt đầu đúng từ ngày 1

Framework tự tạo cấu trúc hoàn chỉnh: thư mục, package.json, tsconfig, initial docs — không có nợ kỹ thuật từ đầu.

1
/bootstrap "Mô tả + tech stack"
2
/plan "Tính năng cần xây"
3
/code "phase-01.md"
4
/fix-test cho đến 100% pass
5
/docs-update · /git-cp
🏗 Codebase Hiện Có · Brownfield
Onboard an toàn, không breaking

AI hiểu toàn bộ codebase trước khi làm bất cứ điều gì. Health check, tech debt analysis, rồi mới thêm tính năng mới.

1
/docs-init — phân tích codebase
2
/review-codebase — health check
3
/plan "Feature mới"
4
/code từng phase
5
/fix-logs · /fix-fast bugs
Luận Điểm 05

AI Thực Thi.
Con Người Quyết Định.

Điểm phân biệt căn bản: phân tách creative decision-making (con người) và consistent execution (AI).

👤 Con Người Làm
🤖 AI Làm
Quyết định kiến trúc
Thực thi theo phase plan
Xác định requirements
Viết boilerplate & tests
Review & approve output
Format commit messages
Chọn tech stack
Cập nhật docs
Sáng tạo giải pháp
Debug systematic
⚡ GATE CONTROL · /code WORKFLOW

Bước 5/6 của mọi /code execution bắt buộc dừng để người dùng approve. AI không tự deploy — human-in-the-loop là bắt buộc.

✓ AI tăng tốc — Human kiểm soát
"Developer giỏi nhất không phải người code nhanh nhất — mà là người quyết định đúng nhanh nhất. OT-Kit giao phần thực thi nhất quán cho AI — để bạn tập trung vào quyết định."
Luận Điểm 06

Hệ Thống /docs
Bộ Nhớ Tổ Chức

Kiến thức bị mất không phải vì thiếu tài liệu — mà vì tài liệu không được duy trì. OT-Kit biến /docs thành component sống.

FILE MỤC ĐÍCH
project-overview.md
Bối cảnh business, yêu cầu, phạm vi dự án
codebase-summary.md
Cấu trúc file, module, dependency map
system-architecture.md
Kiến trúc hệ thống, luồng dữ liệu, API
code-standards.md
Convention, patterns, naming rules
design-guidelines.md
UI/UX system, color palette, components
deployment-guide.md
Deploy, env vars, CI/CD pipeline
project-roadmap.md
Phase tracker, % hoàn thành, next steps
/docs-init · Khởi tạo
Phân tích toàn bộ codebase
Tự sinh 7 file tài liệu
Xác định tech debt & security gaps
/docs-update · Sau mỗi /code
So sánh implementation vs. docs
Cập nhật đúng file có thay đổi
Update roadmap % hoàn thành
❌ Không có /docs
✅ Có /docs (OT-Kit)
1–2 tuần onboard
1–2 ngày onboard
AI giải thích lại mỗi session
AI có context sẵn
Tech debt ẩn
Tech debt rõ từ ngày 1
Convention "miệng"
Convention thành văn bản
Kết Luận

OT-Kit giải quyết
4 vấn đề cốt lõi.

01
Inconsistency
Rules layer đảm bảo mọi output nhất quán, bất kể ai làm.
02
Overhead
Workflows tự động hóa phần non-creative của quy trình.
03
Context Loss
/save, /watzup, docs syncing giữ context giữa các phiên.
04
Knowledge Decay
/docs sống được duy trì tự động — kiến thức tích lũy, không mất.

Không phải: Gõ prompt → copy paste code
Mà là: Hệ thống có cấu trúc · có kiểm soát · có audit trail · có tài liệu tự cập nhật