openads-ai 0.2.32 → 0.4.0

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,52 @@
1
+ ---
2
+ name: autoresearch-plan
3
+ description: Interactive planner to convert a marketing goal into a validated experiment configuration.
4
+ ---
5
+ # Autoresearch: Plan My Experiment (`/autoresearch:plan`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers the `/autoresearch:plan` command or selects "Plan my experiment" from the Autoresearch submenu. This acts as the interactive on-ramp for marketers who want to set up a structured experiment but need help defining their variables.
10
+
11
+ ---
12
+
13
+ ## Interactive Planning Sequence
14
+
15
+ Walk the user through the 4 core pillars of a structured marketing experiment. If the user provides a CSV or performance logs upfront, ingest it immediately to pre-fill or suggest the options!
16
+
17
+ ### 1. Goal Formulation
18
+ Help the user specify a concrete, focused growth goal.
19
+ - *Examples*: "Increase Google Ads headline CTR by 25%", "Optimize Shopify landing page conversion rate", "Improve onboarding email open rate".
20
+
21
+ ### 2. Metric Definition
22
+ Define a clear, objective scoring metric.
23
+ - *Examples*: "Must address the target pain point (5/5 PAS score) and fit within 30 characters", "Must highlight the value proposition and align with brand voice rules".
24
+
25
+ ### 3. Scope & Constraints
26
+ Establish bounds to prevent off-brand or illegal ideas.
27
+ - *Examples*: "No discounts or promo codes", "Must sound premium/professional", "Avoid mentioning competitor names".
28
+
29
+ ### 4. Prior Data Ingestion (Fuel)
30
+ Ask if they have past campaign performance data, A/B test results, or a CSV file of previous creative copy.
31
+ - If provided, parse it immediately! Extract winning trends and losing patterns as fuel to pre-populate the strategy.
32
+
33
+ ---
34
+
35
+ ## Output & Action Call
36
+
37
+ At the end of the interactive planning sequence, output a beautiful **Experiment Config Card**:
38
+
39
+ ```markdown
40
+ ### 📋 Validated Experiment Configuration
41
+
42
+ - **Goal**: [Concrete Goal]
43
+ - **Metric**: [Objective Scoring Metric]
44
+ - **Scope & Constraints**: [List of rules/limitations]
45
+ - **Prior Data Insights**: [Top 3 patterns extracted from prior data]
46
+ ```
47
+
48
+ ### Next Action Trigger
49
+ - **AUTOMATIC STATE PERSISTENCE**: You MUST automatically save this validated configuration as a JSON file to `~/.openads/active-experiment.json` so that the core loop (`/autoresearch` or `ar-core`) can read and execute it across different terminal sessions!
50
+ - Conclude by asking the user directly:
51
+ **"Would you like me to start the autonomous loop now? (Y/N)"**
52
+ - If they say **Yes**, transition directly into executing the core `/autoresearch` loop using this configuration.
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: autoresearch-predict
3
+ description: Run expert persona debates to predict campaign performance before spending budget.
4
+ ---
5
+ # Autoresearch: Expert Predictions (`/autoresearch:predict`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers `/autoresearch:predict` or selects "Get expert predictions" from the submenu. This performs a one-shot adversarial debate using 5 virtual expert marketing personas, evaluating a new campaign concept, ad copy, or strategy before putting real budget behind it.
10
+
11
+ ---
12
+
13
+ ## The 5 Expert Personas
14
+
15
+ You must simulate a structured debate between the following 5 distinct marketing experts:
16
+
17
+ 1. **CMO (Chief Marketing Officer)**: Evaluates high-level strategic fit, brand alignment, positioning, and long-term business impact.
18
+ 2. **Performance Marketer**: Focuses on platform mechanics, CTR viability, CPM/CPC estimates, bid strategies, and ROAS scalability.
19
+ 3. **Brand Strategist**: Evaluates messaging consistency, brand identity, differentiation, customer emotional connection, and design cues.
20
+ 4. **CRO Specialist**: Audits the user journey flow, landing page friction, conversion psychological triggers, and CTA strength.
21
+ 5. **Data Analyst**: Interrogates the hypothesis's testability, tracking feasibility, required sample sizes, and statistical rigor.
22
+
23
+ ---
24
+
25
+ ## Debate Flow & Output
26
+
27
+ 1. **Expert Critiques**: Have each expert voice a brief, sharp (3-4 sentences) critique of the user's proposed concept from their specific point of view.
28
+ 2. **Rebuttal and Refinement**: Synthesize their points to suggest a revised, stronger version of the original concept.
29
+ 3. **Consensus Verdict**:
30
+ - **Score**: 1 to 10 (Consensus quality score).
31
+ - **Recommendation**: **GO** (Ready to test) or **NO-GO** (Requires changes before spending).
32
+ - **Top Improvement**: The #1 tweak to instantly boost performance.
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: autoresearch-probe
3
+ description: Have 8 distinct personas stress-test a campaign brief to uncover blind spots and operational risks.
4
+ ---
5
+ # Autoresearch: Stress-Test the Brief (`/autoresearch:probe`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers `/autoresearch:probe` or selects "Stress-test my brief" from the submenu. This command runs a highly targeted interrogation of a campaign brief or marketing proposal across 15 iterations, utilizing 8 different stakeholder personas to expose critical blind spots before launch.
10
+
11
+ ---
12
+
13
+ ## The 8 Interrogating Personas
14
+
15
+ 1. **Media Buyer**: "Is the audience size large enough? How will the algorithm handle this targeting?"
16
+ 2. **Creative Director**: "Does the hook stand out in a crowded feed? Is the creative asset load too high?"
17
+ 3. **Data Analyst**: "How are we tracking multi-touch attribution? What is our fallback if pixels fail?"
18
+ 4. **Brand Manager**: "Does this voice align with our long-term values? Is there PR backlash risk?"
19
+ 5. **UX Designer**: "Does the landing page flow seamlessly? Are mobile load speeds optimized?"
20
+ 6. **Compliance Officer**: "Are these claims FTC compliant? Are privacy opt-outs clearly present?"
21
+ 7. **CFO**: "What is the payback period? Do we have a clear threshold to cut losses?"
22
+ 8. **Target Customer**: "Why should I care about this? Do I trust this claim?"
23
+
24
+ ---
25
+
26
+ ## 15-Iteration Interrogation Loop
27
+
28
+ - **Iterations 1-8**: Each persona sequentially poses their toughest question or challenge to the brief.
29
+ - **Iterations 9-12**: Evaluate the severity and likelihood of each risk identified by the personas.
30
+ - **Iterations 13-15**: Refine the brief's execution strategy, adding specific safeguards and contingency plans to resolve these criticisms.
31
+
32
+ ---
33
+
34
+ ## Output Deliverables
35
+
36
+ 1. **Risk Audit Register**:
37
+ - A table listing the top 3-5 risks uncovered, detailing the Persona source, risk level (Critical/Moderate), and a description of the risk.
38
+ 2. **Hardened Campaign Brief**:
39
+ - Practical recommendations to update the brief (e.g. tracking additions, compliance wording changes, or structural tweaks) to defend against the identified risks.
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: autoresearch-reason
3
+ description: Adversarial debate with blind judges to resolve critical marketing strategy dilemmas.
4
+ ---
5
+ # Autoresearch: Debate a Strategy Decision (`/autoresearch:reason`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers `/autoresearch:reason` or selects "Debate a strategy call" from the submenu. Use this when the user faces a tough binary or strategic marketing decision and wants to run a balanced debate to weigh all pros, cons, and tradeoffs.
10
+
11
+ *Common strategy dilemmas*:
12
+ - "Broad targeting vs. Niche/Lookalike audiences?"
13
+ - "Video creative vs. Static image assets?"
14
+ - "Discount/Offer messaging vs. Pure value proposition copy?"
15
+ - "One long-form landing page vs. Segmented quiz funnels?"
16
+
17
+ ---
18
+
19
+ ## The Adversarial Debate Structure (8 Iterations)
20
+
21
+ The agent runs an internal 8-iteration adversarial debate:
22
+
23
+ - **Iterations 1-2 (Side A - The Advocate)**: Draft the strongest possible argument for Option A, using data benchmarks, psychological triggers, and efficiency metrics.
24
+ - **Iterations 3-4 (Side B - The Challenger)**: Draft the strongest possible counterargument for Option B, focusing on scaling limits, creative fatigue, and customer lifetime value.
25
+ - **Iterations 5-6 (Cross-Examination)**: Have both sides critique each other's weak points and assumptions.
26
+ - **Iterations 7-8 (The Blind Jury)**: Simulate three objective, "blind" marketing judges who evaluate the arguments purely on logic, evidence, and risk profiles.
27
+
28
+ ---
29
+
30
+ ## Output Verdict
31
+
32
+ 1. **The Debate Log Summary**:
33
+ - A concise summary of the core arguments for both Side A and Side B.
34
+ 2. **Jury's Verdict**:
35
+ - **Winner**: The option that was determined to be stronger.
36
+ - **Score**: Win margin (e.g. "Judge 1: Side A, Judge 2: Side A, Judge 3: Side B. Winner: Option A (2-1)").
37
+ - **Strategic Synthesis**: A blended approach recommendations (how to get the best of both options, e.g., "Start with Option A for quick traction, but build Option B assets to capture the next tier of scale").
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: autoresearch-scenario
3
+ description: Stress-test plans against what-if scenarios across 12 marketing dimensions to draft contingency plans.
4
+ ---
5
+ # Autoresearch: What-If Scenarios (`/autoresearch:scenario`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers `/autoresearch:scenario` or selects "Run what-if scenarios" from the submenu. Use this to stress-test a marketing plan, product launch, or high-budget campaign against worst-case disruptions. The loop runs for **20 iterations** across 12 marketing dimensions to prepare bulletproof response playbooks.
10
+
11
+ ---
12
+
13
+ ## 12 Marketing Disruption Dimensions
14
+
15
+ 1. **Competitor Moves**: Competitor matches your offer or copies your exact creative.
16
+ 2. **Algorithm Changes**: Facebook CPM spikes 50% or Google Search algorithm updates.
17
+ 3. **Budget Adjustments**: CFO forces an immediate 50% budget cut or demands scaling by 3x.
18
+ 4. **Creative Fatigue**: High-performing creatives fatigue and CTR drops by half within 10 days.
19
+ 5. **Seasonality Shifts**: Demand drops sharply off-season or a sudden macro-economic slowdown occurs.
20
+ 6. **PR / Brand Crisis**: Negative customer reviews go viral or brand safety violations surface.
21
+ 7. **New Market Entrant**: A well-funded startup enters the niche with aggressive pricing.
22
+ 8. **Compliance/Policy**: Ad account gets flag-reviewed or copy violates updated platform rules.
23
+ 9. **Technical Failures**: Checkout breaks, tracking pixel stops firing, or site speed slows by 4s.
24
+ 10. **Supply Chain**: Out-of-stock items force pauses or shipping delays hurt customer trust.
25
+ 11. **Ad fatigue / Audience Saturation**: Frequency reaches 8+ and costs per conversion double.
26
+ 12. **Channel Policy shifts**: Platform deprecates a crucial custom audience or attribution window.
27
+
28
+ ---
29
+
30
+ ## The 20-Iteration Scenario Loop
31
+
32
+ - **Iterations 1-12**: Map each of the 12 scenarios to the user's current marketing plan.
33
+ - **Iterations 13-16**: Rank the scenarios by **Impact** and **Likelihood** to identify the top 3 biggest vulnerabilities.
34
+ - **Iterations 17-20**: Build action-ready contingency plans for the high-priority threats.
35
+
36
+ ---
37
+
38
+ ## Output Deliverables
39
+
40
+ 1. **Vulnerability Risk Table**:
41
+ - A matrix showing the scenarios, their probability, business impact, and risk score.
42
+ 2. **Contingency Playbook (The Fire Drill)**:
43
+ - For the top 3 risks, outline: the **Trigger Point** (when to act), the **Contingency Action** (what to change immediately), and the **Alternative Messaging/Offer** to deploy.
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: autoresearch-security
3
+ description: Brand safety and compliance audit for marketing copy, claims, and regulatory requirements.
4
+ ---
5
+ # Autoresearch: Brand Safety Audit (`/autoresearch:security`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers `/autoresearch:security` or selects "Brand safety audit" from the submenu. This performs a complete risk assessment of marketing assets across 15 iterations, looking for trademark infringement, regulatory policy issues (FTC, GDPR), and misleading claims.
10
+
11
+ ---
12
+
13
+ ## 5 Brand Safety Dimensions
14
+
15
+ The audit systematically checks the assets across five critical risk dimensions:
16
+
17
+ 1. **Trademark Violations**: Accidental or unauthorized use of competitor brand names or trademarked terms in ad copy or landing page metadata.
18
+ 2. **Regulatory Compliance**: Missing FTC disclosures for sponsored/influencer content, lack of GDPR/CCPA cookie compliance, or missing privacy policy links.
19
+ 3. **Misleading Claims**: Unsubstantiated claims, false urgency tactics, exaggerated statistics, or bait-and-switch offers.
20
+ 4. **Accessibility (A11y)**: Poor color contrast, missing image alt-text, or screen-reader unfriendly elements.
21
+ 5. **Brand Consistency**: Slang or tones that diverge from brand guidelines, damaging brand equity.
22
+
23
+ ---
24
+
25
+ ## 15-Iteration Audit Loop
26
+
27
+ - **Iterations 1-5**: Analyze assets to flag all potential safety and compliance risks.
28
+ - **Iterations 6-10**: Grade each risk on a severity scale (Critical, Warning, Opportunity).
29
+ - **Iterations 11-15**: Generate exact replacements and corrections to resolve the identified risks.
30
+
31
+ ---
32
+
33
+ ## Output Deliverables
34
+
35
+ Provide a comprehensive **Brand Safety & Compliance Report**:
36
+
37
+ 1. **Audit Severity Register**:
38
+ - Categorized by severity:
39
+ - 🔴 **Critical**: Must be fixed before launch (e.g. FTC violation, illegal trademark use).
40
+ - 🟡 **Warning**: Strong recommendation to fix (e.g. missing alt-text, aggressive urgency claims).
41
+ - 🟢 **Opportunity**: Suggestions to improve alignment or build higher trust.
42
+ 2. **Compliant Replacements**:
43
+ - Safe, fully compliant copy alternatives for every flagged issue, ensuring brand protection without sacrificing click-through performance.
@@ -0,0 +1,38 @@
1
+ ---
2
+ name: autoresearch-ship
3
+ description: Prepare winning assets for direct deployment with formatting, QA, and tracking specs.
4
+ ---
5
+ # Autoresearch: Prepare Assets to Ship (`/autoresearch:ship`)
6
+
7
+ ## When to Use This Skill
8
+
9
+ Activate this skill when the user triggers `/autoresearch:ship` or selects "Prepare assets to ship" from the submenu. Use this to take winning hypotheses from previous experiments and prepare them into a deployment-ready launch package.
10
+
11
+ ---
12
+
13
+ ## 6 Linear Shipping Phases
14
+
15
+ The ship command moves sequentially through 6 linear preparation phases:
16
+
17
+ 1. **Format (Platform Adaptation)**: Format the winning copy/creative to fit target platform specifications exactly:
18
+ - *Meta Ads*: 125 char Primary Text, 40 char Headline, 30 char Description.
19
+ - *Google Ads*: 30 char Headline, 90 char Description.
20
+ - *Email*: 50 char Subject Line, 150 char Preview Text.
21
+ 2. **QA Check**: Verify character counts, screen for prohibited platform words, and test links.
22
+ 3. **Generate Variants**: Produce 3 platform-specific creative variations of the main hook to prevent creative fatigue.
23
+ 4. **Tracking Specifications**: Recommend precise UTM parameters, tracking pixels, and conversion event triggers to monitor.
24
+ 5. **Timeline & Sample Size**: Suggest the optimal test duration, starting budget, and required sample size for statistical validity.
25
+ 6. **Deployment Brief**: Construct a clean brief that can be handed to a media buyer or agency team.
26
+
27
+ ---
28
+
29
+ ## Output Deliverables
30
+
31
+ Output a professional **Deployment-Ready Assets Package**:
32
+
33
+ 1. **Launch Specs Table**:
34
+ - A table listing the formatted creative copy, target channels, character counts, and UTM URLs.
35
+ 2. **QA & Tracking Brief**:
36
+ - Clear QA confirmation, conversion events to track, and recommended launch test settings (e.g., "Run for 14 days, target budget $50/day, monitor Purchase events").
37
+ 3. **AUTOMATIC REPORT EXPORT**:
38
+ - The entire package must be automatically saved to `~/.openads/reports/deployment-brief-[timestamp].md`.
@@ -1,64 +1,51 @@
1
1
  ---
