Unified AI Agent Playbook (Cross-Platform)

Repository này là bộ khung hướng dẫn và quản trị tập trung (Centralized Governance) dành cho các AI Agents và IDE Assistants. Nó được thiết kế để đồng bộ hóa các quy tắc lập trình, quy chuẩn kiến trúc và bộ công cụ tối ưu (RTK, ICM, GitNexus) trên 9+ nền tảng phổ biến nhất hiện nay (Claude, Command Code, Cursor, Copilot, Kiro, Kilo, Gemini, JetBrains, Antigravity).

• .rules/ - Single Source of Truth cho luật dự án (kiến trúc, toolchain, security, testing, coding style)
• prompts/ - Prompt vai trò cho Claude Code agents
• .cursor/rules/ - Tự động sinh ra (MDX) cho Cursor IDE
• .kiro/steering/ - Tự động sinh ra cho Amazon Kiro IDE & CLI
• .kilo/rules/ - Tự động sinh ra cho Kilo CLI
• .github/instructions/ - Tự động gộp cho GitHub Copilot
• .aiassistant/rules/ - Tự động sinh ra cho JetBrains AI Assistant (Air)
• .antigravity/rules/ - Tự động sinh ra cho Antigravity IDE
• GEMINI.md - Luật gốc cho Gemini CLI
• scripts/ - Scripts tự động hóa (VD: sync_rules.py để đồng bộ luật từ .rules/ sang mọi IDE)
• docs/ - Tài liệu hướng dẫn
• .ai-agents/ - Nơi lưu artifact của Claude Code trong quá trình làm việc
• .commandcode/ - Cấu hình Command Code (taste learning + GitNexus skills)
• COMMANDCODE.md - Project Memory cho Command Code (GitNexus, AI Toolchain, rules)

1. Mở repo đích trong Claude Code.
2. Copy .rules/ và prompts/ từ repo này sang repo đích.
3. Chạy pipeline:

   /agent-full Tạo API quản lý người dùng
   

1. Chạy /agent-kiro để tạo spec:

   /model claude-opus-4-6
   /agent-kiro Tạo tính năng xác thực JWT
   

2. Copy .kiro/ sang repo đích.
3. Mở Kiro IDE, yêu cầu implement theo spec.

1. Mở repo này trong Command Code: cmd (tại thư mục repo).
2. COMMANDCODE.md tự động được đọc — chứa GitNexus + AI Toolchain rules.
3. Dùng /skills để xem GitNexus skills có sẵn.
4. Chạy cmd taste learn . để học preferences từ mã nguồn.

• Không cần go.mod, Makefile, hoặc binary runtime trong repo playbook này.
• Nếu repo đích là Go project, các prompt/rules vẫn áp dụng bình thường.

ai_tech/
├── .rules/                    # Master Rules (Single Source of Truth)
├── .aiassistant/              # JetBrains AI rules (auto-generated)
├── .antigravity/              # Antigravity IDE rules (auto-generated)
├── .cursor/                   # Cursor rules (auto-generated)
├── .github/                   # Copilot instructions (auto-generated)
├── .kilo/                     # Kilo CLI rules (auto-generated)
├── .kiro/                     # Kiro IDE & CLI steering (auto-generated)
├── .ai-agents/                # Workspace runtime của Claude Code
├── .commandcode/              # Cấu hình Command Code (taste + skills)
├── prompts/                   # Hệ thống System Prompts cho agents
├── scripts/                   # Scripts đồng bộ (sync_rules.py)
├── docs/                      # Hướng dẫn chi tiết
├── GEMINI.md                  # Chỉ thị cho Gemini CLI
├── COMMANDCODE.md             # Project Memory cho Command Code
├── README.md                  # Giới thiệu tổng quan
└── USER_GUIDE.md              # Cẩm nang sử dụng chi tiết

• Không sửa trực tiếp các file trong .cursor/, .kiro/, .kilo/, .aiassistant/, .antigravity/, hay .github/.
• Quy trình chuẩn: Chỉ sửa luật tại .rules/, sau đó chạy python scripts/sync_rules.py để đồng bộ sang tất cả IDEs/Agents.
• Hệ thống đã tích hợp sẵn RTK, ICM và GitNexus để tối ưu hóa token và an toàn kiến trúc.
• Tuyệt đối tuân thủ Git Autonomy: AI không được tự ý stage/commit nếu không có lệnh cụ thể.