⚡ AWF Vibecoder Kit v5

Biến AI thành đội dev ảo. Bộ công cụ vibecoding cho Antigravity IDE.

Vibecoding = Bạn nói ý tưởng → AI viết code. Bạn làm "sếp", AI làm "nhân viên".

AWF (Antigravity Workflow Framework) giúp bạn "sếp" tốt hơn — ra lệnh đúng, kiểm tra đúng, ship nhanh.

✨ Highlights

🎯 16 lệnh chính — Sprint flow: Idea → Plan → Code → Review → Ship 🧠 ~50 skills ẩn — AI tự kích hoạt kiến thức chuyên môn khi cần 🇻🇳 Vietnamese-first — Viết cho người Việt, thuật ngữ dễ hiểu 📱 Mọi trình độ — Từ non-tech đến senior dev đều dùng được 🔧 Fix-first review — AI tự fix lỗi rõ ràng, chỉ hỏi khi cần judgment 📚 Docs đầy đủ — 5 file hướng dẫn từ Quick Start đến Glossary

🚀 Cài Đặt — 30 Giây

Cách 1: npm (Khuyến nghị)

npm install -g awf-vibecoder-kit

Tự động copy workflows + docs + skills vào ~/.gemini/antigravity/.

Cách 2: Git Clone

git clone https://github.com/mh/awf-vibecoder-kit.git
cd awf-vibecoder-kit
node bin/setup.js

Cách 3: Manual

Copy thủ công 3 folder vào ~/.gemini/antigravity/:

• workflows/ → global_workflows/
• docs/ → docs/
• skills/ → skills/

📖 Quick Start

1. Mở Antigravity
2. Gõ /vibecoder-guide để đọc hướng dẫn
3. Gõ /init để tạo project mới
4. Gõ /brainstorm để khám phá ý tưởng
5. Ship! 🚀

🗺️ Sprint Flow

/init → /brainstorm → /plan → /design → /code → /review → /test → /deploy → /canary
  ↑                                                                              ↓
  └────────────────────── /recap (mở lại project) ←──────── /save-brain (cuối buổi)

📋 16 Lệnh Chính

| Lệnh | Mô tả | Khi nào dùng | |-------|--------|-------------| | /init | ✨ Tạo dự án mới | Bắt đầu project | | /brainstorm | 💡 Khám phá ý tưởng (5 forcing questions) | Chưa rõ muốn làm gì | | /plan | 📋 Lên kế hoạch chi tiết | Đã biết muốn gì | | /design | 🎨 Thiết kế DB, API, luồng | Trước khi code | | /visualize | 🖼️ Thiết kế UI mockup | Muốn xem UI trước | | /code | 💻 Viết code (auto-test loop) | Bắt đầu code | | /review | 👀 Code review + auto-fix | Sau code, trước deploy | | /test | 🧪 Chạy test suite | Kiểm tra code | | /deploy | 🚀 Deploy lên mạng | App sẵn sàng | | /canary | 🐤 Check sức khỏe sau deploy | Vừa deploy xong | | /debug | 🐛 Tìm và sửa lỗi | App bị lỗi | | /audit | 🔒 Kiểm tra bảo mật | Trước khi public | | /freeze | 🔒 Lock edit scope | Debug tập trung | | /learn | 📚 Quản lý kiến thức | Xem bài học qua sessions | | /recap | 📖 Nhớ lại context | Mở lại project | | /save-brain | 🧠 Lưu context | Cuối buổi |

📂 Cấu Trúc Package

awf-vibecoder-kit/
├── bin/
│   ├── setup.js          # Install script
│   └── uninstall.js      # Uninstall guide
├── workflows/            # 16+ workflow .md files
│   ├── brainstorm.md     # 5 forcing questions + reframe
│   ├── review.md         # Fix-first code review
│   ├── freeze.md         # Edit scope lock
│   ├── canary.md         # Post-deploy monitoring
│   ├── learn.md          # Compound learnings
│   ├── code.md           # Phase-based coding
│   ├── plan.md           # Multi-perspective planning
│   └── ...
├── docs/                 # User guide (Vietnamese)
│   ├── README.md         # Table of contents
│   ├── quick-start.md    # 5-minute beginner guide
│   ├── commands.md       # 16 commands detailed
│   ├── skills.md         # ~50 skills explained
│   ├── scenarios.md      # 8 real-world scenarios
│   └── glossary.md       # Tech terms → plain Vietnamese
├── skills/               # Auto-activated AI skills
│   ├── awf-session-restore/
│   ├── awf-auto-save/
│   └── ...
├── package.json
├── LICENSE
└── README.md             # ← You are here

🆚 Lấy Cảm Hứng Từ

AWF v5 lấy ý tưởng hay nhất từ GStack (Garry Tan, CEO Y Combinator) và kết hợp với thế mạnh riêng:

| Feature | GStack | AWF v5 | |---------|--------|--------| | Sprint flow | ✅ | ✅ | | Fix-first review | ✅ | ✅ | | Post-deploy canary | ✅ | ✅ | | Edit scope lock | ✅ | ✅ | | Memory/learnings | ✅ | ✅ | | Real browser testing | ✅ | ❌ | | Vietnamese UX | ❌ | ✅ | | Phase-based coding | ❌ | ✅ | | Non-tech friendly | ❌ | ✅ | | Knowledge graph (GitNexus) | ❌ | ✅ | | Multi-agent orchestration | ❌ | ✅ |

📝 License

MIT — Free forever. Go build something.

🧑‍💻 Contributing

1. Fork repo
2. Tạo branch: git checkout -b improve/brainstorm
3. Sửa workflow .md files
4. PR + mô tả changes

Workflows là Markdown files — không cần biết code cũng contribute được!