Make AI Disciplined.

Đừng để AI code kiểu "ngẫu hứng".
AWF cài đặt bộ não kỹ sư vào Antigravity: biết lập kế hoạch, biết kiểm tra bảo mật, và không bao giờ quên context.

Why do you need this?

Sự thật đằng sau việc "Chat với AI"

⛔ Cách cũ (Default Chat)

Context Drift (Hay quên)

Sau khoảng 10 tin nhắn, AI bắt đầu quên cấu trúc Database cũ. Nó tự ý tạo bảng mới trùng lặp hoặc rollback code bạn vừa sửa.

Lazy Coding (Code ẩu)

AI thường đưa code "chạy được là được". Thiếu try-catch, hard-code API Key, và bỏ qua các edge-cases quan trọng.

The Loop of Death

Sửa lỗi A đẻ ra lỗi B. AI sửa lỗi B đẻ lại lỗi A. Bạn kẹt trong vòng lặp debug vô tận vì AI không hiểu Root Cause.

✅ Cách AWF (Engineered)

External Memory (Không bao giờ quên)

AWF buộc AI đọc file .brain và docs/ trước khi viết bất kỳ dòng code nào. Kiến trúc dự án luôn được bảo toàn.

Security & Quality Gates

Workflow /code ép AI phải checklist bảo mật (SQL Injection, XSS) và viết Unit Test trước khi đưa code cho bạn.

Plan First, Code Later

Lệnh /plan bắt AI dừng lại suy nghĩ, viết Spec chi tiết để bạn duyệt. Hết cảnh "đập đi xây lại".

Documentation chi tiết 14 Lệnh

01. PLANNING PHASE

/init
Setup

Khởi tạo dự án mới với cấu trúc chuẩn Enterprise. Không cần nhớ phải cài thư viện gì, config ESLint ra sao.

Input: /init I want a Next.js E-commerce app
Process: Tạo folder → Cài dependencies → Config Git/Prettier → Tạo README.
/plan
Critical

Kiến trúc sư trưởng. Phân tích yêu cầu mơ hồ của bạn thành bản thiết kế kỹ thuật chi tiết.

Input: /plan Add a payment system via Stripe
AI Steps:
  • Đọc database schema hiện tại.
  • Nghiên cứu Stripe API mới nhất.
  • Viết `spec.md` (API Flow, DB Changes).
Output: File `docs/specs/payment-feature.md` để bạn duyệt.

02. CONSTRUCTION PHASE

/code
Dev

Senior Developer thực thi. Viết code dựa trên bản plan đã duyệt. Tự động thêm comment và error handling.

Logic: Đọc `spec.md` → Viết Code → Check Security → Self-Review.
/visualize
UI/UX

Designer mode. Tạo HTML/CSS/Tailwind đẹp mắt. Sử dụng tư duy component-based.

Output: Tạo ra các file component `.tsx` hoặc `.html` với style hoàn chỉnh, responsive.

03. MAINTENANCE & OPS

/debug

Không sửa mò. Yêu cầu AI đọc log, tái lập lỗi, tìm Root Cause, sau đó mới đề xuất fix.

/audit

Quét toàn bộ project tìm code chết, API key bị lộ, thư viện cũ, và lỗi bảo mật.

/deploy

Chuẩn bị Production: Build optimization, Dockerfile check, và setup Cloudflare Tunnel.

Memory System

Vũ khí bí mật chống lại căn bệnh "Hay Quên" của AI.

/save-brain

Cuối ngày, chạy lệnh này để AI tóm tắt toàn bộ thay đổi vào `.brain`. Ngày mai nó sẽ nhớ tất cả.

/recap

Đầu ngày, chạy lệnh này để AI đọc lại `.brain` và báo cáo: "Hôm qua chúng ta đang làm dở tính năng X".

One Command Install

Cài đặt Global vào ~/.gemini/global_workflows. Tự động nhận diện ở mọi dự án.

# 1. Open Antigravity/Cursor Terminal (Ctrl + `)
# 2. Paste & Enter:
iex (irm https://raw.githubusercontent.com/TUAN130294/awf/main/install.ps1)