# v2.5.0 — Global Marketing Cluster (2026-MM-DD)

## TL;DR (30 seconds, English)

**v2.5.0** ships the **Global Marketing Cluster** with **30 new global skills (00-29 + product-marketing-context-global)** under `skills/global/`, **8 region-aware workflows**, **5 universal agents** (auto-detect VN vs Global context), and **1 dropshipping flagship**. **Zero breaking changes** — Vietnam cluster (skills 00-21 plus personal-brand 22-28) keeps working as-is.

Pick one of 4 region variants when you start: **US** (USD/FTC), **EU** (EUR-GBP/GDPR), **SEA** (USD-or-local/PDPA per country), **LATAM** (USD-or-local/LGPD). The variant tunes currency, primary platforms, regulations, and persona framework for every downstream skill.

## TL;DR (30 giay, tieng Viet)

**v2.5.0** them cum **Global Marketing Cluster** voi **30 skills moi (00-29 + product-marketing-context-global)** trong thu muc `skills/global/`, **8 workflow co region awareness**, **5 agent universal** (tu nhan dien VN vs Global), va **1 dropshipping flagship**. **Zero breaking changes** — cum Vietnam (skills 00-21 + personal-brand 22-28) van hoat dong y nhu cu.

Chon 1 trong 4 region variant khi bat dau: **US** (USD/FTC), **EU** (EUR-GBP/GDPR), **SEA** (USD hoac local currency/PDPA tung quoc gia), **LATAM** (USD hoac local currency/LGPD). Variant se tu dong cau hinh currency, nen tang chinh, quy dinh phap luat, va persona framework cho moi skill phia sau.

---

## What's New / Co gi moi

### 30 Global Skills / 30 Skills toan cau

**EN:** Skills `00-marketing-plan-global` through `29-dropshipping-mastery-global` plus `product-marketing-context-global` (foundation). Each skill is parallel to its VN counterpart but tuned for international context (USD/EUR/local currency, multi-platform, multi-regulation).

**VN:** Skills `00-marketing-plan-global` den `29-dropshipping-mastery-global` cong them `product-marketing-context-global` (foundation). Moi skill song song voi skill VN tuong ung nhung tuned cho ngu canh quoc te (USD/EUR/local currency, multi-platform, multi-regulation).

| # | Skill | EN summary | VN tom tat |
|---|-------|------------|------------|
| foundation | product-marketing-context-global | Foundation — 4 region variants | Foundation — 4 variants vung |
| 00 | marketing-plan-global | 90-day plan with regional KPIs | Plan 90 ngay voi KPI vung |
| 02 | campaign-brief-global | Campaign brief region-aware | Brief campaign theo vung |
| 04 | script-video-global | Video script TikTok/Reels (en/es/pt etc.) | Script video TikTok/Reels da ngon ngu |
| 05 | ad-copy-global | Ad copy with regional tone | Copy quang cao theo region |
| 08 | competitor-research-global | Competitor research per region | Nghien cuu doi thu theo region |
| 09 | customer-insight-global | Persona by region cluster | Persona theo cluster vung |
| 10 | reverse-kpi-global | KPI math in regional currency | KPI tinh nguoc theo currency |
| 14 | email-marketing-global | Klaviyo/MailChimp flows | Email flow Klaviyo/MailChimp |
| 21 | ads-audit-global | Audit Meta/Google/TikTok ads | Audit Meta/Google/TikTok |
| 22 | personal-brand-context-global | Personal brand foundation (3 archetype) | Foundation personal brand |
| 24 | ai-avatar-production-global | AI avatar production (HeyGen, Synthesia) | AI avatar production toan cau |
| 29 | dropshipping-mastery-global | FLAGSHIP — winning product, ad creative, scaling | FLAGSHIP — winning product, sang tao quang cao, scaling |

(15 other skills omitted from table for brevity — all 30 covered in `skills/global/` folder)

### 4 Region Variants / 4 Region Variants

**EN:** Each region tunes currency, primary platforms, regulations, persona framework:

**VN:** Moi region tu dong cau hinh currency, nen tang chinh, quy dinh phap luat, persona framework:

- **US** — USD, Meta + Google + TikTok + LinkedIn (B2B), FTC + state laws (CCPA), demographic + JTBD persona
- **EU** — EUR/GBP, Meta + Google + LinkedIn + Xing (DACH), GDPR + EU AI Act + DSA, demographic + value-based segmentation
- **SEA** — USD or local (THB/IDR/PHP/MYR/SGD), TikTok + Meta + Shopee/Lazada + LINE (TH), PDPA per country, demographic + cultural cluster
- **LATAM** — USD or local (BRL/MXN/ARS/COP), WhatsApp Business + Meta + Mercado Libre + Magalu (BR), LGPD + per-country PDP, demographic + A/B/C/D/E income class

