heraspec 0.1.16 → 0.1.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,143 @@
1
+ ---
2
+ name: content-voice-adapter
3
+ description: Transmute and adapt any arbitrary raw content, article, or idea to match the specific DNA, philosophy, tone of voice, and TTS acoustic standards of any designated channel.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Skill: Content Voice Adapter
8
+
9
+ ## Purpose
10
+ Take any arbitrary raw content (raw article, folk story, health tip, social post, quote, reflection, or rough draft) and transmute it through a target channel's **Specific Philosophical Lens & Tone of Voice**, eliminating genre-specific off-brand elements, reframing the core insight, and restructuring it into MTxStudio's standardized 6-part video script schema.
11
+
12
+ ---
13
+
14
+ ## The Dynamic Transmutation Framework
15
+
16
+ Content transmutation is **NOT one-size-fits-all**. What constitutes "off-brand" (lệch tone) and how content is restructured completely change depending on the channel's niche, target audience, and legal constraints.
17
+
18
+ ```text
19
+ ┌────────────────────────────────────────────────────────────────────────┐
20
+ │ 1. CONTENT EXTRACTION & DYNAMIC DE-BIASING │
21
+ │ - Extract core human insight, story premise, or practical value │
22
+ │ - Purge genre-specific negative triggers via De-biasing Matrix │
23
+ │ (e.g., horror: purge real place names & gore; healing: purge │
24
+ │ fatalism & victimhood; health: purge pseudoscience/overpromising)│
25
+ └───────────────────────────────────┬────────────────────────────────────┘
26
+ │
27
+ ┌───────────────────────────────────▼────────────────────────────────────┐
28
+ │ 2. CHANNEL DNA REFRAMING & VOICE PERSONA │
29
+ │ - Reframe core insight through channel philosophy & narrative lens │
30
+ │ - Adapt persona pronouns (I - You / We / 3rd-person narrator) │
31
+ │ - Map vocabulary domain & signature metaphors to audience archetype │
32
+ └───────────────────────────────────┬────────────────────────────────────┘
33
+ │
34
+ ┌───────────────────────────────────▼────────────────────────────────────┐
35
+ │ 3. GENRE-AWARE TTS ACOUSTIC ADAPTATION │
36
+ │ - Enforce sentence pacing: 12-20 words/sentence, 8-12 words/clause │
37
+ │ - Pacing style: Chilling suspense (horror) vs. Gentle warmth │
38
+ │ (healing) vs. Clear instructional (health) vs. Rhythm/rhyme (poem)│
39
+ │ - Prevent Reduplicative Looping, zero artificial tags │
40
+ │ - Preserve \n newline for rhythmic verse and breathing pauses │
41
+ └───────────────────────────────────┬────────────────────────────────────┘
42
+ │
43
+ ┌───────────────────────────────────▼────────────────────────────────────┐
44
+ │ 4. 6-PART SCHEMA & COMPLIANCE ASSEMBLY │
45
+ │ - Fatal Hook (0:00 - 0:15) tailored to format (16:9 or 9:16) │
46
+ │ - Audio Narration Script & Technical Audio Pacing │
47
+ │ - Scene-by-scene Storyboard with Midjourney/Flux Art Style Prompts │
48
+ │ - Facebook Caption & Engagement Hook │
49
+ │ - Genre-Specific Legal Disclaimer (Decree 15 / Medical / Financial) │
50
+ └────────────────────────────────────────────────────────────────────────┘
51
+ ```
52
+
53
+ ---
54
+
55
+ ## Dynamic De-biasing Matrix (Niche-Specific Negative Filtering)
56
+
57
+ When transmuting content, the AI agent MUST consult this matrix to apply the exact negative filtering criteria required for the target niche:
58
+
59
+ | Channel Niche | Reference Channel | Negative Constraints to Purge ("Off-Brand") | Target Transmutation Direction |
60
+ | :--- | :--- | :--- | :--- |
61
+ | **Healing & Psychology** | *Làm Bạn Với Bản Thân*, *An Trú Quán* | ❌ Superstition, fate-blaming, resentment, victim mindset, moral preaching | ✅ Turning inward, acknowledging wounds, emotional boundary setting, inner peace |
62
+ | **Horror & Paranormal** | *Truyện Ma Đêm Mưa* | ❌ Gratuitous gore, real names of temples/pagodas/people (Decree 15 violation), frivolous disrespect, black magic curses | ✅ Safe atmospheric fiction, psychological suspense, eerie mood, karmic retribution, ethical closure |
63
+ | **Health & Wellness** | *Thân An Tâm Lạc* | ❌ Miracle cures, 100% cure guarantees, anti-medical advice, diagnosing diseases, fearmongering | ✅ Everyday safe wellness, gentle stretching, mindful tea/diet, respecting medical guidance |
64
+ | **Life Reflection** | *Góc Chiêm Nghiệm* | ❌ Cynical whining, abstract academic lecturing, impractical theories, hatred or malice | ✅ Pragmatic fortitude, human psychological insight, mindful living, calm composure under adversity |
65
+ | **Philosophy & Zen** | *Tĩnh Tâm Quán* | ❌ Wealth-worship rituals, superstitious fortune telling, sectarian disputes, judging other groups | ✅ Compassionate wisdom, letting go of distress, filial piety to parents, karmic mindfulness |
66
+ | **Poetry & Nostalgia** | *Năm Năm Tháng Tháng* | ❌ Abrupt modern slang, excessive melodrama, bitter resentment toward the past, broken meter | ✅ Lyrical verse / poetic prose, honoring family memories, pure bittersweet nostalgia, musical cadence |
67
+ | **Finance & Business** | *Tài Chính Thực Chiến* | ❌ Guaranteed ROI, get-rich-quick schemes, multi-level marketing, exaggerated product claims | ✅ Prudent money management, investment discipline, objective product evaluation |
68
+
69
+ ---
70
+
71
+ ## Channel DNA Profiles
72
+
73
+ ### 1. Làm Bạn Với Bản Thân (`lam_ban_voi_ban_than`)
74
+ * **Core Philosophy**: "A sanctuary for weary hearts to let go of external expectations and cultivate inner peace."
75
+ * **Persona**: Compassionate, non-judgmental companion.
76
+ * **Transmutation Example**:
77
+ - *Raw*: "You are destined by fate to be alone until your past karmic debt is paid..."
78
+ - ➔ *Transmuted*: "Solitude is a sacred space where you learn to honor your self-worth, set healthy emotional boundaries, and become your own truest friend first."
79
+ * **Audio Voice**: Warm female, slow 112-116 wpm, Lo-fi acoustic solo piano.
80
+ * **Visual Style**: Minimalist pastel watercolor, cozy indoor warmth, gentle natural morning light.
81
+
82
+ ### 2. Truyện Ma Đêm Mưa (`truyen_ma_dem_mua`)
83
+ * **Core Philosophy**: "Telling chilling midnight tales - Karma never misses anyone."
84
+ * **Persona**: Mysterious late-night storyteller with a deep, atmospheric voice and an unwavering moral compass.
85
+ * **Transmutation Example**:
86
+ - *Raw*: Forum story mentioning real pagoda names, graphic torture, and black magic vengeance.
87
+ - ➔ *Transmuted*: Fictionalized story setting (Pagoda T., Village K.), focusing on eerie suspense, psychological fear, and a righteous karmic resolution.
88
+ * **Audio Voice**: Deep male baritone, 118 wpm, Dark Ambient cello, ominous sub-bass.
89
+ * **Visual Style**: Dark cinematic, heavy shadows, flickering candlelight, foggy twilight.
90
+
91
+ ### 3. Tĩnh Tâm Quán (`tinh_tam_quan`)
92
+ * **Core Philosophy**: "A daily verse of mindfulness - Sowing wholesome seeds, letting go of sorrow."
93
+ * **Persona**: Serene spiritual mentor, dignified, deeply compassionate.
94
+ * **Transmutation Example**: Converts daily grievances and rivalry into lessons on releasing grudges, honoring parents, and practicing mindfulness.
95
+ * **Audio Voice**: Mature male, measured 115 wpm, temple bells, bamboo flute.
96
+ * **Visual Style**: Traditional Zen ink wash painting (thủy mặc), misty mountains, white lotus.
97
+
98
+ ### 4. Góc Chiêm Nghiệm (`goc_chiem_nghiem`)
99
+ * **Core Philosophy**: "Pausing amidst the rush - To understand human nature and stride forward with fortitude."
100
+ * **Persona**: Seasoned, poised observer of life, realistic yet never bitter.
101
+ * **Transmutation Example**: Reframes social setbacks into self-reliance, emotional resilience, and calm composure without blaming circumstances.
102
+ * **Audio Voice**: Neutral, poised, 120 wpm, modern acoustic guitar and cello.
103
+ * **Visual Style**: Urban cafe aesthetic, dusk streetlights, warm coffee tones.
104
+
105
+ ### 5. Thân An Tâm Lạc (`than_an_tam_lac`)
106
+ * **Core Philosophy**: "When the body is at ease, the mind finds joy - Small daily habits for a tired body."
107
+ * **Persona**: Attentive wellness practitioner promoting harmony with nature.
108
+ * **Transmutation Example**: Converts exaggerated health hacks into safe relaxation habits (foot baths, acupressure, deep breathing) paired with medical disclaimers.
109
+ * **Audio Voice**: Warm, gentle, relaxed 120 wpm, singing bowls, trickling water sound.
110
+ * **Visual Style**: Organic herbal textures, tea ceremony, morning forest sun.
111
+
112
+ ### 6. Năm Năm Tháng Tháng (`nam_nam_thang_thang`)
113
+ * **Core Philosophy**: "Drifting through months and years, gathering memories into verse."
114
+ * **Persona**: Nostalgic traveler cherishing childhood memories and vintage heirlooms.
115
+ * **Transmutation Example**: Transmutes past hardships and nostalgia into six-eight (*lục bát*) verse or poetic prose honoring parental devotion.
116
+ * **Audio Voice**: Slow rhythmic cadence 110 wpm, acoustic nylon guitar, rain sounds.
117
+ * **Visual Style**: Vintage watercolor, sepia rustic village, retro film photography.
118
+
119
+ ---
120
+
121
+ ## Universal Activation Prompt Template
122
+
123
+ Copy and use this prompt when adapting any raw draft for **any channel**:
124
+
125
+ ```text
126
+ Use skill content-voice-adapter to transmute the raw text below into a production-ready Video Script for channel [CHANNEL_NAME] (Niche: [CHANNEL_NICHE]):
127
+
128
+ [PASTE RAW INPUT TEXT HERE]
129
+
130
+ Execution Requirements across 4 Steps:
131
+ 1. Dynamic De-biasing:
132
+ - Extract core insight and purge all off-brand elements based on the De-biasing Matrix: [List negative constraints, e.g., victim mindset / superstitious fatalism / medical overpromising / graphic gore].
133
+ 2. Channel DNA Reframing:
134
+ - Persona Pronouns: [e.g., Tôi - Bạn / Chúng ta / 3rd-person].
135
+ - Target Emotional State: [e.g., Inner Peace / Gripping Suspense / Soothed Relaxation / Fortitude].
136
+ 3. TTS Acoustic Optimization:
137
+ - Sentence length strictly 12-20 words, comma clauses 8-12 words, zero duplicate reduplicative words.
138
+ - ZERO artificial bracket tags ([breath], [sigh], etc.).
139
+ - Preserve \n newline for poetry or rhythmic breathing.
140
+ 4. MTxStudio 6-Part Schema Packaging:
141
+ - Generate: Fatal Hook, Spoken Narration Script, Visual Storyboard Prompts (English, matching channel art style), Facebook Caption, and Genre-Specific Legal Disclaimer.
142
+ - Spoken script and captions in Vietnamese; Visual Prompts in English.
143
+ ```
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: content-channel
3
+ description: Enterprise guidelines and skill suite for multi-channel social video/audio content production, channel DNA development, AI voice synthesis optimization, and MTxStudio vault integration.
4
+ projectType: content-channel
5
+ ---
6
+
7
+ # Content & Multi-Channel Production Framework
8
+
9
+ This skill suite serves as the authoritative framework for developing, scaling, and managing multi-channel content operations across Facebook, YouTube, TikTok, and Podcasts, integrated directly with the desktop studio application **MTxStudio (Script & Content Vault v2)**.
10
+
11
+ ---
12
+
13
+ ## 1. Core Content Skills Ecosystem
14
+
15
+ ```text
16
+ heraspec/skills/
17
+ ├── content-strategy # Channel positioning, 5-pillar matrix, 14-day Cold Start, $100 RPM monetization
18
+ ├── content-scaffolding # Standard 2-level directory tree, zero [Channel] prefix, export auto-discovery
19
+ ├── content-scripting # Standard 6-part episode authoring, natural acoustic TTS optimization
20
+ ├── content-voice-adapter # Raw content de-biasing and transmutation through target channel DNA
21
+ ├── content-prompts # Cinematic AI visual prompts (Avatar, Cover, Storyboard) & Suno BGM
22
+ ├── content-compliance # Legal safety, platform policy compliance, 3-position disclaimers
23
+ └── content-vault-sync # Data integrity validation, dash sanitization, MTxStudio JSON export
24
+ ```
25
+
26
+ ---
27
+
28
+ ## 2. Inviolable Operational Rules
29
+
30
+ 1. **Golden Naming Rule (Pure Brand Identity)**:
31
+ - ❌ **NEVER** prepend `[Channel]`, `[Kênh]`, or `Channel:` to folder names, identifiers, or titles.
32
+ - ✅ Use 100% pure brand names (e.g., `Làm Bạn Với Bản Thân`, `Truyện Ma Đêm Mưa`, `Thân An Tâm Lạc`, `An Trú Quán`).
33
+
34
+ 2. **2-Level MTxStudio Tree Hierarchy**:
35
+ - Every channel repository maps into standardized subcategories:
36
+ - `_plan` (`type: "docs"`, icon: `Layers`)
37
+ - `_posts` (`type: "article"`, icon: `BookOpen`)
38
+ - `_prompts` (`type: "prompts"`, icon: `Sparkles`)
39
+ - `_music` (`type: "music"`, icon: `Radio`)
40
+ - `_affiliate` (`type: "docs"`, icon: `Tag`, optional)
41
+
42
+ 3. **Natural Acoustic TTS Rules (Clean Voice Synthesis)**:
43
+ - Maintain sentence length between **12 to 20 words** (maximum 25 words).
44
+ - Clauses separated by commas must span **8 to 12 words**.
45
+ - ❌ **ABSOLUTELY NO artificial bracket tags** (e.g., `[breath]`, `[sigh]`, `[0.3s]`, `[lấy hơi]`, `[thở dài]`). Rely entirely on natural punctuation and sentence cadence.
46
+ - Prevent repetition loops on phonetic/reduplicative words by inserting commas and avoiding consecutive duplicate roots.
47
+
48
+ 4. **Poetry & Verse Line Integrity**:
49
+ - Every verse line MUST occupy its own individual line (`\n`). Stanzas must be separated by an empty line (`\n\n`).
50
+ - ❌ NEVER collapse verse lines using `join(' ')`.
51
+
52
+ 5. **3-Position Legal Disclaimer**:
53
+ - For sensitive categories (Horror/Supernatural, Health/Wellness, Psychology, Finance), disclaimers must be deployed in 3 spots:
54
+ 1. Video **Intro Warning Card (0:00 - 0:04)**.
55
+ 2. Post **Caption footer or Pinned Top Comment**.
56
+ 3. Spoken **Audio Narration** for long-form podcasts (>10 mins).
57
+
58
+ ---
59
+
60
+ ## 3. Quick Reference Matrix
61
+
62
+ | Goal | Target Skill | Required Input | Output Artifact |
63
+ | :--- | :--- | :--- | :--- |
64
+ | Plan and position a new channel | `content-strategy` | Channel concept, niche, target audience | 30-day `plan.md`, 5-pillar matrix, RPM KPI |
65
+ | Scaffold folders and initial files | `content-scaffolding` | Channel name, color, icon, slogan | Standard folders, starter post, prompts suite |
66
+ | Write a brand new episode script | `content-scripting` | Channel name, episode topic, pillar | Standard 6-part `posts/{index}.md` script |
67
+ | Transmute raw text into channel DNA | `content-voice-adapter` | Raw draft/article + Target channel | De-biased script aligned with channel voice |
68
+ | Generate visual prompts or Suno BGM | `content-prompts` | Channel name, script scene descriptions | Midjourney/SD prompts, Suno instrumental tags |
69
+ | Audit legal risk and generate disclaimers | `content-compliance` | Channel niche (Horror, Health, Healing) | Standardized legal disclaimer + Warning Card |
70
+ | Package and export to MTxStudio | `content-vault-sync` | Markdown posts, plans, and prompts | Clean `mtxstudio_vault_import.json` bundle |
71
+
72
+ ---
73
+
74
+ ## 4. Multi-Language Directives
75
+
76
+ - **Instruction & Meta-Logic**: All skills and operational reasoning are structured in English for maximum LLM instruction-following accuracy.
77
+ - **Audience-Facing Creative Content**: Generated in the channel's target language as defined in `plan.md` (e.g., Vietnamese, English, Japanese).
78
+ - **Visual & Audio Generation Prompts**: Always formulated in English for optimal image/music synthesis quality (Midjourney, Flux, Stable Diffusion, Suno AI).
79
+ - **Markdown Structural Contract**: When outputting posts for channels processed by `export_vault_json.py`, retain the required section heading literals:
80
+ ```markdown
81
+ # TẬP {number}: {TITLE}
82
+ ## 1. HOOK MỞ ĐẦU
83
+ ## 2. KỊCH BẢN THUYẾT MINH & LỜI THOẠI CHI TIẾT
84
+ ### PHÂN CẢNH VISUAL STORYBOARD
85
+ ## 4. CAPTION FACEBOOK BÀI ĐĂNG
86
+ ## 5. SẢN PHẨM AFFILIATE GẮN KÈM
87
+ ```
88
+
89
+ ---
90
+
91
+ ## 5. Standard Production Workflows
92
+
93
+ ### Workflow A: Daily Script Adaptation from Raw Input
94
+ ```
95
+ [Raw External Article / Story / Idea]
96
+ │
97
+ ▼ (Activate: content-voice-adapter)
98
+ [De-biased, Reframed 6-Part Script Matching Channel DNA]
99
+ │
100
+ ▼ (Activate: content-compliance)
101
+ [Attach Genre Disclaimer & Intro Warning Card Prompt]
102
+ │
103
+ ▼ (Save to: Facebook/[Channel]/posts/{index}.md)
104
+ │
105
+ ▼ (Activate: content-vault-sync)
106
+ [Run export_vault_json.py ➔ Import bundle into MTxStudio]
107
+ ```
108
+
109
+ ### Workflow B: Complete Channel Launch
110
+ ```
111
+ [New Channel Concept]
112
+ │
113
+ ▼ (Activate: content-strategy)
114
+ [30-Day Master Plan plan.md + 5 Pillars + $100 RPM Model]
115
+ │
116
+ ▼ (Activate: content-scaffolding)
117
+ [Create 2-Level Folder Tree + Pure Brand Name + Prompts Suite]
118
+ │
119
+ ▼ (Activate: content-prompts)
120
+ [Generate Avatar 1:1, Cover 16:9, Warning Card & Suno BGM]
121
+ │
122
+ ▼ (Activate: content-scripting)
123
+ [Produce Episode Batches in posts/]
124
+ │
125
+ ▼ (Activate: content-vault-sync)
126
+ [Export Master Vault Package ➔ 1-Click MTxStudio Import]
127
+ ```
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import { createRequire } from 'module'; const require = createRequire(import.meta.url);
1
+ import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
2
2
  var __defProp = Object.defineProperty;
