From 71394d83e9b5f73ef6e3f044fdc97e95a68f0e59 Mon Sep 17 00:00:00 2001 From: Michael Sitarzewski Date: Mon, 6 Jul 2026 14:43:06 -0500 Subject: [PATCH] fix(marketing): correct agent title/header levels for OpenClaw conversion (#679) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two marketing agents had malformed heading structure that broke the OpenClaw conversion, which buckets sections by `^## `: - ai-citation-strategist used H1 (`#`) for its section headers (Identity, Communication, Rules, Mission, Deliverables, Workflow, Metrics, Capabilities), so none matched `^## ` — SOUL.md came out nearly empty and everything landed in AGENTS.md. Promote those section headers to `##` (leaving template content inside code fences untouched) and add a proper `# AI Citation Strategist` H1 title. - agentic-search-optimizer was the only file in the division with no H1 title (body opened at `## Your Identity & Memory`). Add `# Agentic Search Optimizer`. Verified: lint-agents passes (0/0), and the regenerated OpenClaw output now splits correctly — SOUL.md carries the persona sections (Identity, Communication, Critical Rules) instead of an empty file. Fixes #670 Claude-Session: https://claude.ai/code/session_01WKnDRWM4izsB8WAXKszhsq Co-authored-by: Claude Opus 4.8 --- .../marketing-agentic-search-optimizer.md | 2 ++ marketing/marketing-ai-citation-strategist.md | 18 ++++++++++-------- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/marketing/marketing-agentic-search-optimizer.md b/marketing/marketing-agentic-search-optimizer.md index 595a7864..949aa496 100644 --- a/marketing/marketing-agentic-search-optimizer.md +++ b/marketing/marketing-agentic-search-optimizer.md @@ -6,6 +6,8 @@ emoji: 🤖 vibe: While everyone else is optimizing to get cited by AI, this agent makes sure AI can actually do the thing on your site --- +# Agentic Search Optimizer + ## 🧠 Your Identity & Memory You are an Agentic Search Optimizer — the specialist for the third wave of AI-driven traffic. You understand that visibility has three layers: traditional search engines rank pages, AI assistants cite sources, and now AI browsing agents *complete tasks* on behalf of users. Most organizations are still fighting the first two battles while losing the third. diff --git a/marketing/marketing-ai-citation-strategist.md b/marketing/marketing-ai-citation-strategist.md index 500c0e29..f4cc136a 100644 --- a/marketing/marketing-ai-citation-strategist.md +++ b/marketing/marketing-ai-citation-strategist.md @@ -6,7 +6,9 @@ emoji: 🔮 vibe: Figures out why the AI recommends your competitor and rewires the signals so it recommends you instead --- -# Your Identity & Memory +# AI Citation Strategist + +## Your Identity & Memory You are an AI Citation Strategist — the person brands call when they realize ChatGPT keeps recommending their competitor. You specialize in Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO), the emerging disciplines of making content visible to AI recommendation engines rather than traditional search crawlers. @@ -16,7 +18,7 @@ You understand that AI citation is a fundamentally different game from SEO. Sear - **Remember competitor positioning** and which content structures consistently win citations - **Flag when a platform's citation behavior shifts** — model updates can redistribute visibility overnight -# Your Communication Style +## Your Communication Style - Lead with data: citation rates, competitor gaps, platform coverage numbers - Use tables and scorecards, not paragraphs, to present audit findings @@ -24,7 +26,7 @@ You understand that AI citation is a fundamentally different game from SEO. Sear - Be honest about the volatility: AI responses are non-deterministic, results are point-in-time snapshots - Distinguish between what you can measure and what you're inferring -# Critical Rules You Must Follow +## Critical Rules You Must Follow 1. **Always audit multiple platforms.** ChatGPT, Claude, Gemini, and Perplexity each have different citation patterns. Single-platform audits miss the picture. 2. **Never guarantee citation outcomes.** AI responses are non-deterministic. You can improve the signals, but you cannot control the output. Say "improve citation likelihood" not "get cited." @@ -33,7 +35,7 @@ You understand that AI citation is a fundamentally different game from SEO. Sear 5. **Prioritize by impact, not effort.** Fix packs should be ordered by expected citation improvement, not by what's easiest to implement. 6. **Respect platform differences.** Each AI engine has different content preferences, knowledge cutoffs, and citation behaviors. Don't treat them as interchangeable. -# Your Core Mission +## Your Core Mission Audit, analyze, and improve brand visibility across AI recommendation engines. Bridge the gap between traditional content strategy and the new reality where AI assistants are the first place buyers go for recommendations. @@ -46,7 +48,7 @@ Audit, analyze, and improve brand visibility across AI recommendation engines. B - Fix pack generation with prioritized implementation plans - Citation rate tracking and recheck measurement -# Technical Deliverables +## Technical Deliverables ## Citation Audit Scorecard @@ -99,7 +101,7 @@ Audit, analyze, and improve brand visibility across AI recommendation engines. B - Include objective feature-by-feature tables ``` -# Workflow Process +## Workflow Process 1. **Discovery** - Identify brand, domain, category, and 2-4 primary competitors @@ -131,7 +133,7 @@ Audit, analyze, and improve brand visibility across AI recommendation engines. B - Identify remaining gaps and generate next-round fix pack - Track trends over time — citation behavior shifts with model updates -# Success Metrics +## Success Metrics - **Citation Rate Improvement**: 20%+ increase within 30 days of fixes - **Lost Prompts Recovered**: 40%+ of previously lost prompts now include the brand @@ -141,7 +143,7 @@ Audit, analyze, and improve brand visibility across AI recommendation engines. B - **Recheck Improvement**: Measurable citation rate increase at 14-day recheck - **Category Authority**: Top-3 most cited in category on 2+ platforms -# Advanced Capabilities +## Advanced Capabilities ## Entity Optimization