### 8 Region-Aware Workflows / 8 Workflows region-aware

**EN:** Workflows reference the foundation file and inherit region-specific defaults.

**VN:** Workflows doc foundation file va ke thua region defaults tu dong.

| Workflow | EN purpose | VN muc dich |
|----------|------------|-------------|
| `client-onboard-global.md` | Onboard a global client end-to-end | Onboard client global tu A-Z |
| `campaign-launch-global.md` | 14-day campaign launch | 14 ngay launch campaign |
| `monthly-cycle-global.md` | Monthly review + plan | Review thang + plan thang sau |
| `content-production-global.md` | Weekly content production | Sang tao noi dung hang tuan |
| `personal-brand-launch-global.md` | 30-day personal brand launch | 30 ngay launch personal brand |
| `personal-brand-monthly-global.md` | Monthly personal brand review | Review personal brand hang thang |
| `ai-avatar-batch-global.md` | 30 AI avatar videos in 5 days | 30 video AI avatar trong 5 ngay |
| `dropshipping-launch-global.md` | 30-day dropshipping launch | 30 ngay launch dropshipping |

### 5 Universal Agents / 5 Agent universal

**EN:** All 5 existing agents (mkt-strategist, content-producer, performance-analyst, channel-operator, personal-brand-builder) now auto-detect which context file to read:

**VN:** Tat ca 5 agent (mkt-strategist, content-producer, performance-analyst, channel-operator, personal-brand-builder) gio tu dong nhan dien context file:

- If `.agents/product-marketing-context-global.md` exists -> agent reads global file
- If only `.agents/product-marketing-context.md` (VN) exists -> agent reads VN file
- If both exist -> agent asks once which to use, then remembers in conversation

**VN:** Neu co `.agents/product-marketing-context-global.md` -> doc file global. Neu chi co file VN -> doc file VN. Neu co ca hai -> hoi 1 lan roi nho trong session.

### 1 Dropshipping Flagship / 1 Dropshipping flagship

**EN:** Skill 29 (`29-dropshipping-mastery-global`) is the v2.5.0 flagship — distilled tactical playbook covering winning product criteria, ad creative patterns, and scaling decisions. Paired with workflow `dropshipping-launch-global.md` (30-day plan) and handbook `docs/dropshipping-guide.md` (8 chapters, 30 FAQ).

**VN:** Skill 29 (`29-dropshipping-mastery-global`) la flagship cua v2.5.0 — playbook chien thuat sau ve winning product criteria, pattern sang tao quang cao, va scaling decisions. Di kem voi workflow `dropshipping-launch-global.md` (plan 30 ngay) va cam nang `docs/dropshipping-guide.md` (8 chuong, 30 FAQ).

---

## Changes / Thay doi

### File structure / Cau truc file

**EN:** New folders added:

**VN:** Cac thu muc moi:

```
skills/
├── global/                    # NEW — 30 global skills
│   ├── product-marketing-context-global/
│   ├── 00-marketing-plan-global/
│   ├── ...
│   └── 29-dropshipping-mastery-global/
└── (existing VN skills 00-28 unchanged)

workflows/
├── global/                    # NEW — 8 global workflows
└── (existing VN workflows unchanged)

docs/
├── getting-started-global.md           # NEW
├── global-region-guide.md              # NEW
├── dropshipping-guide.md               # NEW
├── apac-roadmap.md                     # NEW
└── release-notes/v2.5.0.md             # NEW (this file)
```

### Agent updates / Cap nhat agent

**EN:** All 5 agents in `agents/` updated to detect which context file to read. Manifest version bumped from 1.x to 2.0.0 to indicate dual-cluster support.

**VN:** Tat ca 5 agent trong `agents/` da update de detect context file. Phien ban manifest tu 1.x len 2.0.0 de bao hieu support song song hai cum.

---

## Migration Guide / Huong dan migration

**EN:** Zero migration required. v2.5.0 is fully non-breaking:

**VN:** Khong can migration. v2.5.0 la non-breaking hoan toan:

- Existing VN skills (00-28) work as before / Skills VN cu (00-28) van hoat dong y cu
- Existing context files `.agents/product-marketing-context.md` still work / Context file cu `.agents/product-marketing-context.md` van work
- Existing workflows (VN cluster) unchanged / Workflows VN cu khong doi
- Agents auto-detect context file — no config change needed / Agents tu nhan dien context file — khong can config

