FUNNEL MKT — Hệ thống 8 Agent thu lead

Bộ 8 AI agent chạy theo mô hình bánh đà (flywheel) để xây phễu marketing thu lead cho sản phẩm số và sản phẩm giáo dục. Viết cho Claude Code, dùng tiếng Việt, tiền tệ VND.

Trạng thái: 45/45 skill đã viết · 10/10 template · 8/8 agent. ⚠️ Chưa chạy thử trên dự án thật. 12/14 bài nghiệm thu trong KE-HOACH.md vẫn đang chờ.

Bánh đà 8 Agent

Chiều quay: ① → ② → ③ → ④ → ⑤ → ⑥ → ⑦ → ⑧ → ① (vòng mới)

Mở docs/so-do-flywheel.html bằng trình duyệt để xem sơ đồ.

Vì sao là bánh đà, không phải dây chuyền

Dây chuyền chạy xong là hết. Bánh đà để lại kho tài sản tích luỹ ở trục — vòng sau đọc kho của vòng trước nên rẻ hơn, nhanh hơn, chính xác hơn.

Mọi agent bắt buộc theo đúng ba bước:

1. ĐỌC KHO   →  mở file liên quan trong kho/ trước khi làm gì
2. LÀM VIỆC  →  thực thi skill, xuất tài liệu vào du-an/{tên-dự-án}/
3. BƠM KHO   →  ghi phát hiện mới vào kho/ — bước này KHÔNG được bỏ

Quy tắc vàng: kho đã có dữ liệu thật mà agent vẫn đưa số ước lượng là lỗi — bánh đà bị trượt.

Vòng 1 Agent ① đoán volume từ khoá. Vòng 2 nó đọc kho/tu-khoa-da-kiem-chung.csv và biết từ khoá nào thật sự ra lead với giá bao nhiêu.

Cài đặt

Cần Claude Code, Node.js, và Google Chrome (để xuất PDF).

git clone https://github.com/thaofvn-coca06/funnel-mkt.git
cd funnel-mkt
npm install

Chrome ở đường dẫn khác mặc định thì đặt biến môi trường:

export CHROME_PATH="/đường/dẫn/tới/Chrome"

Cách dùng

Mở thư mục bằng Claude Code rồi gõ lệnh theo đúng thứ tự bánh đà:

/tukhoa khoá học chốt sale cho người bán hàng
/insight
/doithu
/usp
/quatang
/phanphoi
/traffic
/doluong

Mỗi agent tự đọc kho, làm việc, rồi bơm kết quả ngược vào kho. Không agent nào tự gọi agent khác — bạn gọi thủ công từng cái, và agent sẽ báo nếu thiếu đầu vào từ bước trước.

Xuất ebook ra PDF:

node scripts/html-to-pdf.js <file.html> <file.pdf>

Cấu trúc

├── agents/          8 file "não" — hợp đồng vào/ra của từng agent
├── skills/          45 skill, nhóm theo 8 cụm
├── .claude/commands/ 8 lệnh gạch chéo
├── templates/       10 mẫu CSV/HTML, có file kèm công thức sống
├── kho/             TRỤC BÁNH ĐÀ — tài sản tích luỹ xuyên mọi chiến dịch
├── scripts/         html → pdf
├── docs/            sơ đồ flywheel + nguồn gốc mô hình
└── du-an/           hồ sơ từng phễu (KHÔNG commit — có dữ liệu khách hàng)

Phân biệt du-an/ và kho/:

• du-an/ — hồ sơ của một phễu, chết theo chiến dịch. Nằm trong .gitignore.
• kho/ — tài sản xuyên mọi phễu, chỉ dày lên, không bao giờ xoá.

Tài liệu

Nguồn gốc

Thiết kế rút ra từ một file Google Sheet đã vận hành thủ công thật — phễu high-ticket cho một sản phẩm coaching. Chi tiết 13 tab gốc và cách ánh xạ sang 8 agent: xem docs/mo-hinh-goc.md.

Chỉ lấy cấu trúc và phương pháp. Mọi ví dụ trong 45 skill đều viết mới; không có nội dung khách hàng thật.

Giới hạn đã biết

• Phạm vi dừng ở đo lường lead. Quy trình Zoom chốt sale và follow-up bán hàng chỉ để chỗ nối, không build trong đợt này — trừ ba mốc nhập tay ở ⑧ bước 5.
• Chưa chạy thử. 45 skill viết xong nhưng chưa có phễu thật nào đi qua. Hai bài nghiệm thu đã chạy được (#7 PDF, #9 ROAS 9,7x); 12 bài còn lại cần dữ liệu thật.
• Nền tảng không chốt cứng. ⑥ có ma trận chọn theo từng dự án, giá tra lúc chạy.