3
3
  var __getOwnPropNames = Object.getOwnPropertyNames;
4
4
  var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
@@ -36,7 +36,8 @@ var init_config = __esm({
36
36
  "generic-webapp",
37
37
  "backend-api",
38
38
  "frontend-app",
39
- "multi-stack"
39
+ "multi-stack",
40
+ "content-channel"
40
41
  ];
41
42
  SKILLS = {
42
43
  "wordpress-plugin": [
@@ -119,6 +120,15 @@ var init_config = __esm({
119
120
  "api-contract",
120
121
  "shared-type",
121
122
  "integration-point"
123
+ ],
124
+ "content-channel": [
125
+ "content-strategy",
126
+ "content-scaffolding",
127
+ "content-scripting",
128
+ "content-voice-adapter",
129
+ "content-prompts",
130
+ "content-compliance",
131
+ "content-vault-sync"
122
132
  ]
123
133
  };
124
134
  HERASPEC_MARKERS = {
@@ -460,6 +470,84 @@ var init_skills_template_map = __esm({
460
470
  templateFileName: "wordpress/plugin-directory/skill.md",
461
471
  isCrossCutting: false,
462
472
  projectType: "wordpress-plugin"
473
+ },
474
+ // Content Channel skills
475
+ "content-channel": {
476
+ templateFileName: "content-channel/skill.md",
477
+ isCrossCutting: true,
478
+ resourceDirs: [
479
+ "content-channel/content-strategy",
480
+ "content-channel/content-scaffolding",
481
+ "content-channel/content-scripting",
482
+ "content-channel/content-voice-adapter",
483
+ "content-channel/content-prompts",
484
+ "content-channel/content-compliance",
485
+ "content-channel/content-vault-sync"
486
+ ]
487
+ },
488
+ "content-channel:content-strategy": {
489
+ templateFileName: "content-channel/content-strategy/skill.md",
490
+ isCrossCutting: false,
491
+ projectType: "content-channel"
492
+ },
493
+ "content-channel:content-scaffolding": {
494
+ templateFileName: "content-channel/content-scaffolding/skill.md",
495
+ isCrossCutting: false,
496
+ projectType: "content-channel"
497
+ },
498
+ "content-channel:content-scripting": {
499
+ templateFileName: "content-channel/content-scripting/skill.md",
500
+ isCrossCutting: false,
501
+ projectType: "content-channel"
502
+ },
503
+ "content-channel:content-voice-adapter": {
504
+ templateFileName: "content-channel/content-voice-adapter/skill.md",
505
+ isCrossCutting: false,
506
+ projectType: "content-channel"
507
+ },
508
+ "content-channel:content-prompts": {
509
+ templateFileName: "content-channel/content-prompts/skill.md",
510
+ isCrossCutting: false,
511
+ projectType: "content-channel"
512
+ },
513
+ "content-channel:content-compliance": {
514
+ templateFileName: "content-channel/content-compliance/skill.md",
515
+ isCrossCutting: false,
516
+ projectType: "content-channel"
517
+ },
518
+ "content-channel:content-vault-sync": {
519
+ templateFileName: "content-channel/content-vault-sync/skill.md",
520
+ isCrossCutting: false,
521
+ projectType: "content-channel"
522
+ },
523
+ // Direct aliases (cross-cutting)
524
+ "content-strategy": {
525
+ templateFileName: "content-channel/content-strategy/skill.md",
526
+ isCrossCutting: true
527
+ },
528
+ "content-scaffolding": {
529
+ templateFileName: "content-channel/content-scaffolding/skill.md",
530
+ isCrossCutting: true
531
+ },
532
+ "content-scripting": {
533
+ templateFileName: "content-channel/content-scripting/skill.md",
534
+ isCrossCutting: true
535
+ },
536
+ "content-voice-adapter": {
537
+ templateFileName: "content-channel/content-voice-adapter/skill.md",
538
+ isCrossCutting: true
539
+ },
540
+ "content-prompts": {
541
+ templateFileName: "content-channel/content-prompts/skill.md",
542
+ isCrossCutting: true
543
+ },
544
+ "content-compliance": {
545
+ templateFileName: "content-channel/content-compliance/skill.md",
546
+ isCrossCutting: true
547
+ },
548
+ "content-vault-sync": {
549
+ templateFileName: "content-channel/content-vault-sync/skill.md",
550
+ isCrossCutting: true
463
551
  }
464
552
  };
465
553
  }
@@ -3280,7 +3368,8 @@ var ProjectTypeSchema = z.enum([
3280
3368
  "generic-webapp",
3281
3369
  "backend-api",
3282
3370
  "frontend-app",
3283
- "multi-stack"
3371
+ "multi-stack",
3372
+ "content-channel"
3284
3373
  ]);
3285
3374
  var SpecMetaSchema = z.object({
3286
3375
  projectType: z.union([
@@ -3368,6 +3457,12 @@ When the user types messages starting with a slash (/), you MUST intercept them
3368
3457
  ## Overview
3369
3458
  Describe your project here.
3370
3459
 
3460
+ ## Project Types
3461
+ - List your project type(s) here (e.g., content-channel, node-service, wordpress-plugin, wordpress-theme, perfex-module, laravel-package, generic-webapp, backend-api, frontend-app, multi-stack)
3462
+
3463
+ ## Tech Stack
3464
+ - List primary languages, frameworks, runtime, and key libraries
3465
+
3371
3466
  ## Architecture
3372
3467
  Describe the high-level architecture: entry points, module structure, data flow.
3373
3468
 
@@ -3443,7 +3538,7 @@ The following commands are classified by risk level. You **MUST NOT** execute th
3443
3538
  - Existing architecture patterns
3444
3539
  - Coding standards
3445
3540
 
3446
- > **IGNORE backup files**: Files like \\\`project.back1.md\\\`, \\\`project.back2.md\\\`, etc. are automatic backups created during \\\`heraspec init\\\` updates. NEVER read or reference them unless explicitly asked by the user. Only \\\`project.md\\\` is the source of truth.
3541
+ > **IGNORE backup files**: Files like \`project.back1.md\`, \`project.back2.md\`, etc. are automatic backups created during \`heraspec init\` updates. NEVER read or reference them unless explicitly asked by the user. Only \`project.md\` is the source of truth.
3447
3542
 
3448
3543
  **Then scaffold:**
3449
3544
  - \`heraspec/changes/<slug>/\` - Create proposal.md, tasks.md, design.md (optional)
@@ -3575,7 +3670,22 @@ The following commands are classified by risk level. You **MUST NOT** execute th
3575
3670
  10. **Zero Emojis**: 0 Unicode emojis across custom code, comments, views, documentation, and UI.
3576
3671
  - Use templates from \`heraspec/skills/perfex-module/module-codebase/templates/\` (module-main.php, install.php, uninstall.php, controller-admin.php, controller-api.php, model-main.php, helper.php, deploy.ps1, webpack.config.js).
3577
3672
 
3578
-
3673
+ **Special case - Content & Channel Development skills (projectType: content-channel):**
3674
+ - Tasks: \`(projectType: content-channel, skill: content-strategy)\`, \`(skill: content-scaffolding)\`, \`(skill: content-scripting)\`, \`(skill: content-voice-adapter)\`, \`(skill: content-prompts)\`, \`(skill: content-compliance)\`, \`(skill: content-vault-sync)\`, or \`(skill: content-channel)\`
3675
+ - Install: \`heraspec skill add content-channel\` or \`heraspec skill add <skill-name> --project-type content-channel\`
3676
+ - Agent reads corresponding skill instructions in \`heraspec/skills/<skill-name>/skill.md\` or \`heraspec/skills/content-channel/<skill-name>/skill.md\`.
3677
+ - Agent MUST adhere to **7 Core Content Production Standards**:
3678
+ 1. **Golden Naming Rule**: ZERO \`[K\xEAnh]\`, \`[Channel]\`, or \`K\xEAnh:\` prefixes in channel/folder names. 100% pure brand names only.
3679
+ 2. **MTxStudio 2-Level Tree Hierarchy**: Every channel must map to standard categories: \`_plan\` (\`type: "docs"\`), \`_posts\` (\`type: "article"\`), \`_prompts\` (\`type: "prompts"\`), \`_music\` (\`type: "music"\`), and optional \`_affiliate\` (\`type: "docs"\`).
3680
+ 3. **Strict TTS Acoustic Rules (Natural Flow)**:
3681
+ - Short sentences: 12 - 20 words max per sentence (never exceed 25 words or 120 chars).
3682
+ - Comma clauses: 8 - 12 words max.
3683
+ - Repetition Bug Prevention: Never place 2 reduplicative words (t\u1EEB l\xE1y) adjacently; always separate with a natural comma \`,\`.
3684
+ - Clean text: Zero artificial bracket tags; rely entirely on natural punctuation (\`.\`, \`,\`, \`...\`, \`!\`) and sentence rhythm for voice pacing.
3685
+ 4. **Strict Poetry & Verse Formatting**: Never use \`join(' ')\` or combine verses into a single line. EVERY verse line MUST preserve its \`\\n\` newline.
3686
+ 5. **Mandatory 3-Position Disclaimer (Decree 15/2020/ND-CP)**: For horror, health, psychological healing, and finance niches, disclaimers are mandatory at: (1) Intro Warning Card 0:00-0:04, (2) Caption Footer / Pinned Comment, (3) Spoken Narration.
3687
+ 6. **Safe Vault Sync (Zero SQLite Tampering)**: NEVER write directly to \`mtxstudio.db\`. All channel exports must go through \`Facebook/export_vault_json.py\` to generate sanitized JSON bundles (\`mtxstudio_vault_import.json\`, \`all_channels_bundle.json\`) with UTF-8 encoding and zero en-dash/em-dash characters.
3688
+ 7. **Channel Voice Adaptation (Transmutation)**: When repurposing raw texts, always use \`content-voice-adapter\` to de-bias off-brand elements and reframe the message through the designated channel's core philosophy and natural voice style.
3579
3689
 
3580
3690
  - Follow tasks.md
3581
3691
  - Mark tasks completed: \`- [x]\`
@@ -3628,6 +3738,7 @@ Tasks grouped by project type and skill:
3628
3738
  > heraspec skill add documents"
3629
3739
  - **DO NOT** create a task plan or attempt manual generation without the skill language.
3630
3740
  3. **Execute After Install**: Only after the skill folder is created (or installed), read the \`skill.md\` and proceed with the task.
3741
+ 4. **Ignore Vietnamese Skill Files**: You MUST only read the English \`skill.md\` file inside the skill folder. Completely ignore all \`*.vi.md\` files (e.g., \`skill.vi.md\`), as they are strictly for reference purposes by human developers.
3631
3742
 
3632
3743
  **Example prompt for Documents skill:**
3633
3744
  If you need to generate multi-format documentation, use this prompt:
@@ -3638,6 +3749,42 @@ If you need to generate multi-format documentation, use this prompt:
3638
3749
  > - Premium Documentation Landing Page (documentations/documentation-landing-page.html)
3639
3750
  > - CRITICAL: Save all files in the /documentations directory (create it if missing)."
3640
3751
 
3752
+ **Example prompts for Content Channel Development (content-channel skills):**
3753
+ - **Channel Strategy (\`content-strategy\`)**:
3754
+ > "S\u1EED d\u1EE5ng skill content-strategy \u0111\u1EC3 l\u1EADp B\u1EA3n K\u1EBF Ho\u1EA1ch 30 Ng\xE0y (plan.md) cho k\xEAnh m\u1EDBi:
3755
+ > - T\xEAn k\xEAnh: [T\xEAn thu\u1EA7n t\xFAy, v\xED d\u1EE5: G\xF3c An Tr\xFA]
3756
+ > - Ng\xE1ch: [V\xED d\u1EE5: Thi\u1EC1n \u0111\u1ECBnh & L\u1ED1i s\u1ED1ng t\u1ED1i gi\u1EA3n]
3757
+ > - Kh\xE1n gi\u1EA3 m\u1EE5c ti\xEAu: [V\xED d\u1EE5: 25 - 40 tu\u1ED5i, nh\xE2n vi\xEAn v\u0103n ph\xF2ng stress]
3758
+ > - Y\xEAu c\u1EA7u: X\xE2y d\u1EF1ng 5 tr\u1EE5 c\u1ED9t n\u1ED9i dung, l\u1ED9 tr\xECnh Cold Start 14 ng\xE0y (70% Reels / 30% In-stream), khung gi\u1EDD v\xE0ng v\xE0 b\u1EA3ng ph\xE2n b\u1ED5 30 b\xE0i vi\u1EBFt chi ti\u1EBFt."
3759
+
3760
+ - **Channel Scaffolding (\`content-scaffolding\`)**:
3761
+ > "S\u1EED d\u1EE5ng skill content-scaffolding \u0111\u1EC3 kh\u1EDFi t\u1EA1o c\u1EA5u tr\xFAc th\u01B0 m\u1EE5c k\xEAnh m\u1EDBi:
3762
+ > - T\xEAn k\xEAnh: [V\xED d\u1EE5: Th\xE2n An T\xE2m L\u1EA1c] | Folder: [Than-An-Tam-Lac]
3763
+ > - Slogan: [V\xED d\u1EE5: Th\xE2n c\xF3 an, t\xE2m m\u1EDBi l\u1EA1c] | Icon Lucide: [Heart] | M\xE0u: [#10b981]
3764
+ > - Y\xEAu c\u1EA7u: Tu\xE2n th\u1EE7 quy t\u1EAFc c\u1EA5m ti\u1EC1n t\u1ED1 [K\xEAnh], t\u1EA1o posts/README.md v\xE0 \u0111\u0103ng k\xFD v\xE0o CHANNELS_CONFIG trong export_vault_json.py."
3765
+
3766
+ - **Raw Text Transmutation (\`content-voice-adapter\`)**:
3767
+ > "S\u1EED d\u1EE5ng skill content-voice-adapter \u0111\u1EC3 chuy\u1EC3n th\u1EC3 \u0111o\u1EA1n v\u0103n b\u1EA3n th\xF4 d\u01B0\u1EDBi \u0111\xE2y th\xE0nh K\u1ECBch b\u1EA3n Video chu\u1EA9n cho k\xEAnh [T\xEAn K\xEAnh] (Th\u1EC3 lo\u1EA1i: [Ch\u1EEFa l\xE0nh / Truy\u1EC7n ma / D\u01B0\u1EE1ng sinh / Chi\xEAm nghi\u1EC7m...]):
3768
+ > [D\xC1N \u0110O\u1EA0N V\u0102N B\u1EA2N TH\xD4 V\xC0O \u0110\xC2Y]
3769
+ > Y\xEAu c\u1EA7u qua 4 b\u01B0\u1EDBc: (1) L\u1ECDc l\u1EC7ch tone theo ma tr\u1EADn th\u1EC3 lo\u1EA1i (ch\u1EEFa l\xE0nh: l\u1ECDc m\xEA t\xEDn/\u0111\u1ED5 l\u1ED7i; truy\u1EC7n ma: l\u1ECDc m\xE1u me/vi ph\u1EA1m N\u0110 15 t\xEAn ng\u01B0\u1EDDi th\u1EADt/c\u1EE3t nh\u1EA3; d\u01B0\u1EE1ng sinh: l\u1ECDc ph\u1EA3n khoa h\u1ECDc/th\u1EA7n th\xE1nh h\xF3a; chi\xEAm nghi\u1EC7m: l\u1ECDc than th\u1EDF n\u1EA1n nh\xE2n), (2) T\xE1i c\u1EA5u tr\xFAc theo DNA tri\u1EBFt l\xFD v\xE0 \u0111\u1EA1i t\u1EEB nh\xE2n x\u01B0ng c\u1EE7a k\xEAnh, (3) T\u1ED1i \u01B0u \xE2m h\u1ECDc TTS 12-20 t\u1EEB/c\xE2u s\u1EA1ch th\u1EBB ngo\u1EB7c vu\xF4ng, (4) \u0110\xF3ng g\xF3i 6 ph\u1EA7n chu\u1EA9n MTxStudio k\xE8m Storyboard prompt, Caption v\xE0 Disclaimer ph\xE1p l\xFD ph\xF9 h\u1EE3p th\u1EC3 lo\u1EA1i."
3770
+
3771
+ - **Scriptwriting from Scratch (\`content-scripting\`)**:
3772
+ > "S\u1EED d\u1EE5ng skill content-scripting \u0111\u1EC3 vi\u1EBFt K\u1ECBch b\u1EA3n T\u1EADp [S\u1ED1 t\u1EADp]: '[Ti\xEAu \u0111\u1EC1]' cho k\xEAnh [T\xEAn K\xEAnh]:
3773
+ > - Tr\u1EE5 c\u1ED9t: [T\xEAn tr\u1EE5 c\u1ED9t n\u1ED9i dung] | \u0110\u1ECBnh d\u1EA1ng: [Video In-stream 16:9 ho\u1EB7c Reels 9:16]
3774
+ > - Y\xEAu c\u1EA7u \xE2m h\u1ECDc TTS: C\xE2u ng\u1EAFn 12-20 t\u1EEB, ng\u1EAFt nh\u1ECBp d\u1EA5u ph\u1EA9y r\xF5 r\xE0ng, kh\xF4ng \u0111i\u1EC7p \xE2m t\u1EEB l\xE1y, TUY\u1EC6T \u0110\u1ED0I KH\xD4NG ch\xE8n th\u1EBB ngo\u1EB7c vu\xF4ng ([l\u1EA5y h\u01A1i], [th\u1EDF d\xE0i]), b\u1EA3o to\xE0n th\u01A1 ca m\u1ED7i c\xE2u 1 d\xF2ng (\\n), xu\u1EA5t \u0111\u1EA7y \u0111\u1EE7 6 ph\u1EA7n k\xE8m Storyboard v\xE0 Caption Facebook."
3775
+
3776
+ - **AI Visual & Suno BGM Prompts (\`content-prompts\`)**:
3777
+ > "S\u1EED d\u1EE5ng skill content-prompts \u0111\u1EC3 t\u1EA1o b\u1ED9 Prompt Visual v\xE0 \xC2m nh\u1EA1c cho k\xEAnh [T\xEAn K\xEAnh]:
3778
+ > - C\u1EA7n t\u1EA1o: Prompt Avatar 1:1, Cover 16:9, B\u1EA3ng 5 Prompts Storyboard b\xE0i vi\u1EBFt '[T\xEAn b\xE0i vi\u1EBFt]', v\xE0 Prompt Suno AI BGM kh\xF4ng l\u1EDDi."
3779
+
3780
+ - **Legal Compliance & Disclaimer (\`content-compliance\`)**:
3781
+ > "S\u1EED d\u1EE5ng skill content-compliance \u0111\u1EC3 ki\u1EC3m duy\u1EC7t k\u1ECBch b\u1EA3n v\xE0 sinh Disclaimer cho video thu\u1ED9c th\u1EC3 lo\u1EA1i [Truy\u1EC7n Ma / D\u01B0\u1EE1ng Sinh / T\xE2m L\xFD / T\xE0i Ch\xEDnh]:
3782
+ > - Cung c\u1EA5p Disclaimer chu\u1EA9n ph\xE1p l\xFD (Ngh\u1ECB \u0111\u1ECBnh 15/2020/N\u0110-CP) \u0111\u1EB7t \u1EDF ch\xE2n Caption.
3783
+ > - Cung c\u1EA5p Prompt m\xE0n h\xECnh c\u1EA3nh b\xE1o Intro Warning Card (0:00 - 0:04, t\u1EF7 l\u1EC7 16:9)."
3784
+
3785
+ - **Vault Synchronization (\`content-vault-sync\`)**:
3786
+ > "S\u1EED d\u1EE5ng skill content-vault-sync \u0111\u1EC3 \u0111\u1ED3ng b\u1ED9 d\u1EEF li\u1EC7u: Ki\u1EC3m tra t\xEDnh to\xE0n v\u1EB9n c\xE1c k\xEAnh trong Facebook/, ch\u1EA1y export_vault_json.py \u0111\u1EC3 t\xE1i xu\u1EA5t mtxstudio_vault_import.json v\xE0 all_channels_bundle.json, b\xE1o c\xE1o s\u1ED1 l\u01B0\u1EE3ng k\xEAnh, danh m\u1EE5c v\xE0 k\u1ECBch b\u1EA3n \u0111\xE3 \u0111\xF3ng g\xF3i th\xE0nh c\xF4ng."
3787
+
3641
3788
  **Dynamic Documentation Generation**:
3642
3789
  When generating documentation, do NOT simply fill a template. The Agent MUST:
3643
3790
  1. **Create** the \`/documentations\` directory if it does not exist.
@@ -3674,12 +3821,12 @@ Example with multiple skills in one change:
3674
3821
 
3675
3822
  ## Proactive Memory-Aware Development
3676
3823
 
3677
- If \\\`heraspec/skills/project-memory/\\\` exists, the agent MUST proactively use memory to maintain project context. DO NOT wait for the user to prompt you to use memory.
3824
+ If \`heraspec/skills/project-memory/\` exists, the agent MUST proactively use memory to maintain project context. DO NOT wait for the user to prompt you to use memory.
3678
3825
 
3679
3826
  ### CRITICAL RULES FOR AUTOMATIC MEMORY USAGE
3680
- 1. **Always Check Context First**: At the beginning of a complex task or when encountering an unfamiliar codebase area, you MUST autonomously run \\\`heraspec memory context\\\` or \\\`heraspec memory search "keywords"\\\` BEFORE writing any code.
3681
- 2. **Auto-Log via Archive**: You DO NOT need to run \\\`heraspec memory log\\\` manually. Every time you successfully implement a feature and run \\\`heraspec archive <change-name>\\\`, the system will automatically read your proposal and log the memory observation under the hood. Just use \\\`heraspec archive\\\` as normal!
3682
- 3. **Session Summary**: (Optional) When wrapping up a large session, you can run \\\`heraspec memory summarize --request "..." --completed "..."\\\` to compress knowledge, though \\\`archive\\\` already auto-logs completed features.
3827
+ 1. **Always Check Context First**: At the beginning of a complex task or when encountering an unfamiliar codebase area, you MUST autonomously run \`heraspec memory context\` or \`heraspec memory search "keywords"\` BEFORE writing any code.
3828
+ 2. **Auto-Log via Archive**: You DO NOT need to run \`heraspec memory log\` manually. Every time you successfully implement a feature and run \`heraspec archive <change-name>\`, the system will automatically read your proposal and log the memory observation under the hood. Just use \`heraspec archive\` as normal!
3829
+ 3. **Session Summary**: (Optional) When wrapping up a large session, you can run \`heraspec memory summarize --request "..." --completed "..."\` to compress knowledge, though \`archive\` already auto-logs completed features.
3683
3830
 
3684
3831
  ### When to SKIP Memory
3685
3832
  - Simple bug fixes, typo corrections, formatting changes
@@ -3687,10 +3834,10 @@ If \\\`heraspec/skills/project-memory/\\\` exists, the agent MUST proactively us
3687
3834
  - When doing what the agent's built-in context already covers
3688
3835
 
3689
3836
  ### Smart Code Exploration
3690
- If \\\`heraspec/skills/smart-explore/\\\` exists, prefer token-efficient exploration:
3691
- - \\\`heraspec explore outline <file>\\\` \u2192 View structure (~1K tokens vs ~12K full file)
3692
- - \\\`heraspec explore search "<query>" <path>\\\` \u2192 Find symbols across codebase
3693
- - \\\`heraspec explore unfold <file> <symbol>\\\` \u2192 Read just one function
3837
+ If \`heraspec/skills/smart-explore/\` exists, prefer token-efficient exploration:
3838
+ - \`heraspec explore outline <file>\` \u2192 View structure (~1K tokens vs ~12K full file)
3839
+ - \`heraspec explore search "<query>" <path>\` \u2192 Find symbols across codebase
3840
+ - \`heraspec explore unfold <file> <symbol>\` \u2192 Read just one function
3694
3841
  `;
3695
3842
  }
3696
3843
  static getSkillsSection() {
@@ -3811,6 +3958,7 @@ var InitCommand = class {
3811
3958
  await this.updateInstalledSkills(heraspecPath);
3812
3959
  }
3813
3960
  await this.checkAndBootstrapMemory(heraspecPath, resolvedPath, spinner);
3961
+ await this.checkAndBootstrapContentChannel(heraspecPath, resolvedPath, spinner);
3814
3962
  await this.updateRelatedMarkdownFiles(resolvedPath);
3815
3963
  spinner.stop();
3816
3964
  try {
@@ -4351,7 +4499,8 @@ ${section.content.trimEnd()}`);
4351
4499
  "generic-webapp",
4352
4500
  "backend-api",
4353
4501
  "frontend-app",
4354
- "multi-stack"
4502
+ "multi-stack",
4503
+ "content-channel"
4355
4504
  ];
4356
4505
  for (const entry of entries) {
4357
4506
  if (entry === "README.md" || entry === "UI_UX_SKILL_QUICK_REFERENCE.md") continue;
@@ -4445,6 +4594,70 @@ ${section.content.trimEnd()}`);
4445
4594
  }
4446
4595
  spinner.start();
4447
4596
  }
4597
+ /**
4598
+ * Automatically install content-channel skills if project type is content-channel
4599
+ */
4600
+ async checkAndBootstrapContentChannel(heraspecPath, projectPath, spinner) {
4601
+ const configPath = path8.join(heraspecPath, HERASPEC_MARKERS.CONFIG_YAML);
4602
+ const projectMdPath = path8.join(heraspecPath, HERASPEC_MARKERS.PROJECT_MD);
4603
+ let isContentChannel = false;
4604
+ if (await FileSystemUtils.fileExists(configPath)) {
4605
+ const configContent = await FileSystemUtils.readFile(configPath);
4606
+ if (/\bprojectType:\s*["']?content-channel["']?/i.test(configContent)) {
4607
+ isContentChannel = true;
4608
+ }
4609
+ }
4610
+ if (!isContentChannel && await FileSystemUtils.fileExists(projectMdPath)) {
4611
+ const projectContent = await FileSystemUtils.readFile(projectMdPath);
4612
+ if (/##\s*Project Types\s*\n\s*-\s*content-channel\b/i.test(projectContent)) {
4613
+ isContentChannel = true;
4614
+ }
4615
+ }
4616
+ if (!isContentChannel) {
4617
+ const hasFacebook = await FileSystemUtils.fileExists(path8.join(projectPath, "Facebook"));
4618
+ const hasPosts = await FileSystemUtils.fileExists(path8.join(projectPath, "posts"));
4619
+ const hasPrompts = await FileSystemUtils.fileExists(path8.join(projectPath, "prompts"));
4620
+ if (hasFacebook || hasPosts && hasPrompts) {
4621
+ isContentChannel = true;
4622
+ }
4623
+ }
4624
+ if (isContentChannel) {
4625
+ const channelSkills = [
4626
+ "content-strategy",
4627
+ "content-scaffolding",
4628
+ "content-scripting",
4629
+ "content-voice-adapter",
4630
+ "content-prompts",
4631
+ "content-compliance",
4632
+ "content-vault-sync"
4633
+ ];
4634
+ const skillsDir = path8.join(heraspecPath, SKILLS_DIR_NAME);
4635
+ const missingSkills = [];
4636
+ for (const skillName of channelSkills) {
4637
+ const flatPath = path8.join(skillsDir, skillName);
4638
+ const scopedPath = path8.join(skillsDir, "content-channel", skillName);
4639
+ if (!await FileSystemUtils.fileExists(flatPath) && !await FileSystemUtils.fileExists(scopedPath)) {
4640
+ missingSkills.push(skillName);
4641
+ }
4642
+ }
4643
+ if (missingSkills.length > 0) {
4644
+ spinner.stop();
4645
+ console.log(chalk2.cyan(`
4646
+ \u{1F3AC} Detected content-channel project. Installing ${missingSkills.length} channel skill(s)...`));
4647
+ try {
4648
+ const { SkillCommand: SkillCommand2 } = await Promise.resolve().then(() => (init_skill(), skill_exports));
4649
+ const skillCommand = new SkillCommand2();
4650
+ for (const skillName of missingSkills) {
4651
+ await skillCommand.add(skillName, void 0, projectPath);
4652
+ }
4653
+ console.log(chalk2.green(`\u2713 Channel skills suite ready for production.
4654
+ `));
4655
+ } catch (err) {
4656
+ }
4657
+ spinner.start();
4658
+ }
4659
+ }
4660
+ }
4448
4661
  /**
4449
4662
  * Get the knowledge source directory from CLI package
4450
4663
  */
@@ -4897,7 +5110,7 @@ After copying UI/UX skill to your project, see:
4897
5110
  return `<!-- HeraSpec Section -->
4898
5111
  ## HeraSpec Development
4899
5112
 
4900
- This project uses [HeraSpec](https://github.com/your-org/heraspec) for spec-driven development.
5113
+ This project uses [HeraSpec](https://github.com/PolyXGO/HeraSpec) for spec-driven development.
4901
5114
 
4902
5115
  ### Quick Start
4903
5116
 
@@ -4946,7 +5159,7 @@ heraspec skill add unit-test
4946
5159
  heraspec skill show ui-ux
4947
5160
  \`\`\`
4948
5161
 
4949
- For more information, see the [HeraSpec documentation](https://github.com/your-org/heraspec/docs).
5162
+ For more information, see the [HeraSpec documentation](https://github.com/PolyXGO/HeraSpec#readme).
4950
5163
 
4951
5164
  ---
4952
5165