If you want to try the global cluster / Neu muon thu cum global:

1. Read `docs/getting-started-global.md` (5 minutes) / Doc `docs/getting-started-global.md` (5 phut)
2. Run `/skill product-marketing-context-global` / Chay `/skill product-marketing-context-global`
3. Pick 1 of 4 region variants / Chon 1 trong 4 region variant
4. Continue with workflow / Tiep tuc theo workflow

---

## Quick Start / Khoi dong nhanh

**EN:** See `docs/getting-started-global.md` for the 5-minute quickstart.

**VN:** Xem `docs/getting-started-global.md` cho quickstart 5 phut.

```bash
/plugin update ai-business-skills
/skill product-marketing-context-global
# Pick variant 1-4 (US/EU/SEA/LATAM) / Chon variant 1-4
# Answer 4 collection questions / Tra loi 4 cau thu thap
/skill 00-marketing-plan-global   # Or any other 00-29 / Hoac bat ky skill 00-29 nao
```

---

## Region Overview / Tong quan vung

| Region | EN summary | VN tom tat |
|--------|------------|------------|
| **US** | $77K GDP/capita, Meta + Google + TikTok dominant, FTC + CCPA | GDP $77K, Meta + Google + TikTok dominant, FTC + CCPA |
| **EU** | $45K GDP avg, multi-language, GDPR + EU AI Act mandatory | GDP $45K trung binh, da ngon ngu, GDPR + EU AI Act bat buoc |
| **SEA** | $5-73K range, TikTok + Shopee/Lazada, PDPA per country | Khoang $5-73K, TikTok + Shopee/Lazada, PDPA tung nuoc |
| **LATAM** | $9-17K range, WhatsApp Business dominant, LGPD (BR) | Khoang $9-17K, WhatsApp Business dominant, LGPD (Brazil) |

Full comparison: `docs/global-region-guide.md` / Comparison day du: `docs/global-region-guide.md`

---

## Dropshipping Highlight / Highlight Dropshipping

**EN:** Dropshipping is the v2.5.0 flagship use case for international expansion:

**VN:** Dropshipping la use case flagship cua v2.5.0 cho mo rong quoc te:

- Skill: `29-dropshipping-mastery-global` — tactical playbook
- Workflow: `dropshipping-launch-global.md` — 30-day launch plan, 7-day milestones
- Handbook: `docs/dropshipping-guide.md` — 8 chapters, 30 FAQ
- Default region: US (highest revenue ceiling) — but the skill works across all 4 regions

---

## Bilingual FAQs / FAQ song ngu

**Q1 (EN): Do I need to migrate from v2.4.0?**
**Q1 (VN): Co can migration tu v2.4.0 khong?**
EN: No. v2.5.0 is purely additive. Your VN skills, context files, workflows continue working unchanged.
VN: Khong. v2.5.0 chi them, khong sua. Skills VN, context file, workflows van hoat dong y nhu cu.

**Q2 (EN): Can I use both VN and Global clusters?**
**Q2 (VN): Co the dung ca 2 cum VN va Global khong?**
EN: Yes. Many users do — VN cluster for domestic clients, Global cluster for international expansion. Agents auto-detect which file to read based on active skill.
VN: Co. Nhieu user dung ca hai — cum VN cho client trong nuoc, cum Global cho mo rong quoc te. Agents tu detect file theo skill dang active.

**Q3 (EN): Which region should I pick first?**
**Q3 (VN): Nen chon region nao truoc?**
EN: Pick the region with your highest current revenue. If unclear, default to US (highest revenue ceiling, easiest infra: Stripe, Shopify, Klaviyo). See `docs/global-region-guide.md` for decision tree.
VN: Chon region co revenue cao nhat hien tai. Neu khong ro, default US (revenue ceiling cao nhat, infra de: Stripe, Shopify, Klaviyo). Xem `docs/global-region-guide.md` cho decision tree.

**Q4 (EN): When will Japan/Korea/Australia be added?**
**Q4 (VN): Khi nao co Japan/Korea/Australia?**
EN: APAC is roadmapped for v2.6.0 if criteria are met (5+ issues, 1000 stars, native reviewers). See `docs/apac-roadmap.md`.
VN: APAC nam trong roadmap v2.6.0 neu dat criteria (5+ issue, 1000 star, native reviewer). Xem `docs/apac-roadmap.md`.

