@damphuquy/agent-init 1.3.0 → 1.4.1

package/templates/vi/process/development-protocols/implementation-standards.md

@@ -0,0 +1,28 @@
+# Tiêu Chuẩn Triển Khai & Khung Kiểm Thử (Implementation Standards)
+
+<implementation_standards version="1.0">
+
+<description>
+  Quy chuẩn chất lượng kỹ thuật, an toàn kiểu dữ liệu (type safety) và kiểm thử cho codebase này.
+</description>
+
+## 1. An Toàn Kiểu Dữ Liệu & Vệ Sinh Code (Type Safety & Code Hygiene)
+<conventions>
+  <rule id="strict_typing">
+    Toàn bộ các hàm, phương thức và thuộc tính class bắt buộc phải có chú thích kiểu dữ liệu (type annotations) rõ ràng. Sử dụng union types hiện đại (`int | None` hoặc `string | null`) và tránh dùng `Any`/`any` không định kiểu trừ khi giao tiếp với payload bên ngoài thô.
+  </rule>
+  <rule id="domain_purity">
+    Mã nguồn trong các tầng domain phải thuần khiết với 0 phụ thuộc vào hạ tầng bên ngoài (zero external infrastructure dependencies).
+  </rule>
+  <rule id="immutability">
+    Ưu tiên các mô hình bất biến (immutable models) cho các sự kiện domain (domain events), value objects và DTOs.
+  </rule>
+</conventions>
+
+## 2. Kiến Trúc Kiểm Thử (Test Architecture)
+<test_structure>
+  - `tests/unit/`: Các bài test nhanh, cách ly cho domain models, logic cốt lõi và mock adapters.
+  - `tests/integration/`: Các bài test luồng đầu-cuối với dịch vụ kiểm thử hoặc database nội bộ.
+</test_structure>
+
+</implementation_standards>

package/templates/vi/process/development-protocols/orchestration.md

@@ -0,0 +1,24 @@
+# Giao Thức Phân Công & Điều Phối Subagent (Orchestration Protocol)
+
+<orchestration_protocol version="1.0">
+
+<description>
+  Hướng dẫn phân công nhiệm vụ, cách ly và phối hợp subagent trong các task phức tạp.
+</description>
+
+## 1. Nguyên Tắc Phân Công (Delegation Principles)
+<delegation_rules>
+  <rule id="explicit_scope">
+    Luôn chỉ định danh sách file chính xác, chữ ký hàm (function signatures) và định dạng đầu ra có cấu trúc kỳ vọng.
+  </rule>
+
+  <rule id="context_containment">
+    Không cấp quyền truy cập repository không giới hạn; giới hạn ngữ cảnh của subagent trong phạm vi các bộ test suite liên quan và hợp đồng giao diện cổng.
+  </rule>
+
+  <rule id="no_polling">
+    Dựa vào cơ chế đánh thức qua tin nhắn phản ứng (reactive message wakeup) của hệ thống khi subagent hoàn thành việc thực thi.
+  </rule>
+</delegation_rules>
+
+</orchestration_protocol>