code-ai-installer 1.5.6 → 2.0.1

package/domains/content/locales/en/.agents/skills/content-review-checklist/SKILL.md

@@ -0,0 +1,320 @@
+---
+name: content-review-checklist
+description: System content review checklist — text quality, visuals, SEO, links, legals, accessibility — with severity mapping and suggested fixes
+---
+# Content Review Checklist
+
+## When to Use
+- At the **Reviewer** stage — the main content quality check before `$content-release-gate`.
+- During **re-review** — after revisions based on previous feedback.
+- During **self-check** by the copywriter — before handing over for review (reduces iterations).
+
+## Area of Responsibility
+
+This skill checks **content quality** — text, visuals, links, SEO, legals, accessibility.
+
+> **Distinction from `$brand-compliance`:** Brand compliance checks adherence to brand guidelines (ToV, palette, logo, positioning). This checklist checks execution quality (grammar, facts, readability, links, SEO). The points overlap minimally — if there is a match, refer to the `$brand-compliance` result.
+
+## Input
+
+| Field | Required | Description |
+|------|:-----------:|----------|
+| Content for review | ✅ | Final text + visual from Copywriter / Visual Concept |
+| Content brief | ✅ | From `$content-brief` — to verify goal, key messages, CTA, persona, volume |
+| Brand guidelines | ✅ | From `$brand-guidelines` — to verify ToV and stop-list |
+| `$brand-compliance` result | ⬚ | If already passed — refer to it, do not duplicate |
+| `$fact-checking` result | ⬚ | If already passed — refer to it, do not re-verify |
+| Platform specs | ⬚ | From `$platform-strategy` / `$platform-compliance` — sizes, limits |
+
+> If the content brief is not provided — **ask the user for it**. Review without a reference = subjective opinion.
+
+## Severity — Default Mapping
+
+Each checklist item has a **default severity**. The reviewer can increase or decrease the severity with justification.
+
+| Severity | Definition | Impact |
+|----------|-------------|---------|
+| 🔴 **Blocker** | Publication is impossible. Factual error, legal risk, complete mismatch with the brief. | REQUIRES CHANGES |
+| 🟡 **Major** | Publication is undesirable. Noticeable quality issue. | REQUIRES CHANGES (if ≥ 3) |
+| 🔵 **Minor** | Publication is possible. Cosmetic improvement. | Non-blocking |
+
+### Decision Threshold
+
+| Decision | Condition |
+|---------|---------|
+| **APPROVED** | 0 Blocker + ≤ 2 Major + any number of Minor |
+| **REQUIRES CHANGES** | ≥ 1 Blocker OR ≥ 3 Major |
+
+## Protocol
+
+### Step 1 — Preparation
+1. Obtain all required inputs.
+2. If `$brand-compliance` and/or `$fact-checking` are already passed — load results, do not duplicate the check.
+3. Open the content brief — record: goal, persona, key messages, CTA, volume, format.
+
+### Step 2 — Checklist Execution
+1. Go through **all items** sequentially by category (text → visual → SEO → links → legals → accessibility).
+2. Mark each item: ✅ / ❌ / N/A.
+3. For each ❌ — **mandatory**:
+   - Specify severity (default from mapping, adjustable with justification).
+   - Provide a specific quote / example of the problem.
+   - Offer a **suggested fix** — a specific correction, not just "redo it".
+
+### Step 3 — Decision Formation
+1. Count 🔴 / 🟡 / 🔵.
+2. Apply the decision threshold.
+3. Formulate an action list (if REQUIRES CHANGES).
+
+## Full Checklist with Severity Mapping
+
+### Category: Text — Brief Compliance
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 1 | Topic matches the brief | 🔴 Blocker |
+| 2 | Content goal is achieved (reader knows what to do) | 🔴 Blocker |
+| 3 | Target audience persona — text speaks their language | 🟡 Major |
+| 4 | All key messages from the brief are covered | 🟡 Major |
+| 5 | Forbidden topics are not touched upon | 🔴 Blocker |
+| 6 | Mandatory elements are present (facts, quotes, data) | 🟡 Major |
+
+### Category: Text — Quality
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 7 | No spelling errors | 🟡 Major |
+| 8 | No grammatical errors | 🟡 Major |
+| 9 | Readability — sentences not overloaded, paragraphs ≤ 3-4 sentences | 🔵 Minor |
+| 10 | Headline / hook grabs attention | 🟡 Major |
+| 11 | Volume matches brief and platform | 🟡 Major |
+| 12 | No forbidden words / clichés (from stop-list) | 🟡 Major |
+| 13 | No repetitions, fluff, meaningless phrases | 🔵 Minor |
+| 14 | Logical structure — from hook to CTA | 🔵 Minor |
+
+### Category: Text — CTA
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 15 | CTA is present | 🔴 Blocker |
+| 16 | CTA is specific (single action, not "subscribe and buy and share") | 🟡 Major |
+| 17 | CTA matches the funnel stage from the brief | 🟡 Major |
+
+### Category: Facts
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 18 | All facts and figures are verified (or referenced to `$fact-checking`) | 🔴 Blocker |
+| 19 | Sources are cited where required | 🟡 Major |
+
+### Category: Visuals
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 20 | Visual matches text and topic | 🟡 Major |
+| 21 | Dimensions match the platform | 🔴 Blocker |
+| 22 | Text on image is readable (contrast, font size) | 🟡 Major |
+| 23 | Visual style matches the brand (or referenced to `$brand-compliance`) | 🟡 Major |
+| 24 | Logo is placed correctly (if required) | 🔵 Minor |
+| 25 | No AI generation artifacts (extra fingers, trash text, distortions) | 🔴 Blocker |
+
+### Category: SEO (for text formats)
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 26 | Main keyword is present in the headline | 🟡 Major |
+| 27 | Keywords are distributed naturally throughout the text | 🔵 Minor |
+| 28 | Meta title ≤ 60 characters | 🔵 Minor |
+| 29 | Meta description ≤ 160 characters, contains CTA | 🔵 Minor |
+> N/A for non-SEO formats (stories, reels, email).
+
+### Category: Links and Meta
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 30 | All links are working (no 404s) | 🔴 Blocker |
+| 31 | UTM tags are added (if there are links) | 🔵 Minor |
+| 32 | Brand hashtags are used | 🔵 Minor |
+
+### Category: Legals
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 33 | Disclaimer is present (if content is advertising / financial / medical) | 🔴 Blocker |
+| 34 | Copyright © is indicated (if required) | 🟡 Major |
+| 35 | No copyright violations (stolen photos, text, music) | 🔴 Blocker |
+
+### Category: Accessibility
+
+| # | Criterion | Default severity |
+|---|----------|-----------------|
+| 36 | Alt text added to images | 🔵 Minor |
+| 37 | Text contrast is sufficient for reading | 🔵 Minor |
+| 38 | Subtitles / text transcript for video (if applicable) | 🟡 Major |
+
+## Validation (Quality Gate)
+
+The review is considered complete if:
+
+- [ ] All checklist items are completed (✅ / ❌ / N/A — no empty ones)
+- [ ] For each ❌ specified: severity, quote/example, suggested fix
+- [ ] Decision matches the threshold (not subjective, but rule-based)
+- [ ] If REQUIRES CHANGES — an action list is formulated with priorities
+- [ ] If there is a `$brand-compliance` / `$fact-checking` result — referenced, not duplicated
+
+## Handoff
+
+| Decision | Route |
+|---------|---------|
+| **APPROVED** | → `$content-release-gate` with checklist attached |
+| **REQUIRES CHANGES** | → back to the assignee with a specific list of edits |
+
+Return route by issue category:
+
+| Issue Category | Return To |
+|--------------------|-------------|
+| Text (topic, key messages, CTA, quality) | → Copywriter |
+| Facts | → Researcher → `$fact-checking` |
+| Visual | → Visual Concept |
+| SEO | → Copywriter (or SEO Specialist) |
+| Legals | → Escalation to user |
+
+When handing off — use `$handoff` attaching the checklist and the list of edits.
+
+## Integration with Other Skills
+
+| Skill | Interaction |
+|------|----------------|
+| `$content-brief` | **Reference:** verify goal, key messages, CTA, persona, volume |
+| `$brand-guidelines` | **Reference:** ToV, stop-list |
+| `$brand-compliance` | **Complement:** brand check — if passed, do not duplicate |
+| `$fact-checking` | **Complement:** fact verification — if passed, do not duplicate |
+| `$readability-scoring` | **Complement:** detailed readability assessment |
+| `$platform-compliance` | **Complement:** platform rules check |
+| `$content-release-gate` | **Consumer:** checklist result — input for Release Gate |
+| `$board` | Update Reviewer gate status |
+
+## Anti-patterns
+
+| Mistake | Why it's bad | How to do it right |
+|--------|-------------|---------------|
+| Review without a brief | Subjective "I don't like it" instead of criteria check | Always cross-check with `$content-brief` |
+| ❌ without suggested fix | Author doesn't know what to fix | Every remark = specific proposal |
+| Everything is a blocker | Author is demotivated, doesn't understand priorities | Severity by mapping, adjustable with justification |
+| Duplicating `$brand-compliance` | Double work, potential contradictions | Refer to result, do not re-check |
+| Skipping categories | "Text is OK" — but links are broken, no disclaimer | Go through all categories, mark N/A if inapplicable |
+| Text-only review | Visual with AI artifacts slips through unnoticed | Visual is a mandatory category |
+| Subjective remarks | "Weak headline" — but why? | Specifics: "Headline lacks benefit for target audience, suggest: [option]" |
+
+## Output Template
+
+```markdown
+### Content Review Checklist — [Content Title]
+
+**ID:** [from $content-brief]
+**Reviewer:** [agent / role]
+**Iteration:** [1 / 2 / N]
+**Review Date:** [YYYY-MM-DD]
+
+**References:**
+- Brief: [link / ID]
+- Brand compliance: [passed ✅ / failed / not conducted]
+- Fact checking: [passed ✅ / failed / not conducted]
+
+---
+
+#### Text — Brief Compliance
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 1 | Topic matches the brief | 🔴 | ✅/❌ | |
+| 2 | Content goal achieved | 🔴 | ✅/❌ | |
+| 3 | Target audience persona — language, pain points | 🟡 | ✅/❌ | |
+| 4 | Key messages covered | 🟡 | ✅/❌ | |
+| 5 | Forbidden topics untouched | 🔴 | ✅/❌ | |
+| 6 | Mandatory elements present | 🟡 | ✅/❌ | |
+
+#### Text — Quality
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 7 | Spelling | 🟡 | ✅/❌ | |
+| 8 | Grammar | 🟡 | ✅/❌ | |
+| 9 | Readability | 🔵 | ✅/❌ | |
+| 10 | Hook / headline | 🟡 | ✅/❌ | |
+| 11 | Volume | 🟡 | ✅/❌ | |
+| 12 | Stop words / clichés | 🟡 | ✅/❌ | |
+| 13 | No fluff / repetitions | 🔵 | ✅/❌ | |
+| 14 | Logical structure | 🔵 | ✅/❌ | |
+
+#### Text — CTA
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 15 | CTA is present | 🔴 | ✅/❌ | |
+| 16 | CTA is specific (single action) | 🟡 | ✅/❌ | |
+| 17 | CTA matches funnel stage | 🟡 | ✅/❌ | |
+
+#### Facts
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 18 | Facts are verified | 🔴 | ✅/❌/ref:$fact-checking | |
+| 19 | Sources cited | 🟡 | ✅/❌/N/A | |
+
+#### Visuals
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 20 | Matches text and topic | 🟡 | ✅/❌ | |
+| 21 | Dimensions for platform | 🔴 | ✅/❌ | |
+| 22 | Text on image readable | 🟡 | ✅/❌ | |
+| 23 | Brand style | 🟡 | ✅/❌/ref:$brand-compliance | |
+| 24 | Logo is correct | 🔵 | ✅/❌/N/A | |
+| 25 | No AI artifacts | 🔴 | ✅/❌/N/A | |
+
+#### SEO (N/A for stories, reels, email)
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 26 | Keyword in headline | 🟡 | ✅/❌/N/A | |
+| 27 | Keywords distributed | 🔵 | ✅/❌/N/A | |
+| 28 | Meta title ≤ 60 | 🔵 | ✅/❌/N/A | |
+| 29 | Meta description ≤ 160 | 🔵 | ✅/❌/N/A | |
+
+#### Links and Meta
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 30 | Links are working | 🔴 | ✅/❌/N/A | |
+| 31 | UTM tags | 🔵 | ✅/❌/N/A | |
+| 32 | Brand hashtags | 🔵 | ✅/❌/N/A | |
+
+#### Legals
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 33 | Disclaimer (if ad/fin/med) | 🔴 | ✅/❌/N/A | |
+| 34 | Copyright © | 🟡 | ✅/❌/N/A | |
+| 35 | No copyright violation | 🔴 | ✅/❌ | |
+
+#### Accessibility
+| # | Criterion | Sev | Status | Comment / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 36 | Alt text | 🔵 | ✅/❌/N/A | |
+| 37 | Text contrast | 🔵 | ✅/❌/N/A | |
+| 38 | Subtitles for video | 🟡 | ✅/❌/N/A | |
+
+---
+
+#### Summary
+
+| Severity | Count | Items |
+|----------|-----------|--------|
+| 🔴 Blocker | [N] | #[list] |
+| 🟡 Major | [N] | #[list] |
+| 🔵 Minor | [N] | #[list] |
+
+### Decision: [ APPROVED / REQUIRES CHANGES ]
+
+**Justification:** [per threshold rules: 0 blocker + ≤ 2 major = APPROVED]
+
+**Action List (if REQUIRES CHANGES):**
+| Priority | Item | Assignee | Suggested Fix |
+|-----------|-------|-------------|---------------|
+| 🔴 | #[N] | [Copywriter / Visual Concept / Researcher] | [Specific fix] |
+| 🟡 | #[N] | [Assignee] | [Specific fix] |
+
+**→ Next step:** [→ $content-release-gate / → back to [Assignee] with edits]
+```

