awf-onboarding

name	awf-onboarding
description	First-time user onboarding experience. Keywords: new, first, start, begin, welcome, tutorial, guide, learn, help me. Activates on first /init or when .brain/preferences.json doesn't exist.
version	1.0.0

AWF Onboarding

Hướng dẫn người dùng mới làm quen với AWF.

Trigger Conditions

Activates when:

• User chạy /init lần đầu (không có .brain/ folder)
• User chạy /help và chưa có preferences
• User nói "mới dùng", "hướng dẫn", "không biết bắt đầu"

Check:

if NOT exists(".brain/preferences.json") AND NOT exists("~/.antigravity/preferences.json"):
     Activate onboarding
else:
     Skip (returning user)

Execution Logic

Step 1: Welcome Message

👋 **CHÀO MỪNG ĐẾN VỚI AWF!**

Em là trợ lý AI, sẽ giúp anh biến ý tưởng thành app thật.

🎯 AWF có thể giúp anh:
   • Tạo app/website từ con số 0
   • Không cần biết code (em làm giùm!)
   • Nhớ mọi thứ giữa các lần làm việc

⏱️ Cho em 2 phút để hướng dẫn nhanh nhé?

1️⃣ Có, hướng dẫn em đi
2️⃣ Không cần, bắt đầu luôn

Step 2: Quick Assessment (nếu chọn 1)

📊 **EM CẦN HIỂU ANH MỘT CHÚT:**

Anh đã từng làm app/website chưa?

1️⃣ Chưa bao giờ (newbie)
   → Em sẽ giải thích mọi thứ đơn giản

2️⃣ Có biết chút chút (basic)
   → Em giải thích khi cần

3️⃣ Dân IT rồi (technical)
   → Em nói chuyện như đồng nghiệp

Step 3: 5 Commands Tour

🗺️ **5 LỆNH QUAN TRỌNG NHẤT:**

┌─────────────────────────────────────────┐
│ 1️⃣ /brainstorm                          │
│    "Tôi có ý tưởng nhưng chưa rõ"       │
│    → AI giúp làm rõ ý tưởng             │
├─────────────────────────────────────────┤
│ 2️⃣ /plan                                │
│    "Tôi biết muốn làm gì rồi"           │
│    → AI lên kế hoạch chi tiết           │
├─────────────────────────────────────────┤
│ 3️⃣ /code                                │
│    "Bắt đầu viết code đi"               │
│    → AI code theo kế hoạch              │
├─────────────────────────────────────────┤
│ 4️⃣ /run                                 │
│    "Chạy thử xem nào"                   │
│    → Khởi động app để xem kết quả       │
├─────────────────────────────────────────┤
│ 5️⃣ /debug                               │
│    "Có lỗi rồi, sửa giùm"               │
│    → AI tìm và sửa lỗi                  │
└─────────────────────────────────────────┘

💡 Mẹo: Không cần nhớ hết! Gõ /next bất cứ lúc nào
   để em gợi ý nên làm gì tiếp.

Step 4: Quick Start Options

🚀 **BẮT ĐẦU THÔI!**

Anh muốn làm gì?

1️⃣ Tôi có ý tưởng app rồi → /plan
2️⃣ Chưa rõ, muốn bàn trước → /brainstorm
3️⃣ Hướng dẫn chi tiết hơn → /help
4️⃣ Tùy chỉnh cách AI nói chuyện → /customize

Step 5: Initialize .brain/ Folder

Tạo folder structure:

.brain/
├── preferences.json
├── session.json
├── session_log.txt
└── brain.json

preferences.json:

{
  "communication": {
    "tone": "friendly",
    "personality": "assistant"
  },
  "technical": {
    "technical_level": "[user_choice]",
    "detail_level": "simple",
    "autonomy_level": "ask_often"
  },
  "onboarding_completed": true,
  "onboarding_date": "[timestamp]"
}

session.json:

{
  "updated_at": "[timestamp]",
  "working_on": {
    "feature": null,
    "task": null,
    "status": "idle"
  },
  "pending_tasks": [],
  "errors_encountered": [],
  "decisions_made": [
    {
      "decision": "Technical level set to [level]",
      "reason": "User selection during onboarding"
    }
  ],
  "skipped_tests": []
}

session_log.txt:

[YYYY-MM-DD HH:MM] ONBOARDING COMPLETE
[YYYY-MM-DD HH:MM] Technical level: [level]
[YYYY-MM-DD HH:MM] Ready for first project

brain.json:

{
  "meta": {
    "schema_version": "1.0.0",
    "awf_version": "4.0.2",
    "created_at": "[timestamp]"
  },
  "project": {
    "name": null,
    "type": null,
    "status": "not_started"
  },
  "updated_at": "[timestamp]"
}

Step 6: Save & Complete

✅ **HOÀN TẤT SETUP!**

Em đã tạo:
📁 .brain/
   ├── preferences.json  (cài đặt của anh)
   ├── session.json      (theo dõi tiến độ)
   ├── session_log.txt   (nhật ký)
   └── brain.json        (kiến thức dự án)

💾 Mọi thứ sẽ được tự động lưu từ giờ!

────────────────────────

Giờ anh muốn làm gì?

1️⃣ Tạo dự án đầu tiên → /init
2️⃣ Bàn ý tưởng trước → /brainstorm
3️⃣ Xem hướng dẫn chi tiết → /help

Returning User Detection

if exists("preferences.json") AND preferences.onboarding_completed == true:

     Nếu > 7 ngày không dùng:
          "👋 Chào mừng anh quay lại! Gõ /recap để em nhắc lại đang làm gì nhé."

     Nếu < 7 ngày:
          Skip welcome, vào thẳng workflow

Error Handling

If cannot create .brain/ folder:
    Try create in current directory
    If still fail:
        Warning: "⚠️ Em không tạo được folder lưu trữ, nhưng vẫn làm việc được!"
        Continue in-memory mode

If user skips all steps:
    Use defaults: technical_level = "basic"
    Mark onboarding_completed = true

Integration

Với /init:

/init được gọi
    ↓
Check .brain/ folder
    ↓
├── Không có → Chạy onboarding TRƯỚC
└── Có rồi → Chạy /init bình thường

Performance

• Total time: < 2 minutes
• No external API calls
• Minimal file I/O