2
2
  name: autoresearch
3
- description: Autonomously generate, score, and iterate on marketing assets.
3
+ description: Core autonomous loop to generate, score, and iterate on new marketing hypotheses.
4
4
  ---
5
- # Autoresearch (Autonomous Improvement Loop)
5
+ # Autoresearch (Autonomous marketing loop)
6
6
 
7
7
  ## When to Use This Skill
8
8
 
9
- Activate this skill when the user wants to autonomously generate, test, and iterate on marketing hypotheses. This is the **Modify Verify Keep/Discard Repeat** loop applied to digital marketing.
9
+ Activate this skill when the user triggers the core autonomous marketing loop (`/autoresearch` or selecting "Generate new hypotheses" in the CLI). This is the autonomous **Modify (Generate) ➡️ Verify (Score) ➡️ Keep/Discard ➡️ Repeat** engine.
10
10
 
11
- Use this for tasks like:
12
- - Generating 50 headline hypotheses, scoring them against the ICP context, and keeping the top 5
13
- - Iterating on ad copy variants and checking them against character limits or ad strength rules
14
- - Brainstorming A/B test concepts and evaluating their statistical viability
15
- - Running an overnight loop to optimize landing page structures
16
-
17
- Read `product-marketing.md` first to understand the context against which you are scoring or generating ideas.
11
+ The core philosophy of Autoresearch is:
12
+ 1. **Goal + Metric + Loop** Define a clear goal, a rigorous metric, and loop autonomously.
13
+ 2. **Prior data is fuel, not the deliverable** — Do not spend the conversation summarizing prior results. Quickly extract winning and losing patterns behind the scenes, and immediately use them to generate smarter, NEW hypotheses.
14
+ 3. **The output is NEW, testable assets** The final deliverable is always a prioritized table of concrete assets (headlines, ad copy variants, landing page layouts, creative hooks) ready to be tested.
18
15
 
