Personal Brand ai Avatar Design

# Design Spec — Personal Brand + AI Avatar Cluster (v2.4.0)

> **Status:** Approved by user (brainstorming phase complete)
> **Created:** 2026-05-08
> **Author:** MKT Strategist AI (brainstorming session with @minhnv0807)
> **Target version:** v2.4.0 (minor bump from v2.3.0)
> **Implementation:** 3 PRs incremental (Approach 2)
> **Future path:** Approach 3 modular MVP (see Section 10)

---

## Executive Summary

Mở rộng dự án `ai-business-skills` (đang ở v2.3.0 với 22 skills marketing thương hiệu doanh nghiệp) bằng cụm skill mới chuyên về **Personal Branding với AI Avatar**, phục vụ 3 nhóm đối tượng: Founder/CEO, Coach/Consultant, Creator/KOL.

**Phạm vi:**
- 7 skills mới (22–28) trong cluster `personal-brand`
- 1 agent persona mới (`personal-brand-builder`)
- 3 workflows mới (launch / batch / monthly)
- 3 reference files mới (tools, voice prompts, disclosure VN)
- Mở rộng 2 skill cũ (04, 05) với "Personal Brand Mode"
- Pattern variants (3 variants ở foundation skill 22)
- 0 breaking changes — backward compatible 100%

**Tổng quy mô:** ~6,740 dòng mới + ~900 dòng updates root files = 32 file đụng tới.
*(Đã scale-up cho "newbie-friendly" requirement 2026-05-08: workflow chi tiết, getting-started guide, "Cho người mới" sections trong mỗi skill)*

**Timeline:** 14 ngày (3 PRs phased + 2 ngày documentation polish cho newbie).

---

## Decisions Log

5 câu hỏi đã được hỏi và chốt trong brainstorming session ngày 2026-05-08:

| # | Câu hỏi | Đáp án | Lý do |
|---|---------|--------|-------|
| 1 | Đối tượng chính | **D** — Cả 3 nhóm: Founder + Coach + Creator | User muốn cluster phục vụ rộng, áp dụng pattern variants giống skill 20 |
| 2 | Quy mô | **C-2** — 7 skills mới + mở rộng 04/05 | Tránh trùng lặp với skill 04/05 hiện có (overlap ~80% format) |
| 3 | AI Avatar depth | **C** — Deep dive 3 references | User muốn giá trị cao về tools, ethics, multi-workflow |
| 4 | Workflow + Agent | **C.X** — 3 workflows + 1 agent mới | Personal brand là sub-domain riêng cần persona tách biệt |
| 5 | Variants pattern | **B** — Variants chỉ ở foundation 22 | YAGNI — 3 variants đủ, sau iterate lên 9/21 nếu thực sự cần |

**Quyết định bổ sung (2026-05-08, sau brainstorm):**
- Rollout **Approach 2** — incremental 3 PRs trong 1 version
- Branch strategy: `feature/v2.4-personal-brand-cluster` (parent long-running) + 3 sub-branches (`phase-1-foundation`, `phase-2-content-production`, `phase-3-monetize-community`)
- Release timing: **KHÔNG dùng rc tags** (rc1, rc2) — chỉ tag `v2.4.0` final khi hoàn thành cả 3 phases. Lý do: solo maintainer, mỗi phase đã merge master sau pass 10 Quality Gates → ai pull master có "beta" thực
- Documentation chỉn chu: release notes bilingual, Mermaid diagrams, GitHub Discussion pinned
- **Newbie-friendly requirement (BỔ SUNG QUAN TRỌNG):**
  - Mỗi workflow file: 150 → 350-400 dòng (thêm Pre-flight Checklist, Step-by-step cho newbie, Common Pitfalls, AI Research Prompts × 5, Glossary)
  - `docs/personal-brand-guide.md`: 250 → 600 dòng (8 chương đầy đủ)
  - File mới `docs/getting-started-personal-brand.md` (~200 dòng — 5-phút quickstart)
  - Mỗi SKILL.md (22-28) thêm section "Cho người mới" (~50 dòng/skill)
  - Workflow files có placeholder cho YouTube video link (sẽ quay sau release)

---

## Section 1 — Tổng quan kiến trúc & Version impact

### Phạm vi tổng thể