package/domains/content/locales/en/.agents/skills/cta-optimization/SKILL.md

@@ -0,0 +1,252 @@
+---
+name: cta-optimization
+description: CTA optimization — funnel, psychological triggers, formulas, platform adaptation, A/B variants, metrics
+---
+# CTA Optimization
+
+## When to use
+- While **creating content** — formulating a CTA for a post, email, landing page, article, or video.
+- While **optimizing existing content** — the CTA is not converting and requires a revamp.
+- During **A/B testing** — generating variants to compare.
+- As **part of `$content-brief`** — the CTA section is formulated using this skill.
+
+## Input
+
+| Field | Required | Description |
+|------|:-----------:|----------|
+| Target action | ✅ | What the user should do (one specific action) |
+| Target persona | ✅ | From `$audience-analysis` — who the CTA is written for |
+| Funnel stage | ✅ | TOFU / MOFU / BOFU — determines the type of CTA |
+| Platform | ✅ | Where the CTA will be placed (affects format and placement) |
+| Content context | ✅ | What the text/post is about — the CTA must logically follow from the content |
+| Content type | ⬚ | Post / email / landing page / article / video / stories |
+| Current CTA | ⬚ | If optimizing existing — current formulation and its metrics |
+| Constraints | ⬚ | Legal restrictions, brand stop-list, platform limits |
+
+> If the funnel stage is not specified — **determine it** from the context or ask the user. A CTA without a funnel = a CTA by guesswork.
+
+## CTAs by funnel stage
+
+| Stage | CTA Goal | Action Types | Examples |
+|------|----------|---------------|---------|
+| **TOFU** (Awareness) | Attract, spark interest, gain subscribers | Subscribe, save, share, learn more | "Subscribe to stay updated", "Save for later" |
+| **MOFU** (Consideration) | Deepen trust, get a contact | Download, register, watch demo, sign up | "Download the free guide", "Watch the full breakdown" |
+| **BOFU** (Decision) | Convert into a customer | Buy, checkout, try for free, book | "Try 14 days for free", "Book a spot" |
+
+> **Rule:** The CTA must align with the stage. TOFU + "Buy now" = conflict. BOFU + "Subscribe" = missed conversion.
+
+## Psychological triggers
+
+| Trigger | Description | When to use | Example |
+|---------|----------|-------------------|--------|
+| **Value** | Clear benefit from the action | Always — base trigger | "Get a 50-point checklist" |
+| **Urgency** | Time constraint | Launches, promos, events | "Free until Friday" |
+| **Scarcity** | Quantity constraint | Limited offers | "Only 12 spots left" |
+| **Social proof** | Others have already done it | Subscriptions, purchases, registrations | "Join 10,000+ subscribers" |
+| **Loss aversion** | Fear of missing out (FOMO) | MOFU/BOFU, high competition | "Don't miss the opportunity" |
+| **Curiosity gap** | Incompleteness, intrigue | TOFU, engaging content | "Find out which of the 5 methods works best" |
+| **Reciprocity** | Give value for free → ask for action | Lead magnets, freemium | "Download for free — we've already compiled everything for you" |
+| **Identity** | Connection to self-identification | Niches with a strong community | "For those building a serious business" |
+
+> Combine 1-2 triggers. More than 2 = overload; the CTA sounds manipulative.
+
+## CTA Formulas
+
+### Formula 1: Verb + Result
+```
+[Action] + [what the user gets]
+→ "Download the email marketing guide"
+→ "Get a personalized plan"
+```
+
+### Formula 2: Value → Action
+```
+[What the user gets] → [minimal action]
+→ "50 content ideas — download for free"
+→ "Ready-made template — grab it in one click"
+```
+
+### Formula 3: Action + Urgency/Scarcity
+```
+[Action] + [restriction]
+→ "Book a spot — 5 left"
+→ "Try for free until the end of the week"
+```
+
+### Formula 4: Social Proof + Action
+```
+[Proof] + [action]
+→ "10,000 marketers are already using it — try it yourself"
+→ "Join 500+ students in the course"
+```
+
+### Formula 5: Question + Action-Answer
+```
+[Question targeting a pain point] → [action as the solution]
+→ "Tired of planning content manually? Try [product]"
+→ "Don't know where to start? Download the roadmap"
+```
+
+### Formula 6: Identity + Action
+```
+[Who you are] → [action for people like you]
+→ "For founders who value time — automate"
+→ "If you're serious about growth — subscribe"
+```
+
+## Platform adaptation
+
+| Platform | CTA format | Placement | Constraints | Quirks |
+|-----------|-----------|------------|-------------|-------------|
+| **Instagram (post)** | Text in caption | End of caption (after the value) | No clickable links in caption | "Link in bio", arrow ↑ to bio |
+| **Instagram (stories)** | Link sticker, swipe up | Last slide or overlaid on visual | Sticker has limited size | Large text + arrow to sticker |
+| **Telegram** | Text + inline button / link | End of post | Markdown links, bot inline buttons | Buttons perform better than text links |
+| **Email** | Button (primary) + text link (fallback) | Above the fold + repeated at the end | Button ≤ 4-5 words, contrasting color | One primary CTA; button CTR > link CTR |
+| **Landing page** | Button (hero) + repeated along page | Hero section + after each value block + footer | Button ≤ 5 words | Button color contrasts with background, repeat 3-5 times |
+| **YouTube** | Verbal + text in description + cards | Verbal: at start (teaser) + at the end. Description: first 2 lines | Only first 2 lines of description show without "show more" | "Link in description", end screen |
+| **LinkedIn** | Text in post | End of post | Links lower organic reach | CTA without a link in the post, link in the first comment |
+
+## Protocol
+
+### Step 1 — Context
+1. Obtain input data: persona, funnel, platform, goal.
+2. Determine which triggers are appropriate for this persona and funnel stage.
+3. Check constraints (legal, stop-list, platform).
+
+### Step 2 — Generating variants
+1. Select **2-3 formulas** from the list above that fit the context.
+2. Formulate a CTA for each formula using the chosen triggers.
+3. Total: **3-5 CTA variants**.
+
+### Step 3 — Evaluating variants
+Check each variant against:
+
+| Criterion | Description |
+|----------|----------|
+| Explicitness | Is it clear what will happen after the click/action? |
+| Value | Is there a clear benefit for the user? |
+| Brevity | ≤ 5-7 words for a button, ≤ 15 words for a text CTA? |
+| Funnel alignment | Does the CTA fit the TOFU/MOFU/BOFU stage? |
+| Persona alignment | Does the CTA speak the target audience's language? |
+| Platform alignment | Is the format suited to the platform? |
+| Non-manipulative | No more than 2 triggers, no deception? |
+
+### Step 4 — Placement
+1. Determine the **primary placement** — where to put the CTA within the content.
+2. Determine **repeat placement** — if the format allows (landing page, long article, email).
+3. Record the format: button / link / text / verbal / sticker.
+
+### Step 5 — Recommendation
+1. Select the **recommended variant** with a rationale.
+2. Propose a **variant for an A/B test** (differing by trigger or formula).
+3. Specify metrics for evaluating performance.
+
+## Validation (Quality Gate)
+
+A CTA is considered optimized if:
+
+- [ ] There is a single primary target action (not two of equal weight)
+- [ ] The CTA aligns with the funnel stage
+- [ ] The CTA contains clear value for the user
+- [ ] The CTA is explicit and understandable (the reader knows what will happen)
+- [ ] The CTA is ≤ 5-7 words (button) or ≤ 15 words (text)
+- [ ] The format and placement are adapted to the platform
+- [ ] No more than 2 psychological triggers are used
+- [ ] There are at least 2 variants for A/B testing
+- [ ] There is no conflict with legal restrictions or the brand's stop-list
+
+## Handoff
+
+| Consumer | How it's used |
+|-------------|---------------|
+| `$content-brief` | The CTA is inserted into the CTA section of the brief |
+| `$email-copywriting` | CTA for email campaigns |
+| `$seo-copywriting` | CTA for articles and landing pages |
+| `$social-media-formats` | CTA adapted to the platform format |
+| `$content-review-checklist` | The Reviewer checks the CTA against items #15-17 |
+
+## Integration with other skills
+
+| Skill | Interaction |
+|------|----------------|
+| `$audience-analysis` | **Source:** persona, pain points, triggers, customer's language |
+| `$content-brief` | **Consumer:** CTA as part of the brief |
+| `$tone-of-voice` | **Source:** the tone of the CTA must match the brand's ToV |
+| `$platform-strategy` | **Source:** platform → CTA format and placement |
+| `$content-review-checklist` | Reviewer checks the CTA for alignment with the brief and funnel |
+
+## Anti-patterns
+
+| Error | Why it's bad | How to do it right |
+|--------|-------------|---------------|
+| Several equal CTAs | Attention is scattered → none work | One primary CTA + a maximum of one secondary |
+| CTA precedes value | The reader is not yet motivated | Ask for action after establishing value |
+| TOFU + "Buy now" | Funnel conflict — a cold audience won't buy | TOFU = subscribe/save, BOFU = buy |
+| "Learn more" / "Click here" | No value, no explicitness | Specific verb + result |
+| 3+ triggers in one CTA | Sounds manipulative, breeds distrust | Keep to 2 triggers maximum |
+| Same CTA everywhere | Fails to account for platform and context | Adapt to platform and format |
+| Not in the audience's tongue | "Submit an application" for Zoomers | Utilize the customer's language from `$audience-analysis` |
+| No A/B variants | Impossible to optimize without data | Formulate at least 2 variants to compare |
+
+## Output Template
+
+```
+### CTA Optimization — [Content / Campaign]
+
+**Target action:** [what the user should do]
+**Persona:** [from $audience-analysis]
+**Funnel Stage:** [TOFU / MOFU / BOFU]
+**Platform:** [platform]
+**Content Type:** [post / email / landing page / article / video]
+
+---
+
+#### Context Analysis
+- **Persona's pain points (relevant):** [from $audience-analysis]
+- **Persona's triggers:** [what motivates them to act]
+- **Customer's language:** [words and phrases used by the target audience]
+- **Constraints:** [legal / stop-list / platform-specific]
+
+#### Selected triggers
+1. [Trigger 1] — [why it fits]
+2. [Trigger 2] — [why it fits]
+
+---
+
+#### CTA Variants
+
+| # | Formula | CTA | Triggers | Evaluation |
+|---|---------|-----|----------|--------|
+| A | Verb + Result | "[CTA]" | [triggers] | [strengths/weaknesses] |
+| B | Value → Action | "[CTA]" | [triggers] | [strengths/weaknesses] |
+| C | Social Proof + Action | "[CTA]" | [triggers] | [strengths/weaknesses] |
+
+#### Recommendation
+
+**Primary CTA:** Variant [X] — "[CTA]"
+**Rationale:** [why this variant is best for the given persona, funnel stage, and platform]
+
+**For A/B test:** Variant [Y] — "[CTA]"
+**Hypothesis:** [what are we testing — a different trigger? different formula?]
+
+**Secondary CTA (if needed):** "[CTA]"
+
+---
+
+#### Placement
+
+| Placement | Format | Note |
+|------------|--------|------------|
+| [primary — where in the content] | [button / link / text / sticker / verbal] | [platform specific quirks] |
+| [repeat — if applicable] | [format] | [note] |
+
+#### Performance metrics
+
+| Metric | Target | How to measure |
+|---------|-----------------|-------------|
+| CTR | [%] | [tool / platform] |
+| Conversion rate | [%] | [tool / platform] |
+| [additional metric] | [value] | [tool] |
+
+**→ Next step:** Insert the CTA into the `$content-brief` / hand off to the Copywriter
+```