awf-context-help

name	awf-context-help
description	Context-aware help based on current workflow state. Keywords: help, what, how, confused, stuck, lost, guide, tutorial, explain. Activates on /help or when user asks questions.
version	1.0.0

AWF Context Help

Trợ giúp thông minh dựa trên context hiện tại.

Trigger Conditions

Activates when:

• User runs /help
• User types "?", "giúp", "help", "làm sao"
• User seems confused (repeated errors, long pause)

Execution Logic

Step 1: Read Context

context = {}

if exists(".brain/session.json"):
    context.workflow = session.working_on.feature
    context.task = session.working_on.task
    context.status = session.working_on.status
    context.pending = session.pending_tasks

if exists(".brain/brain.json"):
    context.project = brain.project.name
    context.tech = brain.tech_stack

Step 2: Detect State

State	Detection	Response
no_project	No .brain/ folder	Show onboarding
planning	workflow contains "plan"	Planning help
coding	workflow contains "code"	Coding help
debugging	workflow contains "debug"	Debug help
deploying	workflow contains "deploy"	Deploy help
stuck	status = "blocked" or pending > 5	Stuck help
idle	No active workflow	General help

Step 3: Show Contextual Help

Help Templates

No Project State

🆕 Chưa có dự án

Bạn có thể:
1. /brainstorm - Bàn ý tưởng trước
2. /init - Tạo dự án mới
3. Mô tả ý tưởng cho em nghe

Em sẽ hướng dẫn từng bước!

Planning State

📋 Đang lập kế hoạch: {context.workflow}

Bạn có thể:
1. Tiếp tục plan hiện tại
2. /code - Bắt đầu code phase đầu tiên
3. Hỏi em về cách thiết kế

💡 Mẹo: Plan tốt = Code nhanh hơn!

Coding State

💻 Đang code: {context.task}
   Status: {context.status}

Bạn có thể:
1. Tiếp tục code
2. /test - Kiểm tra code vừa viết
3. /debug - Nếu gặp lỗi
4. /save-brain - Lưu tiến độ

💡 Pending tasks: {context.pending.length}

Debugging State

🔧 Đang debug: {context.task}

Bạn có thể:
1. Mô tả lỗi chi tiết hơn
2. Paste error message
3. /code - Quay lại code sau khi fix

💡 Mẹo: Copy paste lỗi giúp em hiểu nhanh hơn!

Deploying State

🚀 Đang deploy: {context.workflow}

Bạn có thể:
1. Tiếp tục deploy process
2. /rollback - Quay về bản trước nếu lỗi
3. Kiểm tra logs sau deploy

⚠️ Nhớ test kỹ trước khi deploy production!

Stuck State

😅 Có vẻ bạn đang bị kẹt

Thử những cách này:
1. /recap - Xem lại đang làm gì
2. /debug - Nếu có lỗi
3. Nghỉ 5 phút rồi quay lại
4. Hỏi em cụ thể vấn đề

💡 {context.pending.length} tasks đang chờ.
   Có thể tạm skip task khó, làm cái khác trước?

Idle/General State

👋 Em có thể giúp gì?

Lệnh phổ biến:
┌─────────────────────────────────────┐
│ /next       │ Gợi ý việc tiếp theo  │
│ /recap      │ Nhớ lại context       │
│ /brainstorm │ Bàn ý tưởng mới       │
│ /plan       │ Lập kế hoạch          │
│ /code       │ Viết code             │
└─────────────────────────────────────┘

Hoặc hỏi em bất cứ điều gì!

Adaptive Language

Help responses adapt to technical_level:

newbie:

• Dùng tiếng Việt thuần
• Giải thích mọi khái niệm
• Bước nhỏ, chi tiết

basic:

• Mix Việt-Anh
• Giải thích term lần đầu
• Bước vừa phải

technical:

• Dùng thuật ngữ chuẩn
• Không cần giải thích
• Tập trung action

Fallback

If context unreadable:

👋 Em ở đây giúp bạn!

Gõ /next để em gợi ý việc cần làm,
hoặc mô tả vấn đề cho em nghe.

Performance

• Context read: < 200ms
• Response generation: Instant
• No external API calls