description: "Research phase orchestrator: Extracts Brand DNA and generates Audience Persona using AI" version: "1.0"

/seo-research-audience

Purpose

Generates a comprehensive audience persona mapping based on the Brand DNA provided in the project.json configuration file. This is the first essential module in the SEO research pipeline.

Đầu ra chính là cơ sở dữ liệu hành vi độc giả (audience.json), làm la bàn cho mọi quyết định phân cụm và phóng tác ý định tìm kiếm sau này.

Skills Activated

Prerequisites

• Yêu cầu cấu hình dự án project.json đã có sẵn (hoàn thành từ bước /seo-onboard).

Sub-Agent Coordination

• Primary Executor: @[topical-authority-planner] (profiles target audience and semantic interests)
• Co-owner: @[search-intent-profiler] (maps user search behaviors and intents)

Execution Flow

Step 1: Init Project

• Đọc SLUG = domain.replace('.', '-') ➔ nạp cấu hình từ .seo/project.json.

Step 2: Socratic Greenfield Gate & Exclusions Check

• Load DNA anchors, target_market, primary_goal, competitors, và industry từ project.json.
• Kiểm tra ngành nghề industry: Chấp nhận mọi ngành nghề động (zero-hardcode). Không giới hạn ở một danh sách cố định nào.
• Load bộ lọc từ chối từ exclusions.json. Nếu chưa có, nạp danh sách loại trừ mặc định.

Step 3: Audience Persona Analysis (Multi-Agent Debate)

Quy trình được thực thi theo mô hình tranh biện 3 pha để đảm bảo chất lượng và số lượng (5-8 personas):

• Phase 1: Propose (Topical Authority Planner)
  • Gọi skill seo-audience và nạp cấu hình DNA từ project.json.
  • Chạy các truy vấn search_web tìm hiểu sâu về đối thủ, thị trường.
  • Phân tích và đề xuất tập hợp 5-8 personas đa dạng, bao trùm cả chuỗi quyết định (Decision-Makers) và người dùng cuối (End-Users).
• Phase 2: Critique (SEO CMO / Tech SEO Director)
  • Đóng vai trò phản biện (Critique): Đánh giá danh sách personas đã đề xuất, kiểm tra xem có bỏ sót phân khúc nào không, liệu các hành vi tìm kiếm (Search Triggers, Journey) có thực tế và đáp ứng Information Gain không.
  • Phản hồi các điểm yếu hoặc các persona cần gộp/chia tách để sát thực tế ngành.
• Phase 3: Finalize
  • Dựa trên phản biện, điều chỉnh và thực thi prompt persona_generation_llm.md để sinh cấu hình JSON cuối cùng.
  • Ghi kết quả JSON sạch ra file tạm .seo/data/temp_audience.json.
• Thực thi script Python để parse và validate JSON (Zero-Hardcode Validation):

  python .agents/scripts/run_plugin_script.py seo-audience audience_analyzer.py --import-json .seo/data/temp_audience.json
  

• Output: Cơ sở dữ liệu hành vi độc giả được lưu tại .seo/data/audience.json.

🛑 PAUSE Gate 1a: Phê duyệt Persona

• Hiển thị bảng tóm tắt Persona trực quan cho người dùng.
• Chờ người dùng phản hồi Y hoặc tiếp tục để ghi nhận hoàn tất quy trình và lưu checkpoint.
• Cập nhật project.json.workflow_checkpoint với {workflow: "seo-research-audience", status: "completed"}.

Final Dashboard

Trình bày báo cáo tổng kết (Final Dashboard) bằng Markdown trực quan, hướng người dùng (user-facing) và cung cấp thông tin chi tiết về tập dữ liệu vừa tạo. Tránh dùng hộp ASCII khô khan. Sử dụng template sau:

# 🎯 Báo cáo Audience Persona — `{domain}`

**Trạng thái**: Hoàn tất phân tích & lưu trữ dữ liệu

## 📊 Tổng quan Chân dung Khách hàng (Personas)

Hệ thống đã phân tích và thiết lập thành công **{count}** chân dung khách hàng (personas) dựa trên Brand DNA của dự án:

*(Hiển thị danh sách tóm tắt các persona ở đây)*
- **[Tên Persona 1]** ([Vai trò/Phân khúc]): [Đặc điểm nổi bật hoặc mục tiêu chính]
- **[Tên Persona 2]** ([Vai trò/Phân khúc]): [Đặc điểm nổi bật hoặc mục tiêu chính]
- ...

## 🔍 Insight Nổi Bật (Search Behavior)

*(Trích xuất nhanh một số insight quan trọng từ quá trình phân tích)*
- **Nỗi đau chính (Pain points)**: [Liệt kê 2-3 điểm đau chung lớn nhất mà các personas đang gặp phải]
- **Động lực tìm kiếm (Search Triggers)**: [Các yếu tố thúc đẩy họ tìm kiếm thông tin]

## 📁 Dữ liệu & Lưu trữ

- **Cơ sở dữ liệu Persona**: `.seo/data/audience.json`
- **Dấu thời gian**: {thời gian hoàn tất}

---

💡 **Bước tiếp theo (Next Step):**
Để tiếp tục quy trình SEO Research, hãy chạy lệnh:
👉 `/seo-research-knowledge-graph` để bắt đầu phân tích thực thể và xây dựng Knowledge Graph cho dự án.