Skip to content

Harness engineering beginner tutorial, from 0 to 1

feat(vi): add Vietnamese translations for all resource files

TinyCodera56a12528e7e
diff --git a/docs/vi/resources/openai-advanced/index.md b/docs/vi/resources/openai-advanced/index.md
new file mode 100644
index 0000000..8585472
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/index.md
@@ -0,0 +1,74 @@
+[English Version →](../../../en/resources/openai-advanced/) | [中文版本 →](../../../zh/resources/openai-advanced/)
+
+# Gói Harness Nâng cao OpenAI
+
+Gói này tập hợp thiết kế harness được mô tả trong bài viết "Harness Engineering" của OpenAI thành một bộ tệp bắt đầu có thể áp dụng và cấu trúc SOP đi kèm.
+
+## Tại sao Nó Tồn tại
+
+Bài viết harness engineering mô tả các nguyên tắc cấp cao: kho lưu trữ là hệ thống ghi chép, bộ nhớ ngoại hóa, kiểm tra cơ học thay vì ký ức, và các vòng phản hồi phục hồi. Gói này biến các nguyên tắc đó thành:
+
+- bộ tài liệu cấu trúc rõ ràng cho một repo thực tế
+- tính điểm chất lượng theo domain sản phẩm và lớp kiến trúc
+- thư mục tài liệu tham khảo thân thiện với model
+- các quy trình vận hành chuẩn cho kiến trúc, thu thập kiến thức, và xác minh runtime
+
+## Bố cục Bắt đầu Có sẵn
+
+Gói bắt đầu trong [`repo-template/`](./repo-template/index.md) phản ánh cấu trúc dưới đây:
+
+```text
+AGENTS.md
+ARCHITECTURE.md
+docs/
+├── design-docs/
+│ ├── index.md
+│ └── core-beliefs.md
+├── exec-plans/
+│ ├── active/
+│ ├── completed/
+│ └── tech-debt-tracker.md
+├── generated/
+│ └── db-schema.md
+├── product-specs/
+│ ├── index.md
+│ └── new-user-onboarding.md
+├── references/
+│ ├── design-system-reference-llms.txt
+│ ├── nixpacks-llms.txt
+│ └── uv-llms.txt
+├── DESIGN.md
+├── FRONTEND.md
+├── PLANS.md
+├── PRODUCT_SENSE.md
+├── QUALITY_SCORE.md
+├── RELIABILITY.md
+└── SECURITY.md
+```
+
+## Cách Áp dụng Nó
+
+1. Bắt đầu từ gói tối giản nếu repo của bạn vẫn còn nhỏ.
+2. Sao chép các tệp trong [`repo-template/`](./repo-template/index.md) vào kho lưu trữ của bạn khi bạn cần cấu trúc mạnh hơn.
+3. Giữ `AGENTS.md` ngắn. Coi nó như bộ định tuyến vào các tài liệu sâu hơn, không phải như bách khoa toàn thư.
+4. Cập nhật các tài liệu chất lượng, độ tin cậy và kế hoạch như một phần của công việc thông thường, không phải như một ngày dọn dẹp riêng biệt.
+5. Giữ các artifact được tạo ra và tài liệu tham khảo bên ngoài rõ ràng để agent có thể tìm thấy chúng mà không cần dựa vào lịch sử chat.
+
+## Thư viện SOP
+
+Thư mục [`sops/`](./sops/index.md) biến các sơ đồ của bài viết thành các quy trình vận hành từng bước:
+
+- thiết lập kiến trúc domain phân lớp
+- mã hóa kiến thức ẩn vào kho lưu trữ
+- stack observability cục bộ và workflow vòng phản hồi
+- vòng lặp xác minh Chrome DevTools cho công việc UI
+
+## Nguyên tắc Thiết kế
+
+- Điểm đầu vào ngắn, tài liệu liên kết sâu hơn
+- Kho lưu trữ là hệ thống ghi chép
+- Kiểm tra cơ học tốt hơn các quy tắc được nhớ
+- Kế hoạch và lịch sử chất lượng nằm bên cạnh mã
+- Dọn dẹp và đơn giản hóa là trách nhiệm hạng nhất
+
+Gói này có chủ ý theo quan điểm, nhưng nó vẫn nên được điều chỉnh cho dự án của bạn thay vì sao chép mù quáng.
diff --git a/docs/vi/resources/openai-advanced/repo-template/AGENTS.md b/docs/vi/resources/openai-advanced/repo-template/AGENTS.md
new file mode 100644
index 0000000..adad44b
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/AGENTS.md
@@ -0,0 +1,55 @@
+# AGENTS.md
+
+Kho lưu trữ này được tối ưu hóa cho công việc coding-agent chạy lâu. Giữ tệp này ngắn. Sử dụng nó như lớp định tuyến vào các tài liệu hệ thống ghi chép, không phải như một đống hướng dẫn khổng lồ.
+
+## Quy trình Khởi động
+
+Trước khi thay đổi mã:
+
+1. Xác nhận thư mục gốc repo bằng `pwd`.
+2. Đọc `ARCHITECTURE.md` để biết bản đồ hệ thống hiện tại và các quy tắc phụ thuộc cứng.
+3. Đọc `docs/QUALITY_SCORE.md` để xem domain hoặc lớp nào yếu nhất.
+4. Đọc `docs/PLANS.md`, sau đó mở kế hoạch active bạn đang làm việc từ đó.
+5. Đọc spec sản phẩm liên quan trong `docs/product-specs/`.
+6. Chạy đường dẫn bootstrap và xác minh chuẩn cho repo này.
+7. Nếu xác minh baseline đang thất bại, hãy sửa baseline trước khi thêm phạm vi.
+
+## Bản đồ Định tuyến
+
+- `ARCHITECTURE.md`: bản đồ domain, mô hình lớp, quy tắc phụ thuộc
+- `docs/design-docs/index.md`: các quyết định thiết kế và niềm tin cốt lõi
+- `docs/product-specs/index.md`: các hành vi sản phẩm hiện tại và mục tiêu chấp nhận
+- `docs/PLANS.md`: vòng đời kế hoạch và chính sách kế hoạch thực thi
+- `docs/QUALITY_SCORE.md`: sức khỏe domain sản phẩm và lớp
+- `docs/RELIABILITY.md`: tín hiệu runtime, benchmark và kỳ vọng khởi động lại
+- `docs/SECURITY.md`: bí mật, sandbox, dữ liệu và quy tắc hành động bên ngoài
+- `docs/FRONTEND.md`: ràng buộc UI, quy tắc design system, kiểm tra accessibility
+
+## Hợp đồng Làm việc
+
+- Làm việc từ một kế hoạch có ranh giới hoặc slice tính năng tại một thời điểm.
+- Không đánh dấu công việc xong chỉ từ kiểm tra mã; cần bằng chứng có thể chạy được.
+- Nếu bạn thay đổi hành vi, hãy cập nhật tài liệu sản phẩm, kế hoạch hoặc độ tin cậy phù hợp trong cùng phiên.
+- Nếu bạn thấy phản hồi review lặp đi lặp lại, hãy thúc đẩy nó thành quy tắc cơ học, kiểm tra hoặc linter thay vì giải thích lại trong chat.
+- Giữ tài liệu được tạo ra trong `docs/generated/` và tài liệu tham khảo nguồn trong `docs/references/`.
+- Ưu tiên thêm tài liệu nhỏ, hiện tại hơn là phát triển tệp này.
+
+## Định nghĩa Hoàn thành
+
+Một thay đổi chỉ xong khi tất cả những điều sau đây là đúng:
+
+- hành vi mục tiêu đã được triển khai
+- xác minh cần thiết đã thực sự chạy
+- bằng chứng được liên kết từ kế hoạch hoặc tài liệu chất lượng liên quan
+- các tài liệu bị ảnh hưởng vẫn là hiện tại
+- kho lưu trữ có thể khởi động lại sạch sẽ từ đường dẫn khởi động chuẩn
+
+## Cuối Phiên
+
+Trước khi kết thúc phiên:
+
+1. Cập nhật kế hoạch thực thi active.
+2. Cập nhật `docs/QUALITY_SCORE.md` nếu bất kỳ domain hoặc lớp nào thay đổi có ý nghĩa.
+3. Ghi lại nợ mới trong `docs/exec-plans/tech-debt-tracker.md` nếu bạn đã hoãn nó.
+4. Di chuyển các kế hoạch đã hoàn thành sang `docs/exec-plans/completed/` khi phù hợp.
+5. Để repo ở trạng thái có thể khởi động lại với hành động tiếp theo rõ ràng.
diff --git a/docs/vi/resources/openai-advanced/repo-template/ARCHITECTURE.md b/docs/vi/resources/openai-advanced/repo-template/ARCHITECTURE.md
new file mode 100644
index 0000000..9622186
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/ARCHITECTURE.md
@@ -0,0 +1,55 @@
+# ARCHITECTURE.md
+
+Tệp này là bản đồ cấp cao nhất của hệ thống. Nó nên ngắn gọn và trỏ đến các tài liệu sâu hơn khi cần.
+
+## Hình dạng Hệ thống
+
+- Sản phẩm: `[thay thế bằng tên sản phẩm]`
+- Workflow người dùng chính: `[thay thế bằng workflow chính]`
+- Bề mặt runtime: `[desktop / web / cli / services / workers]`
+- Nguồn sự thật cho hành vi sản phẩm: `docs/product-specs/`
+
+## Bản đồ Domain
+
+| Domain | Mục đích | Điểm đầu vào chính | Spec liên quan |
+|--------|---------|----------------------|----------------|
+| `[domain-a]` | `[những gì nó sở hữu]` | `[modules / routes / commands]` | `[đường dẫn spec]` |
+| `[domain-b]` | `[những gì nó sở hữu]` | `[modules / routes / commands]` | `[đường dẫn spec]` |
+
+## Mô hình Lớp
+
+Sử dụng mô hình định hướng cố định để agent không tự phát minh ra kiến trúc ad hoc:
+
+`Types -> Config -> Repo -> Service -> Runtime -> UI`
+
+Các mối quan tâm xuyên suốt nên đi vào qua các ranh giới provider hoặc adapter rõ ràng thay vì tiếp cận trực tiếp qua các lớp.
+
+## Quy tắc Phụ thuộc Cứng
+
+- Các lớp thấp hơn không được phụ thuộc vào các lớp cao hơn.
+- UI không được bỏ qua các hợp đồng runtime hoặc service.
+- Truy cập dữ liệu phải đi qua các repository hoặc adapter tương đương.
+- Các tiện ích dùng chung phải là chung chung và không được tích lũy logic domain.
+- Các phụ thuộc mới nên được chứng minh trong kế hoạch hoặc tài liệu thiết kế phù hợp.
+
+## Giao diện Xuyên suốt
+
+| Mối quan tâm | Ranh giới được phê duyệt | Ghi chú |
+|--------|-------------------|---------|
+| Logging và tracing | `[đường dẫn provider / utility]` | `[chỉ có cấu trúc, không sử dụng console ad hoc]` |
+| Auth | `[đường dẫn provider]` | `[quy tắc token/session]` |
+| External API | `[đường dẫn client hoặc provider]` | `[hướng dẫn rate limit / retry]` |
+| Feature flags | `[ranh giới flag]` | `[quyền sở hữu]` |
+
+## Điểm Nóng Hiện tại
+
+- `[khu vực khó thay đổi an toàn nhất cho agent]`
+- `[khu vực có ranh giới yếu hoặc test dễ vỡ]`
+
+## Danh sách Kiểm tra Thay đổi
+
+Khi bạn chạm vào mã liên quan đến kiến trúc:
+
+1. Cập nhật tệp này nếu bản đồ domain hoặc ranh giới được phép thay đổi.
+2. Cập nhật tài liệu thiết kế liên quan trong `docs/design-docs/` nếu lý luận thay đổi.
+3. Thêm hoặc cập nhật kiểm tra có thể thực thi nếu quy tắc nên được thực thi cơ học.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/DESIGN.md b/docs/vi/resources/openai-advanced/repo-template/docs/DESIGN.md
new file mode 100644
index 0000000..c7159d9
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/DESIGN.md
@@ -0,0 +1,25 @@
+# DESIGN.md
+
+Tệp này là điểm đầu vào thiết kế. Giữ nó ngắn gọn và sử dụng nó để định tuyến vào các tệp chi tiết hơn trong `docs/design-docs/`.
+
+## Mục đích
+
+Ghi lại các quyết định thiết kế sản phẩm và hệ thống lâu bền nên tồn tại vượt ra ngoài một chat, sprint, hoặc bộ nhớ reviewer đơn lẻ.
+
+## Đọc Điều này Khi
+
+- bạn cần triết lý thiết kế hiện tại
+- bạn sắp giới thiệu một mẫu mới
+- bạn cần biết quyết định thiết kế nào đã được giải quyết so với vẫn đang mở
+
+## Tài liệu Thiết kế Chuẩn
+
+- `docs/design-docs/index.md`: chỉ mục các tài liệu đã được chấp nhận, đề xuất và không dùng nữa
+- `docs/design-docs/core-beliefs.md`: niềm tin agent-first toàn dự án
+
+## Quy tắc Thiết kế
+
+- Giữ các tài liệu thiết kế nhỏ và hiện tại.
+- Ưu tiên một tài liệu cho mỗi khu vực quyết định.
+- Liên kết tài liệu thiết kế từ các kế hoạch và spec khi một thay đổi phụ thuộc vào chúng.
+- Nếu một quy tắc thiết kế trở nên quan trọng về mặt vận hành, hãy thúc đẩy nó thành một kiểm tra tự động hoặc cập nhật `ARCHITECTURE.md`.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/FRONTEND.md b/docs/vi/resources/openai-advanced/repo-template/docs/FRONTEND.md
new file mode 100644
index 0000000..a18c4bb
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/FRONTEND.md
@@ -0,0 +1,23 @@
+# FRONTEND.md
+
+Tệp này định nghĩa các kỳ vọng frontend ổn định để agent không phát minh ra các mẫu UI một cách không thể đoán trước.
+
+## Nguyên tắc UI
+
+- Tối ưu hóa cho sự rõ ràng trước sự mới lạ.
+- Giữ các luồng tương tác có thể khám phá và khởi động lại được.
+- Ưu tiên một số ít component tái sử dụng thay vì các biến thể một lần.
+- Kiểm tra accessibility là một phần của xác minh thông thường, không phải công việc đánh bóng.
+
+## Guardrail
+
+- Ghi lại design system hoặc thư viện component trong `docs/references/`.
+- Ghi lại các trạng thái quan trọng dành cho người dùng: trống, đang tải, thành công, lỗi, thử lại.
+- Giữ copy, hành vi bàn phím và hệ thống phân cấp trực quan nhất quán qua các luồng.
+- Khi một lỗi UI được sửa, hãy thêm hoặc cập nhật bước xác minh phù hợp.
+
+## Kỳ vọng Xác minh
+
+- Ghi lại bằng chứng cho các user journey quan trọng.
+- Ghi lại các bước xác minh browser hoặc runtime trong kế hoạch liên quan.
+- Nếu các hồi quy trực quan phổ biến, hãy chuẩn hóa kiểm tra screenshot hoặc DOM.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/PLANS.md b/docs/vi/resources/openai-advanced/repo-template/docs/PLANS.md
new file mode 100644
index 0000000..95a7922
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/PLANS.md
@@ -0,0 +1,34 @@
+# PLANS.md
+
+Tệp này định nghĩa cách các kế hoạch thực thi được tạo, cập nhật, hoàn thành và lưu trữ.
+
+## Khi Cần Một Kế hoạch
+
+Tạo một kế hoạch thực thi khi công việc:
+
+- trải dài hơn một phiên
+- thay đổi nhiều hơn một hệ thống con
+- có rủi ro xác minh hoặc triển khai không tầm thường
+- phụ thuộc vào các quyết định mở nên được ghi lại
+
+## Vị trí Kế hoạch
+
+- `docs/exec-plans/active/`: các kế hoạch hiện đang thúc đẩy công việc
+- `docs/exec-plans/completed/`: các kế hoạch đã hoàn thành được giữ lại để cung cấp ngữ cảnh cho agent trong tương lai
+- `docs/exec-plans/tech-debt-tracker.md`: công việc đã hoãn và các follow-up
+
+## Các Phần Kế hoạch Tối thiểu
+
+- mục tiêu
+- phạm vi và ngoài phạm vi
+- đường dẫn xác minh
+- rủi ro và sự cố chặn
+- nhật ký tiến độ
+- quyết định mở
+
+## Quy tắc Vận hành
+
+- Một kế hoạch active nên có một bước hiện tại được sở hữu rõ ràng.
+- Cập nhật kế hoạch khi công việc tiến triển; đừng coi nó như văn xuôi tĩnh.
+- Nếu một quyết định thay đổi hướng triển khai, hãy ghi lại nó trong kế hoạch.
+- Di chuyển các kế hoạch đã hoàn thành sang `completed/` để agent vẫn có thể khám phá ngữ cảnh trước đó.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/PRODUCT_SENSE.md b/docs/vi/resources/openai-advanced/repo-template/docs/PRODUCT_SENSE.md
new file mode 100644
index 0000000..5692387
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/PRODUCT_SENSE.md
@@ -0,0 +1,24 @@
+# PRODUCT_SENSE.md
+
+Tệp này ghi lại phán xét sản phẩm lâu bền mà agent không thể suy ra đáng tin cậy chỉ từ mã.
+
+## Cốt lõi Sản phẩm
+
+- Người dùng chính: `[thay thế]`
+- Công việc cần hoàn thành: `[thay thế]`
+- Sự thất vọng chính cần loại bỏ: `[thay thế]`
+- Tiêu chuẩn chất lượng để chấp nhận: `[thay thế]`
+
+## Quy tắc Sản phẩm
+
+- Ưu tiên độ tin cậy có thể nhìn thấy của người dùng hơn số lượng tính năng.
+- Coi hành vi mơ hồ là khoảng trống spec, không phải sự cho phép để đoán.
+- Nếu việc triển khai thay đổi những gì người dùng nhìn thấy hoặc tin tưởng, hãy cập nhật spec phù hợp.
+- Sử dụng product spec cho các luồng cụ thể, và sử dụng tệp này cho các ưu tiên sản phẩm xuyên suốt.
+
+## Mẫu Không được phép
+
+- Các hành động phá hủy ẩn
+- Thất bại âm thầm mà không có phản hồi cho người dùng
+- Nguồn sự thật không rõ ràng cho trạng thái có thể nhìn thấy
+- Các tính năng không thể giải thích trong một câu
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/QUALITY_SCORE.md b/docs/vi/resources/openai-advanced/repo-template/docs/QUALITY_SCORE.md
new file mode 100644
index 0000000..c8d1b77
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/QUALITY_SCORE.md
@@ -0,0 +1,39 @@
+# QUALITY_SCORE.md
+
+Tài liệu này theo dõi liệu kho lưu trữ có đang trở nên mạnh hơn hay yếu hơn theo thời gian.
+
+## Thang điểm
+
+- `A`: đã xác minh, có thể đọc được, ổn định, ranh giới được thực thi
+- `B`: hoạt động với các khoảng trống nhỏ
+- `C`: hoạt động một phần, nhầm lẫn hoặc không ổn định đáng kể
+- `D`: bị hỏng, không an toàn, hoặc cấu trúc không rõ ràng
+
+## Domain Sản phẩm
+
+| Domain | Điểm | Xác minh | Khả năng đọc của Agent | Độ ổn định Test | Khoảng trống chính | Cập nhật lần cuối |
+|--------|-------|-------------|-----------------|---------------|----------|-------------|
+| `[domain-a]` | - | - | - | - | - | - |
+| `[domain-b]` | - | - | - | - | - | - |
+| `[domain-c]` | - | - | - | - | - | - |
+
+## Lớp Kiến trúc
+
+| Lớp | Điểm | Thực thi Ranh giới | Khả năng đọc của Agent | Khoảng trống chính | Cập nhật lần cuối |
+|-------|-------|---------------------|-----------------|----------|-------------|
+| Types | - | - | - | - | - |
+| Services | - | - | - | - | - |
+| Runtime | - | - | - | - | - |
+| UI | - | - | - | - | - |
+
+## Snapshot Benchmark
+
+| Ngày | Biến thể Harness | Tỷ lệ Hoàn thành | Thử lại | Lỗi trước Review | Ghi chú |
+|------|-----------------|----------------|--------|-----------------------|---------|
+| YYYY-MM-DD | `[baseline / improved / simplified]` | - | - | - | - |
+
+## Nhật ký Đơn giản hóa
+
+| Ngày | Thành phần Đã xóa | Kết quả | Quyết định |
+|------|-------------------|---------|------------|
+| YYYY-MM-DD | `[thành phần]` | `[giảm sút / không thay đổi]` | `[khôi phục / giữ đã xóa]` |
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/RELIABILITY.md b/docs/vi/resources/openai-advanced/repo-template/docs/RELIABILITY.md
new file mode 100644
index 0000000..3b61954
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/RELIABILITY.md
@@ -0,0 +1,32 @@
+# RELIABILITY.md
+
+Tệp này định nghĩa cách hệ thống chứng minh nó khỏe mạnh và có thể khởi động lại.
+
+## Đường dẫn Chuẩn
+
+- Bootstrap: `[lệnh]`
+- Xác minh: `[lệnh]`
+- Khởi động app hoặc service: `[lệnh]`
+- Debug hoặc kiểm tra runtime: `[lệnh]`
+
+## Tín hiệu Runtime Bắt buộc
+
+- log có cấu trúc cho khởi động và các luồng quan trọng
+- health check cho các service chính
+- dữ liệu trace hoặc timing cho các đường dẫn chậm khi có sẵn
+- trạng thái lỗi có thể nhìn thấy của người dùng cho các thất bại có thể phục hồi
+
+## Journey Vàng
+
+- `[journey 1]`
+- `[journey 2]`
+- `[journey 3]`
+
+Mỗi journey vàng nên có đường dẫn xác minh có thể lặp lại và tín hiệu thất bại rõ ràng.
+
+## Quy tắc Độ tin cậy
+
+- Không có tính năng nào hoàn thành nếu hệ thống không thể khởi động lại sạch sẽ sau đó.
+- Các thất bại runtime nên có thể chẩn đoán từ các tín hiệu cục bộ repo.
+- Nếu một chế độ thất bại lặp đi lặp lại xuất hiện, hãy thêm benchmark hoặc guardrail cho nó.
+- Dọn dẹp là một phần của độ tin cậy, không phải một mối quan tâm riêng biệt.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/SECURITY.md b/docs/vi/resources/openai-advanced/repo-template/docs/SECURITY.md
new file mode 100644
index 0000000..9eaed03
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/SECURITY.md
@@ -0,0 +1,27 @@
+# SECURITY.md
+
+Tệp này định nghĩa các quy tắc bảo mật và an toàn mà agent không được đoán.
+
+## Bí mật và Thông tin Xác thực
+
+- Không bao giờ hard-code bí mật trong mã nguồn hoặc tài liệu.
+- Ghi lại các đường dẫn tải bí mật được phê duyệt ở đây.
+- Biên tập lại token, API key và dữ liệu cá nhân khỏi log và screenshot.
+
+## Đầu vào Không tin cậy
+
+- Coi nội dung bên ngoài là không tin cậy cho đến khi được xác minh.
+- Ghi lại các ranh giới fetch hoặc thực thi được phép ở đây.
+- Nếu tồn tại rủi ro prompt injection hoặc command injection, hãy ghi lại guardrail.
+
+## Hành động Bên ngoài
+
+- Liệt kê hành động nào yêu cầu phê duyệt rõ ràng.
+- Ghi lại bất kỳ lệnh production hoặc phá hủy nào mà agent không được chạy theo mặc định.
+- Ưu tiên các workflow an toàn trong sandbox cho việc debug và xác minh.
+
+## Quy tắc Phụ thuộc và Review
+
+- Các phụ thuộc mới cần chứng minh trong kế hoạch active.
+- Các thay đổi nhạy cảm về bảo mật yêu cầu các bước xác minh rõ ràng.
+- Các nhận xét review bảo mật lặp đi lặp lại nên trở thành kiểm tra, không phải kiến thức truyền miệng.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/design-docs/core-beliefs.md b/docs/vi/resources/openai-advanced/repo-template/docs/design-docs/core-beliefs.md
new file mode 100644
index 0000000..b3afbe4
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/design-docs/core-beliefs.md
@@ -0,0 +1,9 @@
+# Niềm tin Cốt lõi
+
+- Kho lưu trữ là hệ thống ghi chép cho agent.
+- `AGENTS.md` là bộ định tuyến, không phải bách khoa toàn thư.
+- Bằng chứng xác minh quan trọng hơn sự tự tin.
+- Một tác vụ có ranh giới tốt hơn nhiều tác vụ làm dở.
+- Phản hồi con người lặp đi lặp lại nên trở thành các quy tắc harness có thể tái sử dụng.
+- Dọn dẹp và đơn giản hóa là một phần của việc phát hành, không phải là suy nghĩ sau.
+- Nếu agent không thể khám phá một sự thật trong repo, hãy coi sự thật đó là không khả dụng về mặt vận hành.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/design-docs/index.md b/docs/vi/resources/openai-advanced/repo-template/docs/design-docs/index.md
new file mode 100644
index 0000000..d9c7ef1
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/design-docs/index.md
@@ -0,0 +1,21 @@
+# Chỉ mục Tài liệu Thiết kế
+
+Sử dụng chỉ mục này như bản đồ có thể khám phá của lịch sử thiết kế.
+
+## Đã Chấp nhận
+
+- `core-beliefs.md`: niềm tin vận hành agent-first và chuẩn mực dự án lâu bền
+
+## Đề xuất
+
+- `[thêm đường dẫn tài liệu thiết kế mới ở đây]`
+
+## Không còn Dùng
+
+- `[di chuyển các tài liệu thiết kế cũ hoặc đã bị thay thế ở đây với các liên kết thay thế]`
+
+## Quy tắc Bảo trì
+
+- Mọi tài liệu thiết kế nên có người sở hữu hoặc kích hoạt cập nhật.
+- Xóa các tài liệu lỗi thời hoặc đánh dấu chúng không còn dùng thay vì để chúng trôi dạt.
+- Liên kết các kế hoạch thực thi active với các tài liệu thiết kế mà chúng phụ thuộc vào.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/active/index.md b/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/active/index.md
new file mode 100644
index 0000000..986e628
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/active/index.md
@@ -0,0 +1,9 @@
+# Kế hoạch Active
+
+Giữ một tệp markdown cho mỗi kế hoạch thực thi active trong thư mục này.
+
+Mẫu tên tệp đề xuất:
+
+- `YYYY-MM-DD-chu-de-ngan.md`
+
+Mỗi kế hoạch active nên đủ hiện tại để một phiên agent mới có thể tiếp tục công việc chỉ từ kho lưu trữ.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/completed/index.md b/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/completed/index.md
new file mode 100644
index 0000000..e2b675d
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/completed/index.md
@@ -0,0 +1,3 @@
+# Kế hoạch Đã hoàn thành
+
+Di chuyển các kế hoạch đã hoàn thành ở đây thay vì xóa chúng. Các kế hoạch đã hoàn thành là một phần của bề mặt bộ nhớ kho lưu trữ và giúp các lần chạy agent sau hiểu tại sao mã trông như vậy.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/tech-debt-tracker.md b/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/tech-debt-tracker.md
new file mode 100644
index 0000000..4957b3b
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/exec-plans/tech-debt-tracker.md
@@ -0,0 +1,7 @@
+# Tracker Nợ Kỹ thuật
+
+Sử dụng tệp này cho nợ thực, đã được thừa nhận và có chủ ý bị hoãn.
+
+| Ngày | Khu vực | Nợ | Lý do Hoãn | Rủi ro | Kích hoạt Tiếp theo |
+|------|------|------|--------------|------|--------------|
+| YYYY-MM-DD | `[khu vực]` | `[nợ]` | `[lý do]` | `[rủi ro]` | `[khi nào xem xét lại]` |
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/generated/db-schema.md b/docs/vi/resources/openai-advanced/repo-template/docs/generated/db-schema.md
new file mode 100644
index 0000000..c37f268
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/generated/db-schema.md
@@ -0,0 +1,13 @@
+# Database Schema
+
+Sử dụng thư mục này cho các artifact được tạo ra hoặc dẫn xuất mà agent có thể kiểm tra mà không cần reverse-engineer chúng từ mã.
+
+## Nguồn
+
+- Được tạo từ: `[lệnh hoặc đường dẫn nguồn]`
+- Làm mới lần cuối: `YYYY-MM-DD`
+
+## Ghi chú
+
+- Không chỉnh sửa thủ công các phần được tạo ra.
+- Tạo lại tệp này khi schema bên dưới thay đổi.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/product-specs/index.md b/docs/vi/resources/openai-advanced/repo-template/docs/product-specs/index.md
new file mode 100644
index 0000000..1fb824e
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/product-specs/index.md
@@ -0,0 +1,13 @@
+# Chỉ mục Product Spec
+
+Sử dụng thư mục này cho các spec hành vi dành cho người dùng hiện tại.
+
+## Spec Active
+
+- `new-user-onboarding.md`
+
+## Quy tắc
+
+- Spec nên mô tả hành vi có thể nhìn thấy của người dùng và tiêu chí chấp nhận.
+- Nếu triển khai khác với spec, hãy cập nhật một trong số chúng trong cùng phiên.
+- Giữ chỉ mục này hiện tại để agent mới có thể nhanh chóng khám phá phạm vi sản phẩm.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/product-specs/new-user-onboarding.md b/docs/vi/resources/openai-advanced/repo-template/docs/product-specs/new-user-onboarding.md
new file mode 100644
index 0000000..5ef9973
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/product-specs/new-user-onboarding.md
@@ -0,0 +1,26 @@
+# Onboarding Người dùng Mới
+
+## Mục tiêu
+
+Mô tả trải nghiệm lần chạy đầu tiên mà người dùng mới nên có.
+
+## Điều kiện Đầu vào
+
+- `[trạng thái trước khi luồng bắt đầu]`
+
+## Luồng Người dùng
+
+1. `[bước một]`
+2. `[bước hai]`
+3. `[bước ba]`
+
+## Tiêu chí Chấp nhận
+
+- `[kết quả có thể quan sát]`
+- `[kết quả có thể quan sát]`
+- `[kết quả có thể quan sát]`
+
+## Trạng thái Lỗi
+
+- `[lỗi có thể phục hồi và phản hồi người dùng]`
+- `[trạng thái bị chặn và phương án dự phòng]`
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/references/design-system-reference-llms.txt b/docs/vi/resources/openai-advanced/repo-template/docs/references/design-system-reference-llms.txt
new file mode 100644
index 0000000..6f1c612
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/references/design-system-reference-llms.txt
@@ -0,0 +1,9 @@
+Purpose: store model-friendly reference material for the design system.
+
+Suggested contents:
+- component naming rules
+- spacing and typography tokens
+- state variants
+- accessibility expectations
+
+Keep this file concise and refresh it when the upstream design system changes.
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/references/nixpacks-llms.txt b/docs/vi/resources/openai-advanced/repo-template/docs/references/nixpacks-llms.txt
new file mode 100644
index 0000000..c30cc9c
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/references/nixpacks-llms.txt
@@ -0,0 +1,8 @@
+Purpose: store a clean agent-readable extract of the deployment or packaging
+rules your repository depends on.
+
+Suggested contents:
+- build entrypoints
+- runtime assumptions
+- environment variable expectations
+- common failure signatures
diff --git a/docs/vi/resources/openai-advanced/repo-template/docs/references/uv-llms.txt b/docs/vi/resources/openai-advanced/repo-template/docs/references/uv-llms.txt
new file mode 100644
index 0000000..f2ceba9
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/docs/references/uv-llms.txt
@@ -0,0 +1,8 @@
+Purpose: store a compact reference for your Python package and environment
+workflow when `uv` or similar tooling matters to the repo.
+
+Suggested contents:
+- install and sync commands
+- lockfile policy
+- virtualenv expectations
+- verification commands
diff --git a/docs/vi/resources/openai-advanced/repo-template/index.md b/docs/vi/resources/openai-advanced/repo-template/index.md
new file mode 100644
index 0000000..b7779f8
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/repo-template/index.md
@@ -0,0 +1,21 @@
+# Mẫu Repo Nâng cao
+
+Sao chép starter này vào một kho lưu trữ thực khi bạn muốn một bề mặt tài liệu agent-first theo phong cách OpenAI thay vì chỉ một harness tối giản.
+
+## Thứ tự Sao chép
+
+1. Sao chép `AGENTS.md` và `ARCHITECTURE.md` vào thư mục gốc repo.
+2. Sao chép toàn bộ cây `docs/`.
+3. Điền vào `docs/PRODUCT_SENSE.md`, `docs/QUALITY_SCORE.md`, và `docs/RELIABILITY.md` trước tiên.
+4. Thêm kế hoạch active đầu tiên của bạn trong `docs/exec-plans/active/`.
+5. Giữ các tệp đầu vào ngắn và định tuyến chi tiết vào các tài liệu được liên kết.
+
+## Mẫu Này Tối ưu hóa Cho
+
+- ngữ cảnh cục bộ repo lâu bền
+- tiết lộ tiến triển thay vì một tệp hướng dẫn khổng lồ
+- vòng đời kế hoạch rõ ràng
+- theo dõi chất lượng theo thời gian
+- ranh giới có thể đọc được cho agent và con người
+
+Coi mỗi tệp ở đây là một starter. Thay thế các placeholder, ví dụ và lệnh mẫu bằng các đặc thù dự án thực của bạn trước khi dựa vào nó.
diff --git a/docs/vi/resources/openai-advanced/sops/chrome-devtools-validation-loop.md b/docs/vi/resources/openai-advanced/sops/chrome-devtools-validation-loop.md
new file mode 100644
index 0000000..7b65baf
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/sops/chrome-devtools-validation-loop.md
@@ -0,0 +1,48 @@
+# SOP: Vòng lặp Xác minh Chrome DevTools
+
+Sử dụng SOP này khi công việc UI phụ thuộc vào tương tác runtime thực tế và screenshot, trạng thái DOM và đầu ra console quan trọng hơn chỉ kiểm tra mã.
+
+## Mục tiêu
+
+Biến xác minh UI thành một vòng lặp tương tác có thể lặp lại mà agent có thể chạy cho đến khi journey sạch sẽ.
+
+## Vòng lặp Cốt lõi
+
+1. Chọn trang mục tiêu hoặc phiên bản ứng dụng.
+2. Xóa noise console lỗi thời.
+3. Chụp trạng thái TRƯỚC.
+4. Kích hoạt đường dẫn UI.
+5. Quan sát các sự kiện runtime trong khi tương tác.
+6. Chụp trạng thái SAU.
+7. Áp dụng sửa chữa và khởi động lại ứng dụng nếu cần.
+8. Chạy lại xác minh cho đến khi journey sạch sẽ.
+
+## Đầu vào Bắt buộc
+
+- một lệnh khởi động ổn định
+- một UI journey có thể tái tạo
+- một cách để snapshot DOM, console hoặc screenshot
+- một quy tắc cho những gì được tính là "sạch sẽ"
+
+## SOP Thực thi
+
+1. Viết journey mục tiêu trong kế hoạch active.
+2. Định nghĩa thành công theo các thuật ngữ có thể quan sát: văn bản hiện diện, nút được bật, lỗi biến mất, console sạch, yêu cầu thành công.
+3. Snapshot trạng thái ban đầu trước khi tương tác.
+4. Kích hoạt chính xác một đường dẫn mỗi lần.
+5. Ghi lại các sự kiện runtime, thay đổi DOM và đầu ra có thể nhìn thấy.
+6. Nếu journey thất bại, hãy sửa lớp chịu trách nhiệm nhỏ nhất và khởi động lại.
+7. Chạy lại cùng đường dẫn và so sánh bằng chứng TRƯỚC/SAU.
+
+## Tiêu chí Sạch sẽ
+
+- trạng thái có thể nhìn thấy dự định là hiện diện
+- các lỗi không mong đợi vắng mặt
+- noise console được hiểu hoặc đã xóa
+- chạy lại cùng đường dẫn cho cùng kết quả
+
+## Artifact Repo Cần Cập nhật
+
+- kế hoạch thực thi active
+- `docs/RELIABILITY.md` nếu journey trở thành một golden path
+- product spec nếu hành vi có thể nhìn thấy thay đổi
diff --git a/docs/vi/resources/openai-advanced/sops/encode-knowledge-into-repo.md b/docs/vi/resources/openai-advanced/sops/encode-knowledge-into-repo.md
new file mode 100644
index 0000000..bf60b46
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/sops/encode-knowledge-into-repo.md
@@ -0,0 +1,42 @@
+# SOP: Mã hóa Kiến thức Ẩn vào Repo
+
+Sử dụng SOP này khi ngữ cảnh quan trọng vẫn còn trong Google Docs, luồng chat, ticket hoặc trong đầu của mọi người.
+
+## Mục tiêu
+
+Làm cho kiến thức ẩn với agent có thể khám phá được trong codebase để một phiên mới có thể hành động dựa trên nó mà không cần dựa vào hội thoại trước.
+
+## Tín hiệu Kích hoạt
+
+- Agent tiếp tục hỏi cách hệ thống hoạt động.
+- Con người nói "chúng tôi đã quyết định điều này trong Slack" hoặc "làm theo những gì X nói tuần trước."
+- Các review tham chiếu đến các quy tắc sản phẩm hoặc bảo mật không được viết trong repo.
+- Các phiên mới lặp lại công việc khám phá đáng lẽ đã được giải quyết.
+
+## SOP Thực thi
+
+1. Liệt kê các nguồn kiến thức ẩn: tài liệu, chat, quy tắc team mặc nhiên, quyết định bằng miệng.
+2. Cho mỗi nguồn, hỏi: đây là kiến trúc, hành vi sản phẩm, chính sách bảo mật, kỳ vọng độ tin cậy, ngữ cảnh kế hoạch hay tài liệu tham khảo?
+3. Mã hóa nó vào artifact repo phù hợp:
+ - kiến trúc -> `ARCHITECTURE.md`
+ - hành vi sản phẩm -> `docs/product-specs/`
+ - lý luận thiết kế -> `docs/design-docs/`
+ - trạng thái thực thi -> `docs/exec-plans/`
+ - tài liệu tham khảo bên ngoài lặp đi lặp lại -> `docs/references/`
+ - kỳ vọng chất lượng hoặc độ tin cậy -> `docs/QUALITY_SCORE.md` hoặc `docs/RELIABILITY.md`
+4. Thay thế các phát biểu mơ hồ bằng cách diễn đạt hữu ích về mặt vận hành.
+5. Xóa hoặc không dùng các bản sao lỗi thời để repo giữ một sự thật có thể khám phá.
+
+## Quy tắc Mã hóa Tốt
+
+- Viết cho khả năng khám phá, không phải cho sự hoàn chỉnh về văn học.
+- Ưu tiên các tài liệu ngắn với tên tệp rõ ràng.
+- Liên kết các artifact liên quan với nhau.
+- Lưu trữ các quy tắc lâu bền, không phải bản ghi cuộc họp.
+- Cập nhật repo trong cùng phiên mà quyết định được đưa ra.
+
+## Định nghĩa Hoàn thành
+
+- Một agent mới có thể khám phá quy tắc liên quan mà không cần hỏi con người.
+- Cùng một sự thật không bị phân tán qua nhiều tệp mâu thuẫn.
+- Artifact mới nằm gần mã hoặc workflow mà nó điều chỉnh.
diff --git a/docs/vi/resources/openai-advanced/sops/index.md b/docs/vi/resources/openai-advanced/sops/index.md
new file mode 100644
index 0000000..7939a30
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/sops/index.md
@@ -0,0 +1,25 @@
+[English Version →](../../../../en/resources/openai-advanced/sops/) | [中文版本 →](../../../../zh/resources/openai-advanced/sops/)
+
+# Thư viện SOP
+
+Các quy trình vận hành chuẩn từng bước để thiết lập và vận hành harness.
+
+## SOP Có sẵn
+
+- [`layered-domain-architecture.md`](./layered-domain-architecture.md):
+ thiết lập kiến trúc domain phân lớp để agent không vi phạm ranh giới
+- [`encode-knowledge-into-repo.md`](./encode-knowledge-into-repo.md):
+ di chuyển kiến thức ẩn từ chat, tài liệu và bộ nhớ vào các tệp cục bộ repo
+- [`observability-feedback-loop.md`](./observability-feedback-loop.md):
+ cung cấp cho agent log, metrics, trace và vòng lặp debug có thể lặp lại
+- [`chrome-devtools-validation-loop.md`](./chrome-devtools-validation-loop.md):
+ sử dụng tự động hóa browser và snapshot để xác minh hành vi UI cho đến khi sạch
+
+## Cách Sử dụng Chúng
+
+1. Chọn SOP phù hợp với điểm nghẽn hiện tại của bạn.
+2. Sử dụng danh sách kiểm tra để thiết lập các artifact hoặc công cụ còn thiếu.
+3. Mã hóa các quy tắc kết quả vào các tài liệu `repo-template/` đã sao chép của bạn.
+4. Chuyển đổi các nhận xét review lặp đi lặp lại thành kiểm tra, script hoặc guardrail.
+
+Những điều này không phải để được tuân theo mù quáng. Chúng được thiết kế để làm cho harness có thể đọc được, có thể thực thi và có thể lặp lại hơn.
diff --git a/docs/vi/resources/openai-advanced/sops/layered-domain-architecture.md b/docs/vi/resources/openai-advanced/sops/layered-domain-architecture.md
new file mode 100644
index 0000000..13bf838
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/sops/layered-domain-architecture.md
@@ -0,0 +1,47 @@
+# SOP: Kiến trúc Domain Phân lớp
+
+Sử dụng SOP này khi agent tiếp tục vi phạm ranh giới, sao chép logic qua các lớp, hoặc tạo ra mã khó review sau một vài phiên.
+
+## Mục tiêu
+
+Làm cho ranh giới domain đủ rõ ràng để agent có thể di chuyển nhanh mà không âm thầm làm xuống cấp cấu trúc.
+
+## Mô hình Mục tiêu
+
+Trong một domain kinh doanh, ưu tiên luồng định hướng này:
+
+`Types -> Config -> Repo -> Service -> Runtime -> UI`
+
+Các mối quan tâm xuyên suốt nên đi vào qua các provider hoặc adapter rõ ràng. Các utils dùng chung nằm bên ngoài domain và không nên tích lũy logic domain.
+
+## Danh sách Kiểm tra Thiết lập
+
+- Định nghĩa các domain hiện tại trong `ARCHITECTURE.md`.
+- Viết các hướng phụ thuộc được phép trong `ARCHITECTURE.md`.
+- Ghi lại các giao diện xuyên suốt như auth, telemetry và external API.
+- Thêm một ghi chú ngắn cho vi phạm ranh giới khó nhất hiện tại.
+- Quyết định những gì nên được thực thi cơ học bởi lint, test hoặc script.
+
+## SOP Thực thi
+
+1. Ánh xạ codebase thành các domain trước khi chạm vào phong cách triển khai.
+2. Cho mỗi domain, xác định chuỗi lớp được phép.
+3. Xác định tất cả các mối quan tâm xuyên suốt và định tuyến chúng qua các provider hoặc adapter.
+4. Di chuyển logic dùng chung mơ hồ sang domain sở hữu hoặc sang utils thực sự chung chung.
+5. Ghi lại các quy tắc trong `ARCHITECTURE.md`.
+6. Thêm một guardrail có thể thực thi cho vi phạm có chi phí cao nhất.
+7. Cập nhật điểm chất lượng sau khi thay đổi.
+
+## Định nghĩa Hoàn thành
+
+- Một agent mới có thể biết lớp nào sở hữu một thay đổi.
+- Mã UI không còn tiếp cận vào repo hoặc side effect bên ngoài trực tiếp.
+- Các mối quan tâm xuyên suốt có các điểm đầu vào được đặt tên.
+- Ít nhất một ranh giới quan trọng được thực thi cơ học.
+
+## Artifact Repo Cần Cập nhật
+
+- `ARCHITECTURE.md`
+- `docs/QUALITY_SCORE.md`
+- `docs/design-docs/` khi lý luận thay đổi
+- `docs/PLANS.md` hoặc kế hoạch thực thi active
diff --git a/docs/vi/resources/openai-advanced/sops/observability-feedback-loop.md b/docs/vi/resources/openai-advanced/sops/observability-feedback-loop.md
new file mode 100644
index 0000000..9933119
--- /dev/null
+++ b/docs/vi/resources/openai-advanced/sops/observability-feedback-loop.md
@@ -0,0 +1,41 @@
+# SOP: Vòng lặp Phản hồi Observability
+
+Sử dụng SOP này khi debug chậm, agent tiếp tục tuyên bố thành công mà không có bằng chứng, hoặc hành vi runtime khó kiểm tra hơn bản thân mã.
+
+## Mục tiêu
+
+Cung cấp cho agent một vòng lặp phản hồi cục bộ qua log, metrics, trace và workload có thể chạy để nó có thể lý luận từ thực thi, không chỉ từ kiểm tra mã.
+
+## Stack Tối thiểu
+
+- ứng dụng phát ra các log có cấu trúc
+- ứng dụng phát ra metrics và trace khi khả thi
+- lớp fan-out hoặc thu thập cục bộ
+- giao diện truy vấn cho log, metrics và trace
+- workload hoặc user journey có thể lặp lại để chạy lại sau mỗi thay đổi
+
+## SOP Thực thi
+
+1. Định nghĩa các journey runtime vàng quan trọng nhất.
+2. Thêm các log có cấu trúc vào khởi động và đường dẫn quan trọng.
+3. Thêm metrics cho độ trễ, số lần thất bại hoặc độ sâu hàng đợi khi hữu ích.
+4. Thêm trace hoặc marker timing cho các luồng chậm hoặc nhiều bước.
+5. Làm cho các tín hiệu có thể truy vấn từ môi trường dev cục bộ.
+6. Cung cấp cho agent một workload hoặc kịch bản có thể lặp lại để chạy lại.
+7. Yêu cầu vòng lặp: truy vấn -> tương quan -> lý luận -> triển khai -> khởi động lại -> chạy lại -> xác minh.
+
+## Danh sách Kiểm tra Phiên Debug
+
+- Điều gì đã thất bại?
+- Tín hiệu nào chứng minh sự thất bại?
+- Lớp nào sở hữu sự thất bại?
+- Điều gì thay đổi sau khi sửa?
+- Ứng dụng có khởi động lại sạch sẽ không?
+- Cùng workload có vượt qua sau khi chạy lại không?
+
+## Định nghĩa Hoàn thành
+
+- Agent có thể giải thích một chế độ thất bại từ bằng chứng runtime.
+- Cùng workload có thể được chạy lại sau mỗi thay đổi.
+- Khởi động lại và chạy lại là một phần của vòng lặp tác vụ bình thường.
+- Các tín hiệu độ tin cậy được ghi lại trong `docs/RELIABILITY.md`.
diff --git a/docs/vi/resources/reference/coding-agent-startup-flow.md b/docs/vi/resources/reference/coding-agent-startup-flow.md
new file mode 100644
index 0000000..bfc15ae
--- /dev/null
+++ b/docs/vi/resources/reference/coding-agent-startup-flow.md
@@ -0,0 +1,33 @@
+# Luồng Khởi động Coding Agent
+
+Sử dụng cái này ở đầu mỗi phiên sau khi khởi tạo hoàn thành.
+
+## Mẫu Khởi động Cố định
+
+1. Chạy `pwd` và xác nhận thư mục gốc kho lưu trữ.
+2. Đọc `claude-progress.md`.
+3. Đọc `feature_list.json`.
+4. Xem lại các commit gần đây bằng `git log --oneline -5`.
+5. Chạy `./init.sh`.
+6. Chạy một đường dẫn smoke hoặc end-to-end baseline.
+7. Nếu baseline bị hỏng, hãy sửa điều đó trước.
+8. Chọn tính năng chưa hoàn thành có mức ưu tiên cao nhất.
+9. Chỉ làm việc trên tính năng đó cho đến khi nó được xác minh hoặc bị chặn rõ ràng.
+
+## Tại sao Thứ tự này Quan trọng
+
+- `pwd` ngăn chặn việc vô tình làm việc trong thư mục sai.
+- các tệp tiến độ và tính năng khôi phục trạng thái lâu bền trước khi bắt đầu chỉnh sửa mới.
+- các commit gần đây giải thích những gì đã thay đổi gần đây nhất.
+- `init.sh` chuẩn hóa khởi động thay vì dựa vào bộ nhớ.
+- xác minh baseline bắt các trạng thái khởi đầu bị hỏng trước khi công việc mới che giấu chúng.
+
+## Gương Cuối Phiên
+
+Cùng một phiên nên kết thúc bằng cách:
+
+1. ghi lại tiến độ
+2. cập nhật trạng thái tính năng
+3. viết bàn giao nếu cần
+4. commit công việc an toàn
+5. để lại đường dẫn khởi động lại sạch sẽ
diff --git a/docs/vi/resources/reference/index.md b/docs/vi/resources/reference/index.md
new file mode 100644
index 0000000..c8c5423
--- /dev/null
+++ b/docs/vi/resources/reference/index.md
@@ -0,0 +1,19 @@
+[English Version →](../../../en/resources/reference/) | [中文版本 →](../../../zh/resources/reference/)
+
+# Tài liệu Tham khảo Tiếng Việt
+
+Các ghi chú này giải thích cách sử dụng các mẫu như một harness làm việc thực thụ thay vì một đống tệp rời rạc.
+
+## Ghi chú Tham khảo
+
+- [`method-map.md`](./method-map.md): ánh xạ các chế độ lỗi chạy lâu phổ biến sang artifact hoặc chính sách giải quyết chúng đầu tiên
+- [`initializer-agent-playbook.md`](./initializer-agent-playbook.md): những gì initializer nên để lại trước khi công việc tính năng bắt đầu
+- [`coding-agent-startup-flow.md`](./coding-agent-startup-flow.md): luồng bắt đầu phiên cố định cho các lần chạy coding sau
+- [`prompt-calibration.md`](./prompt-calibration.md): cách giữ cho hướng dẫn gốc sắc nét mà không làm chúng phình to và dễ vỡ
+
+## Thứ tự Đọc Đề nghị
+
+1. `method-map.md`
+2. `initializer-agent-playbook.md`
+3. `coding-agent-startup-flow.md`
+4. `prompt-calibration.md`
diff --git a/docs/vi/resources/reference/initializer-agent-playbook.md b/docs/vi/resources/reference/initializer-agent-playbook.md
new file mode 100644
index 0000000..7932c4e
--- /dev/null
+++ b/docs/vi/resources/reference/initializer-agent-playbook.md
@@ -0,0 +1,35 @@
+# Playbook Initializer Agent
+
+Sử dụng playbook này cho phiên nghiêm túc đầu tiên trong một kho lưu trữ, trước khi công việc tính năng tăng dần bắt đầu.
+
+## Mục tiêu
+
+Tạo ra một bề mặt vận hành ổn định để các phiên sau có thể triển khai hành vi mà không cần phải suy ra lại các lệnh khởi động, trạng thái hiện tại, hoặc ranh giới tác vụ.
+
+## Kết quả Đầu ra Bắt buộc
+
+Initializer nên để lại ít nhất các artifact này:
+
+- một tệp hướng dẫn gốc như `AGENTS.md` hoặc `CLAUDE.md`
+- một bề mặt tính năng có thể đọc bởi máy như `feature_list.json`
+- một artifact tiến độ lâu bền như `claude-progress.md`
+- một helper khởi động chuẩn như `init.sh`
+- một commit cơ sở an toàn ban đầu ghi lại scaffold cơ sở
+
+## Danh sách Kiểm tra
+
+1. Định nghĩa đường dẫn khởi động chuẩn.
+2. Định nghĩa đường dẫn xác minh chuẩn.
+3. Tạo nhật ký tiến độ và ghi lại trạng thái khởi đầu.
+4. Phân chia công việc thành các tính năng rõ ràng với trạng thái.
+5. Tạo commit baseline sạch đầu tiên.
+
+## Bài kiểm tra Thành công
+
+Một phiên mới không có ngữ cảnh chat trước đó nên có thể trả lời:
+
+- kho lưu trữ này làm gì
+- cách khởi động nó
+- cách xác minh nó
+- những gì chưa hoàn thành
+- bước tốt nhất tiếp theo là gì
diff --git a/docs/vi/resources/reference/method-map.md b/docs/vi/resources/reference/method-map.md
new file mode 100644
index 0000000..f19b01a
--- /dev/null
+++ b/docs/vi/resources/reference/method-map.md
@@ -0,0 +1,16 @@
+# Bản đồ Phương pháp
+
+Bảng này ánh xạ các chế độ lỗi coding-agent chạy lâu phổ biến nhất sang artifact hoặc quy tắc vận hành thường sửa chúng đầu tiên.
+
+| Chế độ lỗi | Trông như thế nào trong thực tế | Sửa chữa chính | Artifact hỗ trợ |
+| --- | --- | --- | --- |
+| Nhầm lẫn cold-start | Một phiên mới dành hầu hết thời gian để khám phá lại cài đặt và trạng thái | Biến kho lưu trữ thành hệ thống ghi chép | `claude-progress.md` |
+| Phình phạm vi | Agent bắt đầu nhiều tính năng và không hoàn thành sạch cái nào | Giới hạn phạm vi active | `feature_list.json` |
+| Hoàn thành sớm | Agent tuyên bố xong sau khi chỉnh sửa mã nhưng trước khi có bằng chứng có thể chạy | Ràng buộc hoàn thành với bằng chứng | `clean-state-checklist.md` |
+| Khởi động dễ vỡ | Mỗi phiên học lại cách khởi động dự án | Chuẩn hóa cài đặt và xác minh | `init.sh` |
+| Bàn giao yếu | Phiên tiếp theo không thể biết những gì đã được xác minh, bị hỏng, hoặc là tiếp theo | Kết thúc với bàn giao rõ ràng | `session-handoff.md` |
+| Review chủ quan | Chất lượng review phụ thuộc vào sở thích hoặc trí nhớ | Tính điểm đầu ra bằng các hạng mục cố định | `evaluator-rubric.md` |
+
+## Nguyên tắc Vận hành
+
+Thêm artifact nhỏ nhất giải quyết trực tiếp chế độ lỗi đã quan sát. Tránh giải quyết mọi vấn đề độ tin cậy bằng cách đổ thêm văn bản vào một tệp hướng dẫn toàn cục.
diff --git a/docs/vi/resources/reference/prompt-calibration.md b/docs/vi/resources/reference/prompt-calibration.md
new file mode 100644
index 0000000..9369ca2
--- /dev/null
+++ b/docs/vi/resources/reference/prompt-calibration.md
@@ -0,0 +1,23 @@
+# Hiệu chỉnh Prompt
+
+Hướng dẫn gốc nên định nghĩa khung vận hành, không phải mọi nước đi có thể.
+
+## Giữ trong Tệp Gốc
+
+- mục đích và phạm vi kho lưu trữ
+- đường dẫn khởi động
+- đường dẫn xác minh
+- các ràng buộc không thể thương lượng
+- các artifact trạng thái bắt buộc
+- quy tắc cuối phiên
+
+## Chuyển Ra Khỏi Tệp Gốc
+
+- các edge case lịch sử dài
+- chi tiết triển khai cụ thể theo chủ đề
+- ghi chú kiến trúc cục bộ thuộc về gần mã
+- các ví dụ chỉ áp dụng cho một hệ thống con
+
+## Quy tắc Làm việc
+
+Tệp gốc nên giúp một phiên mới định hướng nhanh chóng. Nếu tệp đang trở thành bãi rác cho mọi lỗi trong quá khứ, hãy chia chi tiết thành các tài liệu nhỏ hơn và liên kết đến chúng thay thế.
diff --git a/docs/vi/resources/templates/AGENTS.md b/docs/vi/resources/templates/AGENTS.md
new file mode 100644
index 0000000..a7216be
--- /dev/null
+++ b/docs/vi/resources/templates/AGENTS.md
@@ -0,0 +1,50 @@
+# AGENTS.md
+
+Kho lưu trữ này được thiết kế cho công việc coding-agent chạy lâu. Mục tiêu không phải là tối đa hóa đầu ra mã thô. Mục tiêu là để lại repo ở trạng thái mà phiên tiếp theo có thể tiếp tục mà không cần đoán.
+
+## Quy trình Khởi động
+
+Trước khi viết mã:
+
+1. Xác nhận thư mục làm việc bằng `pwd`.
+2. Đọc `claude-progress.md` để biết trạng thái đã xác minh mới nhất và bước tiếp theo.
+3. Đọc `feature_list.json` và chọn tính năng chưa hoàn thành có mức ưu tiên cao nhất.
+4. Xem lại các commit gần đây bằng `git log --oneline -5`.
+5. Chạy `./init.sh`.
+6. Chạy xác minh smoke hoặc end-to-end cần thiết trước khi bắt đầu công việc mới.
+
+Nếu xác minh baseline đã thất bại, hãy sửa điều đó trước. Không chồng công việc tính năng mới lên trên trạng thái khởi đầu bị hỏng.
+
+## Quy tắc Làm việc
+
+- Làm việc trên một tính năng tại một thời điểm.
+- Không đánh dấu tính năng hoàn thành chỉ vì mã đã được thêm vào.
+- Giữ các thay đổi trong phạm vi tính năng đã chọn trừ khi có sự cố chặn cần sửa hỗ trợ hẹp.
+- Không thay đổi ngầm các quy tắc xác minh trong khi triển khai.
+- Ưu tiên các artifact repo lâu bền hơn tóm tắt chat.
+
+## Artifact Bắt buộc
+
+- `feature_list.json`: nguồn sự thật cho trạng thái tính năng
+- `claude-progress.md`: nhật ký phiên và trạng thái đã xác minh hiện tại
+- `init.sh`: đường dẫn khởi động và xác minh chuẩn
+- `session-handoff.md`: bàn giao ngắn gọn tùy chọn cho các phiên lớn hơn
+
+## Định nghĩa Hoàn thành
+
+Một tính năng chỉ xong khi tất cả những điều sau đây là đúng:
+
+- hành vi mục tiêu đã được triển khai
+- xác minh cần thiết đã thực sự chạy
+- bằng chứng được ghi lại trong `feature_list.json` hoặc `claude-progress.md`
+- kho lưu trữ vẫn có thể khởi động lại từ đường dẫn khởi động chuẩn
+
+## Cuối Phiên
+
+Trước khi kết thúc phiên:
+
+1. Cập nhật `claude-progress.md`.
+2. Cập nhật `feature_list.json`.
+3. Ghi lại bất kỳ rủi ro hoặc sự cố chặn chưa được giải quyết nào.
+4. Commit với thông điệp mô tả khi công việc ở trạng thái an toàn.
+5. Để repo đủ sạch để phiên tiếp theo có thể chạy `./init.sh` ngay lập tức.
diff --git a/docs/vi/resources/templates/CLAUDE.md b/docs/vi/resources/templates/CLAUDE.md
new file mode 100644
index 0000000..f78501f
--- /dev/null
+++ b/docs/vi/resources/templates/CLAUDE.md
@@ -0,0 +1,43 @@
+# CLAUDE.md
+
+Bạn đang làm việc trong một kho lưu trữ được thiết kế cho công việc triển khai chạy lâu. Ưu tiên hoàn thành đáng tin cậy, tính liên tục qua các phiên, và xác minh rõ ràng hơn tốc độ.
+
+## Vòng lặp Vận hành
+
+Ở đầu mỗi phiên:
+
+1. Chạy `pwd` và xác nhận bạn đang ở trong thư mục gốc kho lưu trữ dự kiến.
+2. Đọc `claude-progress.md`.
+3. Đọc `feature_list.json`.
+4. Xem lại các commit gần đây bằng `git log --oneline -5`.
+5. Chạy `./init.sh`.
+6. Kiểm tra xem đường dẫn smoke hoặc end-to-end baseline có đã bị hỏng chưa.
+
+Sau đó chọn chính xác một tính năng chưa hoàn thành và chỉ làm việc trên tính năng đó cho đến khi bạn xác minh nó hoặc ghi lại lý do tại sao nó bị chặn.
+
+## Quy tắc
+
+- Một tính năng active tại một thời điểm.
+- Không tuyên bố hoàn thành mà không có bằng chứng có thể chạy được.
+- Không viết lại feature list để ẩn công việc chưa hoàn thành.
+- Không xóa hoặc làm yếu các test chỉ để tác vụ có vẻ hoàn thành.
+- Sử dụng các artifact kho lưu trữ như hệ thống ghi chép.
+
+## Tệp Bắt buộc
+
+- `feature_list.json`
+- `claude-progress.md`
+- `init.sh`
+- `session-handoff.md` khi bàn giao ngắn gọn hữu ích
+
+## Cổng Hoàn thành
+
+Một tính năng chỉ có thể chuyển sang `passing` sau khi xác minh cần thiết thành công và kết quả được ghi lại.
+
+## Trước khi Bạn Dừng
+
+1. Cập nhật nhật ký tiến độ.
+2. Cập nhật trạng thái tính năng.
+3. Ghi lại những gì vẫn bị hỏng hoặc chưa được xác minh.
+4. Commit khi kho lưu trữ an toàn để tiếp tục.
+5. Để lại đường dẫn khởi động lại sạch sẽ cho phiên tiếp theo.
diff --git a/docs/vi/resources/templates/claude-progress.md b/docs/vi/resources/templates/claude-progress.md
new file mode 100644
index 0000000..1a2bb46
--- /dev/null
+++ b/docs/vi/resources/templates/claude-progress.md
@@ -0,0 +1,35 @@
+# Nhật ký Tiến độ
+
+## Trạng thái Đã xác minh Hiện tại
+
+- Thư mục gốc kho lưu trữ:
+- Đường dẫn khởi động chuẩn:
+- Đường dẫn xác minh chuẩn:
+- Tính năng chưa hoàn thành có mức ưu tiên cao nhất hiện tại:
+- Sự cố chặn hiện tại:
+
+## Nhật ký Phiên
+
+### Phiên 001
+
+- Ngày:
+- Mục tiêu:
+- Đã hoàn thành:
+- Xác minh đã chạy:
+- Bằng chứng đã ghi lại:
+- Commit:
+- Tệp hoặc artifact đã cập nhật:
+- Rủi ro đã biết hoặc vấn đề chưa được giải quyết:
+- Bước tốt nhất tiếp theo:
+
+### Phiên 002
+
+- Ngày:
+- Mục tiêu:
+- Đã hoàn thành:
+- Xác minh đã chạy:
+- Bằng chứng đã ghi lại:
+- Commit:
+- Tệp hoặc artifact đã cập nhật:
+- Rủi ro đã biết hoặc vấn đề chưa được giải quyết:
+- Bước tốt nhất tiếp theo:
diff --git a/docs/vi/resources/templates/clean-state-checklist.md b/docs/vi/resources/templates/clean-state-checklist.md
new file mode 100644
index 0000000..c44e332
--- /dev/null
+++ b/docs/vi/resources/templates/clean-state-checklist.md
@@ -0,0 +1,8 @@
+# Danh sách Kiểm tra Trạng thái Sạch
+
+- [ ] Đường dẫn khởi động chuẩn vẫn hoạt động.
+- [ ] Đường dẫn xác minh chuẩn vẫn chạy được.
+- [ ] Tiến độ hiện tại được ghi lại trong nhật ký tiến độ.
+- [ ] Trạng thái tính năng phản ánh những gì thực sự đang vượt qua so với chưa được xác minh.
+- [ ] Không có bước làm dở nào bị bỏ lại mà không được ghi lại.
+- [ ] Phiên tiếp theo có thể tiếp tục mà không cần sửa chữa thủ công.
diff --git a/docs/vi/resources/templates/evaluator-rubric.md b/docs/vi/resources/templates/evaluator-rubric.md
new file mode 100644
index 0000000..f048f57
--- /dev/null
+++ b/docs/vi/resources/templates/evaluator-rubric.md
@@ -0,0 +1,24 @@
+# Rubric Evaluator
+
+Sử dụng rubric này sau khi triển khai và trước khi chấp nhận cuối cùng.
+
+| Hạng mục | Câu hỏi | Điểm (0-2) | Ghi chú |
+| --- | --- | --- | --- |
+| Tính đúng đắn | Hành vi đã triển khai có khớp với tính năng được yêu cầu không? | | |
+| Xác minh | Các kiểm tra bắt buộc có thực sự chạy, với bằng chứng không? | | |
+| Kỷ luật phạm vi | Phiên có ở trong phạm vi tính năng đã chọn không? | | |
+| Độ tin cậy | Kết quả có tồn tại qua khởi động lại hoặc chạy lại mà không cần sửa chữa không? | | |
+| Khả năng bảo trì | Mã và tài liệu có đủ rõ ràng cho phiên tiếp theo không? | | |
+| Sẵn sàng bàn giao | Một phiên mới có thể tiếp tục công việc chỉ từ các artifact repo không? | | |
+
+## Kết luận
+
+- Chấp nhận
+- Sửa đổi
+- Chặn
+
+## Hành động Tiếp theo Bắt buộc
+
+- Bằng chứng còn thiếu:
+- Sửa chữa bắt buộc:
+- Kích hoạt review tiếp theo:
diff --git a/docs/vi/resources/templates/feature_list.json b/docs/vi/resources/templates/feature_list.json
new file mode 100644
index 0000000..138adc6
--- /dev/null
+++ b/docs/vi/resources/templates/feature_list.json
@@ -0,0 +1,64 @@
+{
+ "project": "replace-with-project-name",
+ "last_updated": "YYYY-MM-DD",
+ "rules": {
+ "single_active_feature": true,
+ "passing_requires_evidence": true,
+ "do_not_skip_verification": true
+ },
+ "status_legend": {
+ "not_started": "Work has not begun.",
+ "in_progress": "The feature is the current active task.",
+ "blocked": "Work cannot continue until a documented blocker is resolved.",
+ "passing": "Required verification has passed and evidence is recorded."
+ },
+ "features": [
+ {
+ "id": "chat-001",
+ "priority": 1,
+ "area": "chat",
+ "title": "Create a new conversation",
+ "user_visible_behavior": "A user can click New Chat and see a fresh empty conversation.",
+ "status": "not_started",
+ "verification": [
+ "Open the app.",
+ "Click New Chat.",
+ "Verify a new conversation appears in the sidebar.",
+ "Verify the main panel shows an empty conversation state."
+ ],
+ "evidence": [],
+ "notes": ""
+ },
+ {
+ "id": "chat-002",
+ "priority": 2,
+ "area": "chat",
+ "title": "Send a message in the current conversation",
+ "user_visible_behavior": "A user can submit a message and see it appear in the active thread.",
+ "status": "not_started",
+ "verification": [
+ "Open an existing conversation.",
+ "Type a message into the input.",
+ "Submit the message.",
+ "Verify the new message appears in the thread."
+ ],
+ "evidence": [],
+ "notes": ""
+ },
+ {
+ "id": "chat-003",
+ "priority": 3,
+ "area": "chat",
+ "title": "Persist the active conversation list",
+ "user_visible_behavior": "A user sees previously created conversations after restarting the app.",
+ "status": "not_started",
+ "verification": [
+ "Create two conversations.",
+ "Restart the app.",
+ "Verify both conversations still appear in the sidebar."
+ ],
+ "evidence": [],
+ "notes": ""
+ }
+ ]
+}
diff --git a/docs/vi/resources/templates/index.md b/docs/vi/resources/templates/index.md
new file mode 100644
index 0000000..31cdd3b
--- /dev/null
+++ b/docs/vi/resources/templates/index.md
@@ -0,0 +1,15 @@
+[English Version →](../../../en/resources/templates/) | [中文版本 →](../../../zh/resources/templates/)
+
+# Thư viện Mẫu
+
+Các mẫu harness sẵn sàng sử dụng cho các dự án agent.
+
+## Mẫu Có sẵn
+
+- [AGENTS.md](./AGENTS.md) — Tệp hướng dẫn agent chuẩn
+- [CLAUDE.md](./CLAUDE.md) — Biến thể dành cho Claude Code
+- [claude-progress.md](./claude-progress.md) — Nhật ký tiến độ phiên
+- [clean-state-checklist.md](./clean-state-checklist.md) — Danh sách kiểm tra trạng thái sạch khi thoát phiên
+- [evaluator-rubric.md](./evaluator-rubric.md) — Rubric tính điểm evaluator
+- [quality-document.md](./quality-document.md) — Mẫu tài liệu chất lượng
+- [session-handoff.md](./session-handoff.md) — Mẫu bàn giao phiên ngắn gọn
diff --git a/docs/vi/resources/templates/init.sh b/docs/vi/resources/templates/init.sh
new file mode 100755
index 0000000..d7522d6
--- /dev/null
+++ b/docs/vi/resources/templates/init.sh
@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$ROOT_DIR"
+
+# Replace these commands with the correct commands for your repository.
+INSTALL_CMD=(npm install)
+VERIFY_CMD=(npm test)
+START_CMD=(npm run dev)
+
+echo "==> Working directory: $PWD"
+echo "==> Syncing dependencies"
+"${INSTALL_CMD[@]}"
+
+echo "==> Running baseline verification"
+"${VERIFY_CMD[@]}"
+
+echo "==> Startup command"
+printf ' %q' "${START_CMD[@]}"
+printf '\n'
+
+if [ "${RUN_START_COMMAND:-0}" = "1" ]; then
+ echo "==> Starting the app"
+ exec "${START_CMD[@]}"
+fi
+
+echo "Set RUN_START_COMMAND=1 if you want init.sh to launch the app directly."
diff --git a/docs/vi/resources/templates/quality-document.md b/docs/vi/resources/templates/quality-document.md
new file mode 100644
index 0000000..16fab2c
--- /dev/null
+++ b/docs/vi/resources/templates/quality-document.md
@@ -0,0 +1,43 @@
+# Tài liệu Chất lượng
+
+Một snapshot chất lượng cho mỗi domain sản phẩm và lớp kiến trúc. Cả agent và con người đều có thể sử dụng tài liệu này để nhanh chóng hiểu nơi nào codebase mạnh và nơi nào cần cải thiện.
+
+**Tần suất cập nhật:** Sau mỗi phiên quan trọng, hoặc trước khi bắt đầu giai đoạn công việc mới.
+
+**Thang điểm:**
+
+- **A**: Tất cả xác minh đang vượt qua, kiến trúc sạch, agent có thể đọc được, test ổn định
+- **B**: Xác minh đang vượt qua, hầu hết sạch, thiếu nhỏ về khả năng đọc hoặc độ phủ test
+- **C**: Hoạt động một phần, có khoảng trống đã biết, một số khu vực mã khó cho agent hiểu
+- **D**: Không hoạt động, hoặc có vấn đề cấu trúc lớn
+
+---
+
+## Domain Sản phẩm
+
+| Domain | Điểm | Xác minh | Khả năng đọc của Agent | Độ ổn định Test | Khoảng trống chính | Cập nhật lần cuối |
+|--------|-------|-------------|-----------------|---------------|----------|-------------|
+| Import Tài liệu | - | - | - | - | - | - |
+| Quản lý Tài liệu | - | - | - | - | - | - |
+| Indexing Tài liệu | - | - | - | - | - | - |
+| Luồng Q&A | - | - | - | - | - | - |
+| Câu trả lời có Grounding | - | - | - | - | - | - |
+
+## Lớp Kiến trúc
+
+| Lớp | Điểm | Thực thi Ranh giới | Khả năng đọc của Agent | Khoảng trống chính | Cập nhật lần cuối |
+|-------|-------|---------------------|-----------------|----------|-------------|
+| Main Process | - | - | - | - | - |
+| Preload | - | - | - | - | - |
+| Renderer | - | - | - | - | - |
+| Services | - | - | - | - | - |
+
+## Lịch sử Thay đổi
+
+### YYYY-MM-DD
+
+- Thay đổi:
+- Domain được nâng cấp:
+- Domain bị hạ cấp:
+- Khoảng trống mới được xác định:
+- Khoảng trống đã đóng:
diff --git a/docs/vi/resources/templates/session-handoff.md b/docs/vi/resources/templates/session-handoff.md
new file mode 100644
index 0000000..f2d0538
--- /dev/null
+++ b/docs/vi/resources/templates/session-handoff.md
@@ -0,0 +1,30 @@
+# Bàn giao Phiên
+
+## Đang Hoạt động Hiện tại
+
+- Những gì đang hoạt động:
+- Xác minh nào thực sự đã chạy:
+
+## Thay đổi Trong Phiên này
+
+- Mã hoặc hành vi đã thêm:
+- Thay đổi cơ sở hạ tầng hoặc harness:
+
+## Bị Hỏng hoặc Chưa được Xác minh
+
+- Lỗi đã biết:
+- Đường dẫn chưa được xác minh:
+- Rủi ro cho phiên tiếp theo:
+
+## Bước Tốt nhất Tiếp theo
+
+- Tính năng chưa hoàn thành có mức ưu tiên cao nhất:
+- Tại sao đây là tính năng tiếp theo:
+- Điều gì được tính là vượt qua:
+- Điều gì không được thay đổi trong bước đó:
+
+## Lệnh
+
+- Khởi động:
+- Xác minh:
+- Lệnh debug tập trung: