Skip to content

nouvo4344/awf

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 AWF - Antigravity Workflow Framework v4.0

The Operating System for Vibe Coders & AI Engineers. Hệ điều hành dành cho Vibe Coder và Kỹ sư AI.

Turn your ideas into apps without coding knowledge. AI handles everything. Biến ý tưởng thành App mà không cần biết code. AI lo trọn gói.

v4.0: 4 Hidden Skills · 12 Non-Tech Mode Workflows · Error Translation · Flowchart Explanations

Website Install Global


🛑 The Problem (Vấn đề)

Have you ever experienced this with AI Coding?
Bạn có từng gặp cảnh này khi code với AI?

  1. Memory Loss / Mất trí nhớ:
    AI forgets your database schema after 20 messages. It creates duplicate tables or conflicts.
    AI quên cấu trúc Database sau 20 tin nhắn. Tự ý tạo bảng trùng lặp.

  2. Lazy Coding / Code ẩu:
    AI gives "just works" code without try-catch, hard-coded API keys, and ignores edge cases.
    AI đưa code thiếu an toàn, hard-code API Key, bỏ qua các trường hợp lỗi.

  3. Loop Debugging / Vòng lặp Debug:
    Fixing bug A creates bug B. AI fixes blindly without finding the Root Cause.
    Sửa lỗi này đẻ ra lỗi khác. AI sửa mò mà không tìm nguyên nhân gốc rễ.

👉 You are treating AI as a "Junior Developer". You need to MANAGE it.
Bạn đang dùng AI như thực tập sinh. Bạn cần phải QUẢN LÝ nó.


✅ The Solution: AWF 4.0

AWF is a suite of 16 Slash Commands + 2 Utilities for everyone - from beginners to pros. AWF là bộ 16 lệnh chính + 2 tiện ích cho mọi người - từ người mới đến chuyên gia.

What's New in v4.0:

🎯 4 Hidden Skills (tự động, user không cần biết):

Skill Chức năng
awf-session-restore Nhớ context giữa các session
awf-adaptive-language Điều chỉnh ngôn ngữ theo trình độ
awf-error-translator Dịch 50+ lỗi sang ngôn ngữ dễ hiểu
awf-context-help Trợ giúp thông minh theo context

📝 12 Workflows với Non-Tech Mode:

  • Flowchart kèm giải thích bằng lời
  • Database schema mô tả đời thường
  • Lỗi được dịch + hướng dẫn sửa
  • Bảng thuật ngữ trong mỗi workflow

For Beginners (Dành cho người mới):

  • Brainstorm First: Discuss ideas, research market, clarify vision (/brainstorm). Bàn ý tưởng, research thị trường, làm rõ tầm nhìn.
  • No Tech Knowledge Needed: AI handles all technical decisions. Không cần biết kỹ thuật. AI lo hết.
  • Step-by-Step Guidance: /next tells you what to do next. Hướng dẫn từng bước. /next cho biết làm gì tiếp.

For Professionals (Dành cho chuyên gia):

  • Plan First: No coding allowed without a Spec (/plan). Cấm code khi chưa có kế hoạch.
  • Safety First: Auto-check security before coding (/code). Tự động kiểm tra bảo mật.
  • Infinite Memory: Save context to .brain/brain.json (/save-brain). Lưu ngữ cảnh vào file JSON có cấu trúc - AI parse nhanh, tiết kiệm token.

📦 Installation (Global)

Install once. Works on every project.
Cài 1 lần. Dùng cho mọi dự án.

🪟 Windows (PowerShell)

