@tidyfactor/marketing 1.3.0 → 1.6.0

package/.tidyfactor

@@ -1,52 +1,53 @@
-{
-  "ecosystem": "tidyfactor",
-  "track": "marketing",
-  "name": "tidyfactor-marketing",
-  "version": "1.3.0",
-  "npmPackage": "@alwkala/tidyfactor-marketing",
-  "github": "https://github.com/TidyFactor/Marketing",
-  "skillFile": "../tidyfactor-marketing-v1.1.1.skill",
-  "category": "marketing-engine",
-  "type": "direct-response-growth",
-  "outputs": [
-    "campaigns/",
-    "content/",
-    "ads/",
-    "funnels/",
-    "lifecycle/"
-  ],
-  "pillars": [
-    "strategy",
-    "content",
-    "social",
-    "email",
-    "advertising",
-    "promotions",
-    "growth"
-  ],
-  "commands": [
-    "brief",
-    "strategy",
-    "content",
-    "social",
-    "email",
-    "advertising",
-    "promotions",
-    "growth"
-  ],
-  "visionRef": "../TidyFactor-VISION.md",
-  "sibling": [
-    "tidyfactor-design",
-    "tidyfactor-cinematic",
-    "tidyfactor-html",
-    "tidyfactor-php",
-    "tidyfactor-js",
-    "tidyfactor-htmx",
-    "tidyfactor-nextjs-saas",
-    "tidyfactor-styler"
-  ],
-  "commercialPartner": "alwkala",
-  "website": "https://tidyfactor.com",
-  "docs": "https://tidyfactor.com/documentation",
-  "license": "Apache-2.0"
-}
+{
+  "ecosystem": "tidyfactor",
+  "track": "marketing",
+  "name": "tidyfactor-marketing",
+  "version": "1.6.0",
+  "npmPackage": "@alwkala/tidyfactor-marketing",
+  "github": "https://github.com/TidyFactor/Marketing",
+  "skillFile": "../tidyfactor-marketing-v1.6.0.skill",
+  "category": "marketing-engine",
+  "type": "direct-response-growth",
+  "outputs": [
+    "campaigns/",
+    "content/",
+    "ads/",
+    "funnels/",
+    "lifecycle/"
+  ],
+  "pillars": [
+    "strategy",
+    "content",
+    "social",
+    "email",
+    "advertising",
+    "promotions",
+    "growth"
+  ],
+  "commands": [
+    "brief",
+    "strategy",
+    "content",
+    "social",
+    "email",
+    "advertising",
+    "promotions",
+    "growth",
+    "audit"
+  ],
+  "visionRef": "../TidyFactor-VISION.md",
+  "sibling": [
+    "tidyfactor-design",
+    "tidyfactor-cinematic",
+    "tidyfactor-html",
+    "tidyfactor-php",
+    "tidyfactor-js",
+    "tidyfactor-htmx",
+    "tidyfactor-nextjs-saas",
+    "tidyfactor-styler"
+  ],
+  "commercialPartner": "alwkala",
+  "website": "https://tidyfactor.com",
+  "docs": "https://tidyfactor.com/documentation",
+  "license": "Apache-2.0"
+}

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 All notable changes to the **[@tidyfactor/marketing](https://www.npmjs.com/package/@tidyfactor/marketing)** package will be documented in this file.
 
+## [1.6.0] - 2026-09-09
+
+### 🏛️ Added — 6-Axis Periodic Review Protocol, YAML Primacy & Asset Hygiene
+- **Command & CDL v2.0 Upgrades (`Axis 1`)**:
+  - Registered `references/commands/audit.md` for direct-response copy auditing and AI cliché detection.
+  - Enhanced `references/commands/brief.md` and `references/workflows/brief.md` with CDL v2.0 Native Modal Wizard (`ask_question`) and `/debate` trigger for relentless marketing stress-testing.
+- **Single Outcome & Workflow Checklists (`Axis 2`)**:
+  - Enforced mandatory `## Validation checklist` across all 8 workflow files with binary pass/fail criteria.
+- **Rule 15 YAML Primacy & Operational Memory (`Axis 3`)**:
+  - Introduced `brand.yaml` for ~40% token efficiency over JSON; updated manifest discovery to prioritize YAML.
+  - Added `references/memory/naming-conventions.md` establishing universal 5-token campaign taxonomy and lowercase UTM rules.
+  - Added `references/memory/campaign-mindmap.md` containing Mermaid architectures for the 7 marketing pillars and lead flow.
+  - Refreshed freshness stamp on `references/memory/philosophy.md`.
+- **Deterministic Tooling & Asset Hygiene Engine (`Axis 4`)**:
+  - Added `scripts/clean_orphaned_assets.py` detecting SHA-256 binary duplicate assets and unreferenced orphan files.
+  - Upgraded `tools/validate_skill.py` to 13-point comprehensive release validator.
+- **Governance & Evaluation Scenarios (`Axis 5`)**:
+  - Added `tests/scenarios.md` with 4 production evaluation scenarios (GCC flash sale, B2B SaaS launch, Egypt abandoned cart, copy linter).
+  - Synchronized SemVer `1.6.0` atomically across all metadata.
+- **Asset Bloat Elimination (`Axis 6`)**:
+  - Deleted duplicate `assets/og-default.png` (245.5 KB) and root orphan `image.jpg` (64.9 KB), reclaiming ~310 KB in package archive.
+
+---
+
+## [1.5.0] - 2026-09-02
+
+### 🧠 Added — Contextual Decision Layer (CDL v1.1.0) & Declarative Decision Gates
+- **Declarative Decision Gates (`manifest.json`)**: Added formal `decision_gates[]` declaration for the `brief` command conforming to manifest schema v1.1.0, defining `target_market`, `brand_voice`, `funnel_stage`, and `core_offer` with `track_staleness: true`.
+- **Context Delta Resolution Engine (`references/workflows/brief.md`)**: Upgraded brief workflow to evaluate the mechanical Delta formula:
+  $$\text{Unknowns} = \text{Required Decisions} - (\text{Discovered Facts} \cup \text{Brain KIs})$$
+- **Interactive Disclosure & User Agency First**: Surfacing all genuine Unknowns interactively with structured A/B/C/D choices and recommended defaults, prioritizing rich user engagement.
+- **Anti-Dual-Write Architecture**: Enforcing local `.tidyfactor/marketing-brief.md` as sole SSOT, with one-way outbound cloud sync via `--sync-brain`.
+
+---
+
+## [1.4.0] - 2026-09-02
+
+### 🧠 Added — Sovereign Brain MCP Integration, Copy Auditor & Fail-Open Protocol
+- **Brain Integration Contract (`references/memory/20-brain-baas-integration.md`)**: Operational specification defining sovereign self-hosted architecture, isolated client SQLite database scoping, and Marketing Strategy Knowledge Item (KI) payload schemas.
+- **Fail-Open Resolution Protocol (`references/workflows/brief.md`)**: Embedded deterministic context discovery: (1) Local workspace auto-sensing first, (2) Optional Brain MCP context acceleration (`search_knowledge_base`) when active, (3) Instant 0ms silent fallback to 3-question structured interview with zero robotic preamble.
+- **Runtime Tooling Manifest & Quality Engine (`manifest.json`)**: Declared portable `audit_copy` and `calc_promo_math` tools with schema validation for direct CLI and MCP `run_skill_tool` execution.
+- **Automated Copy Quality Auditor (`scripts/audit_copy.py`)**: Standalone and MCP-compatible CLI engine scanning copy for AI cliches, banned fluff, and 7-axis pre-emit critique stamps.
+- **Unit Economics & Margin Calculator (`scripts/calc_promo_math.py`)**: Deterministic calculations for gross margin safety, break-even ROAS targets, and discount compression.
+- **Anti-Triggers & Tooling Scope**: Enriched `SKILL.md` with explicit Rule 10 Tooling Scope and anti-triggers.
+
+---
+
 ## [1.3.0] - 2026-08-29
 
 ### Added - Arabic Direct-Response & MENA Intelligence Engine

package/README.ar.md

@@ -1,6 +1,6 @@
 <div align="center" dir="rtl">
 
-# 🚀 محرك تايدي فاكتور للتسويق المباشر والنمو `TidyFactor Marketing v1.3.0`
+# 🚀 محرك تايدي فاكتور للتسويق المباشر والنمو `TidyFactor Marketing v1.6.0`
 ### هندسة التسويق المباشر، طبقة القرارات السياقية (CDL)، ونظام كتابة المحتوى عالي التحويل
 
 **الأساس التسويقي الرسمي لمنظومة تايدي فاكتور (TidyFactor Ecosystem) والشريك الاستراتيجي وكالة الوكالة (Alwkala).**
@@ -190,19 +190,30 @@ tidyfactor-marketing/
 
 ---
 
-## 🚀 البدء السريع ومعالج سطر الأوامر
+## 🚀 التثبيت والبدء السريع
 
-### الخيار 1: المعالج التفاعلي عبر سطر الأوامر
-شغّل المعالج التفاعلي خطوة بخطوة في الطرفية (Terminal):
+اختر طريقة التثبيت المناسبة لمشروعك:
+
+### الخيار (أ): عبر TidyFactor CLI الرسمي (الموصى به)
+التثبيت الفوري دون الحاجة لتثبيت الأداة عالمياً في بيئة عملك النشطة:
+```bash
+npx @tidyfactor/cli add marketing
+```
+*أو في حال كانت الأداة مثبتة لديك عالمياً (`npm i -g @tidyfactor/cli`):*
+```bash
+tidyfactor add marketing
+```
+
+### الخيار (ب): عبر معيار مهارات الوكلاء المفتوح (skills.sh)
+التثبيت العالمي المتوافق مع كافة بيئات الوكلاء ومحررات الذكاء الاصطناعي (Antigravity, Cursor, Claude Code, Windsurf, Codex):
 ```bash
-npx @tidyfactor/cli-marketing
+npx skills add tidyfactor/marketing
 ```
-*يطلب منك تحديد مجال المشروع، والسوق المستهدف (عالمي أو عربي)، والتركيز الأساسي (B2B أو متاجر إلكترونية أو المنظومة الشاملة).*
 
-### الخيار 2: الحقن المباشر في أي مشروع
-احقن كامل ملفات المهارة في مسار `.agents/skills/tidyfactor-marketing/` بنقرة واحدة:
+### الخيار (ج): التثبيت المباشر الفردي عبر NPM
+تشغيل مثبت المهارة المستقل مباشرة مع تجاوز الذاكرة المخبأة وضمان أحدث إصدار:
 ```bash
-npx @tidyfactor/cli-marketing add-skill
+npx @tidyfactor/marketing@latest
 ```
 
 ### الخيار 3: أوامر Slash للوكلاء الأذكياء (Claude, Antigravity, Cursor)

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# 🚀 TidyFactor Marketing `v1.3.0`
+# 🚀 TidyFactor Marketing `v1.6.0`
 ### AI Direct-Response Marketing, Contextual Decision Layer & Anti-Slop Content Suite
 
 **The official marketing & customer acquisition foundation for the TidyFactor Ecosystem.**
@@ -198,19 +198,30 @@ Every sentence generated by **TidyFactor Marketing** must pass the **Mechanism R
 
 ---
 
-## 🚀 Quick Start & CLI Wizard
+## 🚀 Installation & Quick Start
 
-### Option 1: Interactive Terminal Setup Wizard
-Launch the step-by-step interactive CLI in your terminal:
+Choose your preferred installation method:
+
+### Option A: Via TidyFactor CLI (Recommended)
+Install directly using the official ecosystem package runner into your active workspace:
+```bash
+npx @tidyfactor/cli add marketing
+```
+*Or if you have the CLI installed globally (`npm i -g @tidyfactor/cli`):*
+```bash
+tidyfactor add marketing
+```
+
+### Option B: Via Open Agent Skills Ecosystem (skills.sh / Vercel Labs)
+Install using the universal multi-agent standard across all supported IDEs (Cursor, Antigravity, Claude Code, Windsurf, Trae, Codex):
 ```bash
-npx @tidyfactor/cli-marketing
+npx skills add tidyfactor/marketing
 ```
-*Prompts you for project niche, primary target market (Global vs MENA), and growth focus (B2B, E-Commerce, or 360° Suite).*
 
-### Option 2: Skill Injection into Any Project
-Instantly inject the full `.agents/skills/tidyfactor-marketing/` tree into your current workspace:
+### Option C: Standalone Zero-Dependency Runner (NPM Direct)
+Run the dedicated skill installer directly with automatic cache invalidation:
 ```bash
-npx @tidyfactor/cli-marketing add-skill
+npx @tidyfactor/marketing@latest
 ```
 
 ### Option 3: AI Agent Slash Commands (Claude, Antigravity, Cursor)

package/SKILL.md

@@ -1,30 +1,46 @@
----
-name: tidyfactor-marketing
-description: "Production-grade AI marketing and growth engine with Contextual Decision Layer (CDL) & MENA Intelligence. Handles 7 pillars and 28 capabilities: brand voice, campaign strategy, product launches, SEO pillar-clusters, social media, email lifecycles, and paid ads. Trigger on commands 'brief', 'strategy', 'content', 'social', 'email', 'advertising', 'promotions', 'growth', or requests for marketing plans, ad copy, and launch campaigns."
----
-# TidyFactor Marketing Engine
-
-A command dispatcher. This file routes marketing and growth intents to the corresponding command, workflow, and memory modules. It holds zero procedural copy or execution logic.
-
-## Commands
-
-| User Intent / Capability | Command | What It Loads |
-|---|---|---|
-| **Discovery**: Pre-flight marketing brief, strategic alignment, market baseline caching | `references/commands/brief.md` | `references/workflows/brief.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` |
-| **Strategy**: Brand voice & positioning statement, Competitive differentiation, Campaign strategy, Product launch plan | `references/commands/strategy.md` | `references/workflows/campaign-launch.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/frameworks.md` + `references/memory/arabic-writing.md` |
-| **Content**: Social media posts, SEO strategy (Pillar + Cluster), Content calendar, Newsletter strategy | `references/commands/content.md` | `references/workflows/content-engine.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/frameworks.md` + `references/memory/arabic-writing.md` |
-| **Social Media**: LinkedIn B2B & Founder personal branding, Instagram strategy, TikTok strategy, Social media audit | `references/commands/social.md` | `references/workflows/social-growth.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/platform-specs.md` |
-| **Email**: Grow email list, Welcome email sequence, Abandoned cart emails, Win-back flows | `references/commands/email.md` | `references/workflows/email-lifecycle.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/lifecycle-flows.md` + `references/memory/arabic-writing.md` |
-| **Advertising**: Write ad copy, Landing page strategy, Facebook/Meta ads plan, Google Ads plan, First ad campaign | `references/commands/advertising.md` | `references/workflows/paid-acquisition.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/ad-copy-templates.md` + `references/memory/arabic-writing.md` |
-| **Promotions**: Plan a sale / Flash sales, Giveaway or contest, Margin-safe coupon strategy, Decoy pricing | `references/commands/promotions.md` | `references/workflows/promo-conversion.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/promotions-math.md` |
-| **Growth**: Customer retention & churn reduction, Loyalty program design, Referral program, Influencer outreach | `references/commands/growth.md` | `references/workflows/viral-retention.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` + `references/memory/frameworks.md` |
-
-## Non-Negotiable Quality Constraints
-
-1. **Contextual Decision Layer (CDL)**: Resolve regional, voice, and offer baseline via `.tidyfactor/marketing-brief.md` or thin protocol in `references/memory/decision-points.md` before generating campaigns.
-2. **7-Axis Pre-Emit Self-Critique (`P/H/E/S/R/V/D`)**: All output must self-audit against Pain Specificity, Hook Power, Execution, Stage Fit, Restraint, Voice, and Decision Alignment (`quality-bar.md`).
-3. **Multi-Angle Requirement**: All ad copy generation must produce at least 3 distinct psychological angles (Pain/Loss Aversion, Logic/ROI/Efficiency, and Aspiration/Social Proof).
-4. **Margin Protection Rule**: Any discounting or promotional strategy must verify unit gross margins and prioritize threshold-based AOV expansion over arbitrary price slashing.
-5. **Bilingual Direct Response & Native Arabic**: Compose Arabic copy natively per `arabic-writing.md` using Modern Standard Arabic (فصحى معاصرة رنانة) or calibrated regional dialects without mechanical translation artifacts.
-6. **MENA Platform & Trust Calibration**: Adhere to country-specific platform rankings, trust signals, and payment methods (`platform-specs.md`).
-
+---
+name: tidyfactor-marketing
+description: "Production-grade AI marketing and growth engine with Contextual Decision Layer (CDL) & MENA Intelligence. Handles 7 pillars and 28 capabilities: brand voice, campaign strategy, product launches, SEO pillar-clusters, social media, email lifecycles, paid ads, and copy auditing. Trigger on commands 'brief', 'strategy', 'content', 'social', 'email', 'advertising', 'promotions', 'growth', 'audit', or requests for marketing plans, ad copy, and launch campaigns."
+---
+# TidyFactor Marketing Engine
+
+A command dispatcher. This file routes marketing and growth intents to corresponding command, workflow, and memory modules with zero procedural execution logic.
+
+## Commands
+
+| User Intent | Command | What It Loads |
+|---|---|---|
+| **Discovery**: Strategic brief & baseline caching | `references/commands/brief.md` | `references/workflows/brief.md` + `references/memory/decision-points.md` |
+| **Strategy**: Brand voice, positioning & launch | `references/commands/strategy.md` | `references/workflows/campaign-launch.md` + `references/memory/frameworks.md` |
+| **Content**: SEO pillar-clusters & publishing | `references/commands/content.md` | `references/workflows/content-engine.md` + `references/memory/arabic-writing.md` |
+| **Social**: Founder branding & platform playbooks | `references/commands/social.md` | `references/workflows/social-growth.md` + `references/memory/platform-specs.md` |
+| **Email**: Welcome, cart recovery & win-back | `references/commands/email.md` | `references/workflows/email-lifecycle.md` + `references/memory/lifecycle-flows.md` |
+| **Advertising**: 3-angle copy & CRO wireframes | `references/commands/advertising.md` | `references/workflows/paid-acquisition.md` + `references/memory/ad-copy-templates.md` |
+| **Promotions**: Flash sales, decoy pricing & math | `references/commands/promotions.md` | `references/workflows/promo-conversion.md` + `references/memory/promotions-math.md` |
+| **Growth**: Referral loops, viral growth & retention | `references/commands/growth.md` | `references/workflows/viral-retention.md` + `references/memory/20-brain-baas-integration.md` |
+| **Audit**: Copy quality audit & cliché detection | `references/commands/audit.md` | `scripts/audit_copy.py` + `references/memory/quality-bar.md` |
+
+## Non-Negotiable Quality Constraints
+
+1. **CDL v2.0 & Debate Mode**: Auto-sense parameters before prompting; present genuine Unknowns via `ask_question`.
+2. **Zero Robotic Preamble**: Never output conversational monologue dumps, textbook essays, or greetings.
+3. **7-Axis Pre-Emit Critique**: All copy must self-audit against P5 H5 E5 S5 R5 V5 D5 (`references/memory/quality-bar.md`).
+4. **Multi-Angle Requirement**: Ad generation must produce 3 psychological angles (Pain, ROI, Proof).
+5. **Margin Protection Rule**: Promos must verify gross margins with `calc_promo_math.py`.
+6. **Bilingual MENA Direct Response**: Compose Arabic copy natively per `references/memory/arabic-writing.md`.
+
+## Anti-Triggers
+
+- Do NOT use for generic text formatting or non-commercial writing.
+- Do NOT use for backend database operations or platform infrastructure.
+
+## Tooling Scope (Rule 10)
+
+- `audit_copy` (`scripts/audit_copy.py`): Sub-second AST & cliché linter.
+- `calc_promo_math` (`scripts/calc_promo_math.py`): Break-even ROAS & margin math.
+- `clean_orphaned_assets` (`scripts/clean_orphaned_assets.py`): SHA-256 duplicate & orphan cleaner.
+
+## Skill vs MCP Boundary (Rule 12)
+
+- **Inside Skill**: Static marketing frameworks, copy matrices, Arabic tone rubrics, and local auditing tools.
+- **MCP Layer**: Sovereign Brain persistence (`search_knowledge_base`, `extract_knowledge_item`) operating under Fail-Open protocol.

package/bin/add-skill.js

@@ -1,50 +1,65 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-
-/* Lightweight Zero-Dependency ANSI formatting */
-const chalk = {
-  cyan: (str) => `\x1b[36m${str}\x1b[0m`,
-  green: (str) => `\x1b[32m${str}\x1b[0m`,
-  yellow: (str) => `\x1b[33m${str}\x1b[0m`,
-  red: (str) => `\x1b[31m${str}\x1b[0m`,
-  bold: (str) => `\x1b[1m${str}\x1b[0m`,
-  dim: (str) => `\x1b[2m${str}\x1b[0m`,
-};
-
-const PACKAGE_ROOT = path.resolve(__dirname, '..');
-const targetDir = process.cwd();
-const skillDestDir = path.join(targetDir, '.agents', 'skills', 'tidyfactor-marketing');
-
-console.log(chalk.cyan(`\nInjecting TidyFactor Marketing Skill into: ${targetDir}...`));
-
-fs.mkdirSync(skillDestDir, { recursive: true });
-
-const copyDir = (src, dest) => {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const item of fs.readdirSync(src)) {
-    const srcItem = path.join(src, item);
-    const destItem = path.join(dest, item);
-    if (fs.statSync(srcItem).isDirectory()) {
-      copyDir(srcItem, destItem);
-    } else {
-      fs.copyFileSync(srcItem, destItem);
-    }
-  }
-};
-
-// Copy references and root files
-const filesToCopy = ['SKILL.md', 'package.json', 'README.md', 'README.ar.md', 'LICENSE', 'brand.json', '.tidyfactor'];
-for (const f of filesToCopy) {
-  const srcFile = path.join(PACKAGE_ROOT, f);
-  if (fs.existsSync(srcFile)) {
-    fs.copyFileSync(srcFile, path.join(skillDestDir, f));
-  }
-}
-
-if (fs.existsSync(path.join(PACKAGE_ROOT, 'references'))) {
-  copyDir(path.join(PACKAGE_ROOT, 'references'), path.join(skillDestDir, 'references'));
-}
-
-console.log(chalk.bold(chalk.green(`✅ TidyFactor Marketing Skill injected successfully into .agents/skills/tidyfactor-marketing!\n`)));
+#!/usr/bin/env node
+/**
+ * bin/add-skill.js — Multi-Agent Skill Installer Wrapper for tidyfactor-marketing
+ * Supports Trae, Cursor, Windsurf, Antigravity, GitHub Copilot, RooCode, OpenCode, KiloCode, Warp, and Universal.
+ *
+ * @license Apache-2.0
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const targetDir = process.cwd();
+const skillSource = path.resolve(__dirname, '..');
+const skillName = 'tidyfactor-marketing';
+
+const AGENT_MAP = [
+  { name: 'Trae AI IDE',               dir: path.join(targetDir, '.trae', 'skills', skillName),        test: path.join(targetDir, '.trae') },
+  { name: 'Cursor IDE',                dir: path.join(targetDir, '.cursor', 'skills', skillName),      test: path.join(targetDir, '.cursor') },
+  { name: 'Windsurf Cascade',          dir: path.join(targetDir, '.windsurf', 'skills', skillName),    test: path.join(targetDir, '.windsurf') },
+  { name: 'GitHub Copilot',            dir: path.join(targetDir, '.github', 'prompts', skillName),     test: path.join(targetDir, '.github') },
+  { name: 'RooCode',                   dir: path.join(targetDir, '.roo', 'skills', skillName),         test: path.join(targetDir, '.roo') },
+  { name: 'OpenCode / Zen',            dir: path.join(targetDir, '.opencode', 'skills', skillName),    test: path.join(targetDir, '.opencode') },
+  { name: 'KiloCode',                  dir: path.join(targetDir, '.kilocode', 'skills', skillName),    test: path.join(targetDir, '.kilocode') },
+  { name: 'Warp Terminal',             dir: path.join(targetDir, '.warp', 'skills', skillName),        test: path.join(targetDir, '.warp') },
+  { name: 'Kiro Spec IDE',             dir: path.join(targetDir, '.kiro', 'skills', skillName),        test: path.join(targetDir, '.kiro') },
+  { name: 'Claude Code',               dir: path.join(targetDir, '.claude', 'skills', skillName),      test: path.join(targetDir, '.claude') },
+  { name: 'Zed AI Agent',              dir: path.join(targetDir, '.zed', 'skills', skillName),         test: path.join(targetDir, '.zed') },
+  { name: 'Google Antigravity/Gemini', dir: path.join(targetDir, '.agents', 'skills', skillName),      test: path.join(targetDir, '.agents') },
+];
+
+function copyRecursive(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (['.git', 'node_modules', 'dist'].includes(entry.name)) continue;
+    if (entry.isDirectory()) {
+      copyRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// Determine installation targets
+let mountedTargets = [];
+
+for (const agent of AGENT_MAP) {
+  if (fs.existsSync(agent.test)) {
+    copyRecursive(skillSource, agent.dir);
+    mountedTargets.push(agent.name + ' (' + path.relative(targetDir, agent.dir) + ')');
+  }
+}
+
+// Always ensure universal fallback in .agents/skills/
+const defaultDir = path.join(targetDir, '.agents', 'skills', skillName);
+copyRecursive(skillSource, defaultDir);
+if (!mountedTargets.some(t => t.includes('.agents'))) {
+  mountedTargets.push('Universal Default (.agents/skills/' + skillName + ')');
+}
+
+console.log('✨ Successfully injected ' + skillName + ' into:');
+mountedTargets.forEach(t => console.log('  • ' + t));

package/brand.json

@@ -1,67 +1,67 @@
-{
-  "name": "TidyFactor Marketing",
-  "version": "1.3.0",
-  "schemaVersion": "brand-core-v2",
-  "meta": {
-    "product": "TidyFactor Marketing Engine",
-    "tagline": "AI Direct Response & 360° Growth Marketing Engine",
-    "description": "A production-grade, AI-native marketing and growth engine following TidyFactor Skill architecture. Handles 7 pillars and 28 capabilities with zero fluff, data-backed metrics, quantitative benchmarks, and platform-native direct-response conversion frameworks.",
-    "version": "1.1.1",
-    "lastUpdated": "2026-08-25"
-  },
-  "identity": {
-    "logo": {
-      "full": "assets/logo.svg",
-      "fullDark": "assets/logo-dark.svg",
-      "mark": "assets/logo-mark.svg",
-      "favicon": "assets/favicon.svg",
-      "minClearSpace": "1x logo-mark height on all sides",
-      "minSizePx": 24
-    },
-    "socialPreview": {
-      "ogImage": "assets/og-default.png",
-      "ogDimensions": "1200x630"
-    }
-  },
-  "voice": {
-    "tone": "direct, evidence-first, quantitative, authentic, teacher-practitioner",
-    "vocabulary": {
-      "preferred": [
-        "direct response",
-        "conversion rate",
-        "margin protection",
-        "CAC payback",
-        "LTV:CAC",
-        "ROAS",
-        "anti-cliché",
-        "pillar-cluster",
-        "search intent",
-        "retention loop"
-      ],
-      "banned": [
-        "cutting-edge",
-        "seamless experience",
-        "innovative solutions",
-        "take your business to the next level",
-        "one-stop shop",
-        "نسعى دائماً لتقديم الأفضل",
-        "فريق من الخبراء",
-        "حلول متكاملة ومبتكرة"
-      ]
-    },
-    "principles": [
-      "Every sentence must carry a mechanism, a concrete number, or a verifiable proof point.",
-      "Never price cut without calculating unit gross margin impact.",
-      "Respect audience attention with high-signal, zero-throat-clearing direct copy."
-    ]
-  },
-  "pillars": {
-    "1_strategy": "Brand Voice, Positioning Statement, Competitive Differentiation, Phased Launch (T-30 to T+14)",
-    "2_content": "Pillar + Cluster SEO, Multi-Platform Posts, Publishing Grids, Newsletters",
-    "3_social": "LinkedIn B2B & Founder Personal Branding, Instagram/TikTok 0-3s Hooks, 0-1k Roadmap",
-    "4_email": "Lead Magnet Mechanics, 5-Email Welcome Flow, 3-Stage Cart Recovery, Win-Back Sequences",
-    "5_advertising": "3-Angle Ad Copy Matrices, 7-Dimension CRO Landing Page Wireframes, Meta & Google Ads",
-    "6_promotions": "72-Hour Flash Sales, Decoy Pricing Architecture, Viral Contests, Margin-Safe Coupons",
-    "7_growth": "2-Sided Viral Referral Loops, Influencer Vetting & Cold Outreach, Retention & Churn Diagnosis"
-  }
-}
+{
+  "name": "TidyFactor Marketing",
+  "version": "1.6.0",
+  "schemaVersion": "brand-core-v2",
+  "meta": {
+    "product": "TidyFactor Marketing Engine",
+    "tagline": "AI Direct Response & 360° Growth Marketing Engine",
+    "description": "A production-grade, AI-native marketing and growth engine following TidyFactor Skill architecture. Handles 7 pillars and 28 capabilities with zero fluff, data-backed metrics, quantitative benchmarks, and platform-native direct-response conversion frameworks.",
+    "version": "1.6.0",
+    "lastUpdated": "2026-09-09"
+  },
+  "identity": {
+    "logo": {
+      "full": "assets/logo.svg",
+      "fullDark": "assets/logo-dark.svg",
+      "mark": "assets/logo-mark.svg",
+      "favicon": "assets/favicon.svg",
+      "minClearSpace": "1x logo-mark height on all sides",
+      "minSizePx": 24
+    },
+    "socialPreview": {
+      "ogImage": "assets/hero-banner.png",
+      "ogDimensions": "1200x630"
+    }
+  },
+  "voice": {
+    "tone": "direct, evidence-first, quantitative, authentic, teacher-practitioner",
+    "vocabulary": {
+      "preferred": [
+        "direct response",
+        "conversion rate",
+        "margin protection",
+        "CAC payback",
+        "LTV:CAC",
+        "ROAS",
+        "anti-cliché",
+        "pillar-cluster",
+        "search intent",
+        "retention loop"
+      ],
+      "banned": [
+        "cutting-edge",
+        "seamless experience",
+        "innovative solutions",
+        "take your business to the next level",
+        "one-stop shop",
+        "نسعى دائماً لتقديم الأفضل",
+        "فريق من الخبراء",
+        "حلول متكاملة ومبتكرة"
+      ]
+    },
+    "principles": [
+      "Every sentence must carry a mechanism, a concrete number, or a verifiable proof point.",
+      "Never price cut without calculating unit gross margin impact.",
+      "Respect audience attention with high-signal, zero-throat-clearing direct copy."
+    ]
+  },
+  "pillars": {
+    "1_strategy": "Brand Voice, Positioning Statement, Competitive Differentiation, Phased Launch (T-30 to T+14)",
+    "2_content": "Pillar + Cluster SEO, Multi-Platform Posts, Publishing Grids, Newsletters",
+    "3_social": "LinkedIn B2B & Founder Personal Branding, Instagram/TikTok 0-3s Hooks, 0-1k Roadmap",
+    "4_email": "Lead Magnet Mechanics, 5-Email Welcome Flow, 3-Stage Cart Recovery, Win-Back Sequences",
+    "5_advertising": "3-Angle Ad Copy Matrices, 7-Dimension CRO Landing Page Wireframes, Meta & Google Ads",
+    "6_promotions": "72-Hour Flash Sales, Decoy Pricing Architecture, Viral Contests, Margin-Safe Coupons",
+    "7_growth": "2-Sided Viral Referral Loops, Influencer Vetting & Cold Outreach, Retention & Churn Diagnosis"
+  }
+}