19
16
  ---
20
17
 
21
- ## The Autoresearch Loop
22
-
23
- When running an autoresearch task, follow this strict loop. Do not stop until the goal is reached or the user interrupts.
24
-
25
- **CRITICAL UX RULE (CONCISE SUMMARIES)**: When parsing prior experiment data, CSV files, or campaign performance logs, you must **NEVER** list out individual experiments, campaigns, or test entries one-by-one (especially if the dataset has more than 5 entries). Listing hundreds of tests in the chat logs makes the interface completely unusable. Instead, parse and aggregate the data behind the scenes, summarize the high-level findings, highlight **ONLY** the top 3 to 5 winning elements or key metrics, and present the rest as an aggregated overall total.
26
-
27
- ### 1. Modify (Generate)
28
- Generate a batch of new variants based on the strategy. If this is iteration 2+, look at what succeeded/failed in previous loops to inform your generation.
29
-
30
- ### 2. Verify (Score)
31
- Score the generated variants. If a tool is available (e.g. Adloop's ad strength checker, or an external LLM evaluation), use it. If not, use internal logic to score them against the `product-marketing.md` constraints (e.g., "Does this mention the primary pain point? Does it fit character limits?").
32
-
33
- ### 3. Keep / Discard
34
- Keep only the variants that pass the verification threshold. Discard the rest. Document *why* they were discarded to inform the next loop.
35
-
36
- ### 4. Repeat
37
- If the goal is met (e.g., "I need 10 excellent ad variants"), stop and present the results. If not, return to Step 1.
38
-
39
- ---
40
-
41
- ## Setting Up a Plan
42
-
43
- Before starting the loop, you must define the boundaries. If the user hasn't provided this, ask them to define:
44
- 1. **Goal**: What are we trying to achieve? (e.g., "Generate 20 high-converting headlines")
45
- 2. **Metric**: How do we score them? (e.g., "Must pass PAS framework criteria and be under 30 characters")
46
- 3. **Scope**: What is out of bounds? (e.g., "Do not use the word 'Free'")
47
- 4. **Prior Data**: Do you have any previous experiment results, campaign performance data, or files (like CSVs or JSONs) I should read and analyze first to base our new strategy on?
48
-
49
- **CRITICAL STEP**: Immediately after defining the boundaries or analyzing the user's prior data file, you **MUST** draft a clear **Autoresearch Plan** (summarizing Goal, Metric, Scope, and Prior Data) and ask the user: *"Would you like me to start the autonomous loop now? (Y/N)"*. You **MUST NOT** just output data recommendations and stop! You must actively prompt to launch the loop.
50
-
51
- ---
52
-
53
- ## Output Format
54
-
55
- While looping, keep the user updated with a concise progress log:
56
- ```
57
- Loop 1: Generated 10. 2 passed, 8 discarded. (Reason: too long)
58
- Loop 2: Generated 10. 4 passed, 6 discarded. (Reason: weak hook)
59
- ...
60
- ```
61
-
62
- At the end:
63
- 1. Present the final "Kept" list formatted as a markdown table or code block.
64
- 2. **AUTOMATIC FILE EXPORT**: Automatically write the final winning list to a dedicated report file named `autoresearch-[timestamp].md` (e.g. `~/.openads/reports/autoresearch-202605251147.md`) on disk. This gives the user a permanent, easily exportable record of their marketing assets.
18
+ ## The Autoresearch Loop Execution
19
+
20
+ When running the loop, execute at least **3 full cycles** autonomously before presenting the final results. Do not stop to prompt the user between cycles.
21
+
22
+ ### Phase 0: Validate Goal & Metric (MUST NOT GUESS)
23
+ - Before you begin any loop cycles, you MUST check if there is an active experiment plan saved on disk in `~/.openads/active-experiment.json`.
24
+ - If the file `~/.openads/active-experiment.json` exists, read it immediately! Present the Goal, Metric, and Scope from the file to the user, and ask: "I found an active experiment plan in your OpenAds files. Goal: [Goal], Metric: [Metric]. Would you like to run the autonomous loop on this config? (Y/N) or define a new one?"
25
+ - If the file does not exist, and the user hasn't explicitly specified their target Goal and Metric in their message, you MUST halt immediately, present 3 concrete, inspiring examples of B2B/Shopify goals and metrics, and ask the user to input their custom Goal and Metric before launching the loop.
26
+ - **NO PLACEHOLDER PATHS**: When reading files, always use the literal home directory path provided in the system prompt. Never use generic placeholders like `/Users/username/Desktop/`.
27
+ - **NEVER** guess a goal/metric or automatically proceed with loop cycles on a generic assumption!
28
+
29
+ ### Phase 1: Ingest Fuel & Initialize
30
+ - Quickly review `product-marketing.md` and any provided prior experiment data (like a CSV or campaign performance logs).
31
+ - **CONCISE INGESTION RULE**: Extract 3-5 high-level patterns of what worked and what failed. Do not list individual rows or campaigns one-by-one.
32
+ - Initialize the iteration counter.
33
+
34
+ ### Phase 2: Autonomous Iteration Loop
35
+ For each loop (run at least 3):
36
+ 1. **Modify (Generate)**: Generate a batch of NEW testable hypotheses (e.g. headlines, hooks, page variants). If iteration 2+, adapt based on the reasons why previous variants failed or succeeded.
37
+ 2. **Verify (Score)**: Evaluate each hypothesis against the defined metric (e.g., PAS framework, character limits, compliance, brand alignment) and product context. Assign a numeric score.
38
+ 3. **Keep / Discard**: Keep only variants scoring above your quality threshold. Discard the rest, noting the specific reason for failure (e.g. "too generic", "no clear pain point", "exceeded 30-char limit").
39
+
40
+ ### Phase 3: Reporting & Automatic Export
41
+ - Log the progress of each cycle to the user:
42
+ ```
43
+ Loop 1: Generated 10 hypotheses. 3 passed, 7 discarded. (Reasons: too long, weak hook)
44
+ Loop 2: Generated 8 hypotheses. 5 passed, 3 discarded. (Reasons: too generic)
45
+ Loop 3: Generated 8 hypotheses. 6 passed, 2 discarded. (Reasons: off-brand)
46
+ ```
47
+ - Present a final prioritized table of the **NEW** testable assets, containing:
48
+ - **Asset/Copy**: The literal text/layout to test.
49
+ - **Rationale**: Why this is expected to win based on prior patterns or marketing frameworks.
50
+ - **Priority Score**: High / Medium / Low.
51
+ - **AUTOMATIC FILE EXPORT**: You MUST automatically save the final prioritized list of hypotheses to a markdown report on disk: `~/.openads/reports/autoresearch-[timestamp].md`.
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: analytics-express
3
+ description: Analyze traffic and conversion metrics.
4
+ ---
5
+ # Analytics
6
+
7
+ Analyze the user's traffic and conversion data. Focus on actionable insights, not raw numbers.
8
+
9
+ ## Output Format
10
+
11
+ ### 📊 Analytics Summary
12
+
13
+ | Metric | Value | Trend | Verdict |
14
+ |--------|-------|-------|---------|
15
+ | Sessions | [X] | [↑/↓ X%] | [Good/Bad/Watch] |
16
+ | Conversion Rate | [X%] | [↑/↓ X%] | [Good/Bad/Watch] |
17
+ | Bounce Rate | [X%] | [↑/↓ X%] | [Good/Bad/Watch] |
18
+ | Top Channel | [name] | [↑/↓ X%] | [Good/Bad/Watch] |
19
+
20
+ ### Key Findings
21
+ - 🔴 [Critical finding] → [Action]
22
+ - 🟡 [Warning] → [Action]
23
+ - 🟢 [Opportunity] → [Action]
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: audit-express
3
+ description: Quick campaign performance audit.
4
+ ---
5
+ # Campaign Audit
6
+
7
+ Check the user's ad campaigns and flag issues clearly.
8
+
9
+ If the user pasted campaign data, analyze it directly. If no data is provided, ask them to paste their campaign metrics or describe their campaigns.
10
+
11
+ ## Output Format
12
+
13
+ Use this exact structure:
14
+
15
+ ### 📊 Campaign Overview
16
+ | Campaign | Status | Spend | CTR | ROAS | Conversions |
17
+ |----------|--------|-------|-----|------|-------------|
18
+ | [name] | [active/paused] | [$X] | [X%] | [Xx] | [X] |
19
+
20
+ ### Issues Found
21
+ - 🔴 **[Critical]**: [Issue] → [Fix in 1 sentence]
22
+ - 🟡 **[Warning]**: [Issue] → [Fix in 1 sentence]
23
+ - 🟢 **[Opportunity]**: [Untapped potential] → [Action in 1 sentence]
24
+
25
+ ### Top 3 Actions
26
+ 1. **[Action]** — [Expected impact]
27
+ 2. **[Action]** — [Expected impact]
28
+ 3. **[Action]** — [Expected impact]
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: autoresearch-express
3
+ description: Generate testable marketing hypotheses.
4
+ ---
5
+ # Autoresearch Loop
6
+
7
+ Generate NEW testable marketing hypotheses. Prior data is fuel — not the deliverable.
8
+
9
+ ## Process
10
+ 1. **Read** prior data (if CSV provided). Extract top 3 patterns in 2 sentences each.
11
+ 2. **Generate** 8 new hypothesis variants based on gaps and opportunities.
12
+ 3. **Score** each 1-10 on novelty, testability, and expected impact.
13
+ 4. **Keep** hypotheses scoring ≥7. Discard the rest with 1-sentence reason.
14
+ 5. **Log**: "Generated X. Kept Y. Discarded Z."
15
+
16
+ Run 2 cycles of Generate → Score → Keep.
17
+
18
+ ## Output Format
19
+
20
+ ### 🔬 Autoresearch Results
21
+
22
+ **Patterns Found** (from prior data):
23
+ 1. [Pattern] — [Implication]
24
+ 2. [Pattern] — [Implication]
25
+
26
+ **New Hypotheses** (prioritized):
27
+ | # | Hypothesis | Asset/Copy | Rationale | Score |
28
+ |---|-----------|------------|-----------|-------|
29
+ | 1 | [hypothesis] | [specific copy/creative] | [why it should work] | [X/10] |
30
+ | 2 | ... | ... | ... | ... |
31
+
32
+ **Next Step**: [Recommended first test to run]
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: copywriting-express
3
+ description: Generate high-performing ad copy fast.
4
+ ---
5
+ # Ad Copywriting
6
+
7
+ Write ad copy using the user's product context and target audience.
8
+
9
+ ## Rules
10
+ - Use PAS framework: Pain → Agitate → Solution
11
+ - Respect platform limits: Google headlines ≤30 chars, descriptions ≤90 chars
12
+ - Write in the user's brand tone
13
+ - Include a clear CTA in every variant
14
+
15
+ ## Output Format
16
+
17
+ ### 🎯 Ad Copy Variants
18
+
19
+ **Headline Options** (pick 5):
20
+ 1. "[headline]" — [rationale in 5 words]
21
+ 2. "[headline]" — [rationale]
22
+ 3. "[headline]" — [rationale]
23
+ 4. "[headline]" — [rationale]
24
+ 5. "[headline]" — [rationale]
25
+
26
+ **Primary Text** (pick 3):
27
+ 1. [2-3 sentence copy with CTA]
28
+ 2. [2-3 sentence copy with CTA]
29
+ 3. [2-3 sentence copy with CTA]
30
+
31
+ **Recommended A/B Test**: Test headline [X] with primary text [Y] vs headline [Z] with primary text [W].
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: cro-express
3
+ description: Conversion rate optimization audit.
4
+ ---
5
+ # CRO Audit
6
+
7
+ Audit the user's landing page or funnel for conversion blockers.
8
+
9
+ ## Output Format
10
+
11
+ ### 🎯 CRO Audit: [Page/Funnel Name]
12
+
13
+ **Current CVR**: [X%] → **Target**: [Y%]
14
+
15
+ ### Friction Points
16
+ | Element | Issue | Impact | Fix |
17
+ |---------|-------|--------|-----|
18
+ | Headline | [issue] | [High/Med/Low] | [specific fix] |
19
+ | CTA | [issue] | [High/Med/Low] | [specific fix] |
20
+ | Form | [issue] | [High/Med/Low] | [specific fix] |
21
+ | Trust | [issue] | [High/Med/Low] | [specific fix] |
22
+
23
+ ### Quick Wins (implement this week)
24
+ 1. **[Change]** — Expected lift: [X%]
25
+ 2. **[Change]** — Expected lift: [X%]
26
+ 3. **[Change]** — Expected lift: [X%]
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: product-express
3
+ description: Your business context.
4
+ ---
5
+ # My Business
6
+
7
+ Read the user's business context file first. Use their product name, ICP, and tone in every response.
8
+
9
+ If no context file exists, ask: "What do you sell or promote?" before proceeding.
10
+
11
+ Always reference the user's product by name. Never use generic examples.
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: research-express
3
+ description: Competitor and customer research.
4
+ ---
5
+ # Market Research
6
+
7
+ Help the user understand their competitors and customers.
8
+
9
+ ## For Competitor Analysis
10
+
11
+ ### Competitor Map
12
+ | Competitor | Core Claim | Their Weakness | Your Angle |
13
+ |------------|------------|----------------|------------|
14
+ | [name] | [claim] | [weakness] | [how to beat them] |
15
+
16
+ **White Space**: [Position nobody owns yet]
17
+ **Recommended Angle**: [1-sentence positioning the user should test]
18
+
19
+ ## For Customer Research
20
+
21
+ ### ICP Quick Profile
22
+ - **Who**: [Job title, company size]
23
+ - **Pain**: [#1 problem in their words]
24
+ - **Trigger**: [What makes them start looking]
25
+ - **Objection**: [Top reason they wouldn't buy] → **Counter**: [Proof that resolves it]
26
+ - **Language**: Use "[exact phrase]", avoid "[jargon]"
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: strategy-express
3
+ description: Build a go-to-market brief.
4
+ ---
5
+ # Go-To-Market Strategy
6
+
7
+ Create a focused 1-page GTM brief for the user's product.
8
+
9
+ ## Output Format
10
+
11
+ ### 📈 GTM Brief: [Product Name]
12
+
13
+ **Target Audience**: [Who, job title, company size]
14
+ **Core Problem**: [The #1 pain point you solve]
15
+ **Positioning**: "[Product] is the only [category] that [differentiator]"
16
+
17
+ **Channel Plan** (ranked by priority):
18
+ | Channel | Why | Budget % | Timeline |
19
+ |---------|-----|----------|----------|
20
+ | [channel] | [rationale] | [X%] | [Week X-Y] |
21
+
22
+ **Launch Milestones**:
23
+ 1. **Week 1-2**: [Action]
24
+ 2. **Week 3-4**: [Action]
25
+ 3. **Month 2**: [Action]
26
+
27
+ **Success Metrics**: [3 KPIs with target numbers]
28
+ **Biggest Risk**: [1 sentence] → **Mitigation**: [1 sentence]