Rules & Workflows

Tại Sao Rules Quan Trọng

Không có rules, agent sẽ đoán cách bạn muốn. Có rules, nó tuân theo sở thích chính xác — mọi lúc.

Rules được định nghĩa trong file GEMINI.md tại gốc project. Agent đọc file này ở đầu mỗi hội thoại.

Viết Rules Hiệu Quả

Cấu Trúc Cơ Bản

# GEMINI.md

## Tổng Quan Project

App e-commerce Next.js 16 dùng TypeScript,
Tailwind CSS v4 và Cloudflare Workers.

## Quy Tắc Code

- Dùng functional components với TypeScript
- Ưu tiên `const` hơn `let`
- Dùng early returns để giảm nesting
- Mọi component phải có prop types rõ ràng

## Cấm

- Không dùng type `any`
- Không dùng inline styles
- Không cài packages mà không hỏi trước

Workflows: Reusable Task Recipes

Workflows là step-by-step instructions lưu dạng .md trong .agent/workflows/. Kích hoạt bằng slash commands.

Tạo Workflow

Tạo .agent/workflows/deploy.md:

---
description: Build và deploy lên production
---

1. Chạy linter
   // turbo
2. Chạy `pnpm build`
3. Kiểm tra lỗi build
   // turbo
4. Chạy `./deploy.sh`
5. Xác minh URL deployment trả về 200

Gõ /deploy trong agent chat để kích hoạt.

Chú Thích // turbo

Dòng đánh dấu // turbo sẽ auto-execute không cần hỏi. Dùng cho safe commands.

Ví Dụ Workflow Thực Tế

/add-blog-post — Tạo bài blog song ngữ

---
description: Thêm bài blog mới ở cả hai ngôn ngữ
---

1. Hỏi user: tiêu đề, chủ đề, điểm chính
2. Tạo `src/content/blog/en/{slug}.md`
3. Tạo `src/content/blog/vi/{slug}.md` (dịch)
   // turbo
4. Chạy `pnpm build` để xác minh

Kết Hợp Rules + Workflows

Sức mạnh thực sự khi kết hợp:

GEMINI.md (rules) → Set code standards
.agent/workflows/ (actions) → Execution workflows

Luồng ví dụ:

1. Bạn gõ /add-feature
2. Workflow hỏi chi tiết tính năng
3. Agent check GEMINI.md để biết standards
4. Tạo code theo patterns CỦA BẠN
5. Chạy tests theo rules CỦA BẠN

Best Practices

1. Bắt đầu nhỏ — Thêm rules khi phát hiện sở thích
2. Cụ thể — “Dùng Tailwind v4” tốt hơn “dùng CSS hiện đại”
3. Kèm ví dụ — Show agent bạn muốn gì
4. Update thường xuyên — Rules nên evolve cùng project
5. Version control — Commit GEMINI.md và workflows vào git

Tiếp Theo

Rules cho agent biết LÀM GÌ. Skills cho biết LÀM THẾ NÀO. Hãy tìm hiểu Skills.