Open Terminal in Antigravity/Cursor (Ctrl + `) and paste:
Mở Terminal và dán lệnh sau:

iex "& { $(irm https://raw.githubusercontent.com/TUAN130294/awf/main/install.ps1) }"

🍎 Mac / Linux (Terminal)

curl -fsSL https://raw.githubusercontent.com/TUAN130294/awf/main/install.sh | sh

Restart your IDE after installation. Khởi động lại Antigravity/Cursor sau khi cài.

🗑️ Uninstall (Gỡ cài đặt)

Windows (PowerShell):

Remove-Item -Recurse -Force "$env:USERPROFILE\.gemini\antigravity"
Remove-Item -Force "$env:USERPROFILE\.gemini\awf_version"
# Optional: Remove AWF section from GEMINI.md manually

Mac/Linux:

rm -rf ~/.gemini/antigravity
rm -f ~/.gemini/awf_version
# Optional: Remove AWF section from GEMINI.md manually

🎮 How to Use (Hướng dẫn)

🆕 For Beginners / Vibe Coders (Người mới bắt đầu)

Just have an idea? Start here: Chỉ có ý tưởng? Bắt đầu từ đây:

/brainstorm → /init → /plan → /visualize → /code → /run → /deploy
  • /brainstorm (START HERE!): Input: "Em muốn làm app quản lý tiệm cà phê" AI will:

    • Ask questions to understand your idea / Hỏi để hiểu ý tưởng
    • Research competitors if needed / Tìm hiểu đối thủ nếu cần
    • Help prioritize features (MVP) / Giúp chọn tính năng quan trọng
    • Output: BRIEF.md - Clear summary of your app / Tóm tắt rõ ràng
  • /next (When stuck): Don't know what to do next? Just type /next Không biết làm gì tiếp? Gõ /next


💼 For Professionals (Dành cho chuyên gia)

Follow this 3-step process: Tuân thủ quy trình 3 bước:

1. Planning Phase (Lập kế hoạch)

  • /init: EN: Setup new project structure & git. VI: Khởi tạo dự án mới.
  • /recap: EN: Start day. AI reads .brain to restore context. VI: Đầu ngày làm việc. AI đọc .brain để nhớ lại ngữ cảnh.
  • /plan (CRITICAL): Input: /plan Add Stripe Payment Action: Read DB & Docs -> Write docs/specs/payment.md. Benefit: Approve logic BEFORE coding. (Duyệt logic trước khi code).

2. Construction Phase (Xây dựng)

  • /visualize:
    EN: Designer Mode. Generate UI/Components.
    VI: Tạo giao diện UI/UX.
  • /code (CRITICAL):
    Input: /code Implement payment based on spec
    Action: Write Code + Unit Test + Security Check.
    Benefit: Clean & Safe Code. (Code sạch và an toàn).

3. Operations Phase (Vận hành)

  • /debug: "Sherlock Holmes Mode". Find Root Cause.
    Tìm nguyên nhân gốc rễ.
  • /audit: Health check & Security scan.
    Kiểm tra sức khỏe dự án.
  • /deploy: Dockerize & Production setup.
    Đóng gói lên Production.

4. Memory (Bộ nhớ)

  • /save-brain:
    EN: Save comprehensive context to .brain.
    VI: Lưu toàn bộ kiến thức vào file .brain.
    Tip: You can clear chat history after saving! (Có thể xoá chat sau khi lưu)

📚 Command List (Danh sách lệnh)

🌟 Discovery & Start (Khám phá & Bắt đầu)

Command Role Description
/brainstorm Partner 💡 Bàn ý tưởng, research thị trường / Discuss ideas, market research
/init Founder Khởi tạo dự án / Setup new project
/recap Historian Nhớ lại context / Restore context
/next Navigator Gợi ý bước tiếp theo / What to do next

🎯 Design & Build (Thiết kế & Xây dựng)

Command Role Description
/plan Architect Thiết kế tính năng / Design Feature
/visualize Designer Tạo UI/UX / Generate UI
/code Senior Dev Viết code an toàn / Secure Coding

⚙️ Run & Test (Chạy & Kiểm tra)

Command Role Description
/run Operator Chạy ứng dụng / Run App
/test QA Engineer Kiểm thử / Testing
/debug Detective Sửa lỗi sâu / Deep Debugging

🚀 Deploy & Maintain (Triển khai & Bảo trì)

Command Role Description
/deploy DevOps Deploy lên server
/audit Security Kiểm tra bảo mật / Security Check
/refactor Clean Coder Tối ưu code / Code Refactoring
/rollback Time Traveler Khôi phục code cũ / Revert Changes

💾 Memory & Utils (Bộ nhớ & Tiện ích)

Command Role Description
/save-brain Librarian Lưu kiến thức / Save Context
/cloudflare-tunnel Admin Quản lý Tunnel
/awf-update Updater Kiểm tra & cập nhật AWF

💡 Why /brainstorm? (Tại sao cần /brainstorm?)

The #1 problem with Vibe Coding: Vấn đề lớn nhất của Vibe Coding:

"I have an idea but I don't know where to start" "Em có ý tưởng nhưng không biết bắt đầu từ đâu"

/brainstorm solves this by:

Problem Solution
Vague idea AI asks questions to clarify / AI hỏi để làm rõ
Don't know competitors AI researches market for you / AI tìm hiểu thị trường
Too many features AI helps prioritize MVP / AI giúp chọn tính năng quan trọng
Technical confusion AI explains in simple terms / AI giải thích đơn giản

Example conversation:

You: /brainstorm
You: Em muốn làm app quản lý tiệm cà phê

AI: "App giải quyết vấn đề gì cho anh?"
You: Quản lý order, nhân viên, doanh thu

AI: "Có muốn em tìm xem thị trường có app tương tự không?"
You: Có

AI: [Researches and shows competitors]
AI: "App của anh sẽ khác họ ở điểm nào?"
...

AI: "Em tổng hợp lại:
    - MVP: Order + Menu + Doanh thu cơ bản
    - Phase 2: Quản lý nhân viên, inventory

    Lưu vào BRIEF.md. Gõ /plan để tiếp tục!"

📖 Documentation


🆕 v4.0 Non-Tech Mode Examples

Before (v3.x) vs After (v4.0)

Error Messages:

❌ v3.x: "ECONNREFUSED 127.0.0.1:5432"
✅ v4.0: "Database chưa bật → Mở app PostgreSQL lên!"

Database Schema:

❌ v3.x: "Table Users với columns: id, email, password_hash"
✅ v4.0: "📦 App lưu: Thông tin người dùng (email, mật khẩu)"

Flowchart:

❌ v3.x: graph TD A[User] --> B[Login]
✅ v4.0: "📊 Luồng: 1. Mở app → 2. Đăng nhập → 3. Vào Dashboard"

How to Enable Non-Tech Mode

# Tạo file preferences trong project
mkdir -p .brain
echo '{"technical":{"technical_level":"newbie"}}' > .brain/preferences.json

# Hoặc chạy /customize để AI hướng dẫn

Built by Antigravity in Vibe Coding Mode. AWF v4.0 - For everyone, from beginners to pros. 4 Hidden Skills · 12 Non-Tech Workflows · 16 Slash Commands + 2 Utilities

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • PowerShell 39.1%
  • HTML 30.9%
  • Shell 30.0%