**Q5 (EN): Is dropshipping still viable in 2026?**
**Q5 (VN): Dropshipping con kha thi nam 2026 khong?**
EN: Yes, but harder than 2020-2022 era. 90% fail rate; survivors treat it as 12-month learning investment, not 30-day get-rich. Read `docs/dropshipping-guide.md` Chapter 1 for reality check.
VN: Co, nhung kho hon thoi 2020-2022. 90% fail; survivors coi day la dau tu hoc 12 thang, khong phai get-rich 30 ngay. Doc `docs/dropshipping-guide.md` Chuong 1 de reality check.

**Q6 (EN): What if my customers are in multiple regions?**
**Q6 (VN): Khach hang o nhieu region thi sao?**
EN: Run `product-marketing-context-global` once per region; rename output files (e.g. `product-marketing-context-global-us.md`, `-eu.md`). v2.5.0 supports this manually; v2.6.0 may add an explicit flag.
VN: Chay `product-marketing-context-global` 1 lan moi region; doi ten file output (vi du `product-marketing-context-global-us.md`, `-eu.md`). v2.5.0 support manually; v2.6.0 co the them flag.

**Q7 (EN): Does the global cluster support languages other than English?**
**Q7 (VN): Cum global co support ngon ngu khac ngoai English khong?**
EN: Yes. Region variants set the language: EU multi-language (de/fr/es/it/nl/pl), SEA (id/th/tl/ms/zh-SG), LATAM (es/pt-BR). Skills 04 (video), 05 (ad copy), 14 (email) write in target language.
VN: Co. Region variants tu dong set ngon ngu: EU da ngon ngu (de/fr/es/it/nl/pl), SEA (id/th/tl/ms/zh-SG), LATAM (es/pt-BR). Skills 04 (video), 05 (ad copy), 14 (email) viet ngon ngu target.

**Q8 (EN): Can I customize the region variants?**
**Q8 (VN): Co the customize region variants khong?**
EN: Yes. The 12-section foundation file is your customization layer. Edit `.agents/product-marketing-context-global.md` directly to adjust personas, competitors, voice, proof points.
VN: Co. File foundation 12-section la layer customize. Sua truc tiep `.agents/product-marketing-context-global.md` de chinh personas, competitors, voice, proof points.

**Q9 (EN): How do I report a region-specific bug?**
**Q9 (VN): Bao bug specific cua region nhu the nao?**
EN: Open a GitHub issue with label `region:US`, `region:EU`, `region:SEA`, or `region:LATAM`. Include the skill name, the wrong output, and what you expected.
VN: Mo issue GitHub voi label `region:US`, `region:EU`, `region:SEA`, hoac `region:LATAM`. Bao gom ten skill, output sai, va output mong doi.

**Q10 (EN): Will the VN cluster keep getting updates?**
**Q10 (VN): Cum VN co tiep tuc duoc update khong?**
EN: Yes. VN cluster is the project's primary cluster (founder + initial users are VN-based). Global cluster is parallel, not a replacement.
VN: Co. Cum VN la cum chinh cua du an (founder + user dau tien deu o VN). Cum global la song song, khong thay the.

---

## Credits / Loi cam on

**EN:** Built with input from international users requesting expansion beyond Vietnam, dropshipping operators, and contributors who reviewed region-specific content for cultural and regulatory accuracy.

**VN:** Xay dung voi input tu user quoc te yeu cau mo rong ngoai Vietnam, operator dropshipping, va contributors da review noi dung region-specific ve do chinh xac van hoa va phap luat.

Special thanks: native-speaker reviewers for US/EU/SEA/LATAM variants, dropshipping operators who shared real campaign data, and the community for staying patient while we shipped quality over speed.

**VN:** Cam on dac biet: native-speaker reviewers cho US/EU/SEA/LATAM variants, operator dropshipping da chia se data campaign that, va cong dong da kien nhan trong khi chung toi uu tien chat luong hon toc do.

---

## Links

- Repository / Repo: [github.com/minhnv0807/ai-business-skills](https://github.com/minhnv0807/ai-business-skills)
- Release page: [github.com/minhnv0807/ai-business-skills/releases/tag/v2.5.0](https://github.com/minhnv0807/ai-business-skills/releases/tag/v2.5.0)
- Getting started (EN): [docs/getting-started-global.md](../getting-started-global.md)
- Getting started (VN): [docs/getting-started.md](../getting-started.md)
- Region guide: [docs/global-region-guide.md](../global-region-guide.md)
- Dropshipping handbook: [docs/dropshipping-guide.md](../dropshipping-guide.md)
- APAC roadmap: [docs/apac-roadmap.md](../apac-roadmap.md)
- Issues / Bao loi: [github.com/minhnv0807/ai-business-skills/issues](https://github.com/minhnv0807/ai-business-skills/issues)
