agileflow 3.4.2 → 4.0.0-alpha.1

package/src/core/knowledge/ads/paid-advertising-research-2026.md

@@ -1,445 +0,0 @@
-# The State of Paid Advertising 2026: Technical Architecture, Algorithmic Shifts, and Strategic Optimization
-
-## Executive Summary: The Signal-Based Paradigm
-
-The digital advertising ecosystem of February 2026 operates under a fundamentally new paradigm: the transition from keyword-centric targeting to signal-based intent modeling. For engineering teams and marketing architects building automated optimization tools like *claude-ads*, the operational reality has shifted from manual bid management to "signal feeding." This report serves as a comprehensive technical and strategic blueprint, dissecting the failure of the Google Privacy Sandbox, the rise of generative search inventory, and the specific API architectures required to audit and optimize campaigns across Google, Meta, TikTok, LinkedIn, and Microsoft.
-
-The deprecation of Google's Privacy Sandbox initiative in late 2025, combined with the indefinite persistence of third-party cookies in Chrome, has created a hybrid tracking environment where first-party data moats are the primary differentiator.<sup>1</sup> However, reliance on browser-side pixels is now a vulnerability; the industry standard has moved to server-side integrations (CAPI) and Media Mix Modeling (MMM) as the source of truth for attribution.<sup>2</sup> Platform architectures have evolved to prioritize "black box" automation--Google's AI Max for Search and Performance Max (PMax) dominate inventory, while Meta's Andromeda engine has restructured ad retrieval to favor creative portfolios over individual variants.<sup>3</sup>
-
-This document provides the specific logic, API endpoints, benchmarks, and scoring methodologies required to build a defensible, high-impact auditing tool for this new era.
-
----
-
-## Section 1: The Macro-Environment & Privacy Infrastructure
-
-### 1.1 The Post-Sandbox Reality and Cookie Persistence
-
-As of early 2026, the digital advertising industry has stabilized following the collapse of Google's Privacy Sandbox initiative. After six years of development, Google officially retired the initiative in October 2025 due to insurmountable regulatory scrutiny from the UK's Competition and Markets Authority (CMA) and significant performance degradation observed during industry testing.<sup>1</sup> The core APIs proposed--Topics, Protected Audience, and Attribution Reporting--have been shut down on both Chrome and Android.<sup>1</sup>
-
-The immediate implication for ad-tech architecture is that third-party cookies remain active in Chrome. However, this preservation comes with a critical caveat: Google has abandoned plans for a new user-choice prompt, maintaining existing controls instead.<sup>1</sup> This creates a false sense of security for advertisers relying solely on client-side tracking. While the cookies exist, the signal fidelity is degraded by browser-level protections and the massive adoption of iOS privacy frameworks.
-
-**Implications for *claude-ads* Architecture:** The auditing tool must not validate tracking health based solely on the presence of a pixel. It must prioritize server-side integrations as the standard. The logic should penalize accounts that lack a dual-tagging implementation (Pixel + Server-Side) because reliance on cookies is now a fragility rather than a standard. The tool must verify "Enhanced Conversions" in Google Ads and "Event Match Quality" (EMQ) in Meta to ensure data durability.<sup>5</sup>
-
-### 1.2 The Rise of "AI Max" and Generative Search Inventory
-
-The most significant operational change in 2026 is the integration of ads into AI Overviews (AIO) via "AI Max." This is not merely a campaign type but a suite of features layering on top of Search. It utilizes Large Language Models (LLMs) to match landing page content directly to complex, conversational user queries, bypassing traditional keyword matching logic.<sup>6</sup>
-
-For an orchestration tool, this necessitates a shift in landing page auditing. Traditional SEO heuristics like keyword density are less relevant than "machine-interpretability"--specifically, the presence of structured data (Schema) and semantic hierarchy that allows Google's AI to scrape "answers" directly from the page to form ad copy.<sup>7</sup> The CLI tool must scrape landing pages to validate the existence of FAQPage and Product schema, ensuring the content is structured for AI ingestion.
-
-### 1.3 The Media Mix Modeling (MMM) Renaissance
-
-With deterministic tracking fragmented, Media Mix Modeling (MMM) has re-emerged as the primary mechanism for budget allocation. Modern MMM tools in 2026, such as Google Meridian and Meta Robyn, use Bayesian methods to quantify uncertainty and calibrate incrementality.<sup>2</sup> The 2026 best practice is a "Hybrid Measurement Strategy," combining real-time multi-touch attribution (MTA) for tactical optimization with periodic MMM for strategic budget setting.<sup>2</sup>
-
-**Strategic Logic for Optimization:**
-
-When *claude-ads* recommends budget shifts, it cannot rely solely on platform-reported ROAS, which often claims credit for conversions driven by other channels. Ideally, the tool should ingest MMM coefficients or "incrementality multipliers" to weight the platform data. For example, a reported Meta ROAS of 4.0 might be weighted down by 30% based on MMM incrementality findings, while a YouTube View-Through conversion might be weighted up.
-
----
-
-## Section 2: Google Ads Architecture & Optimization Logic
-
-### 2.1 The New Search Logic: Broad Match & Smart Bidding
-
-The definitive "power pairing" for 2026 is Broad Match combined with Smart Bidding. The operational definition of "Exact Match" has loosened to capture "same meaning," while Broad Match now captures "intent" derived from user history, landing page context, and real-time signals.<sup>7</sup> This shift renders manual CPC bidding on exact match keywords largely obsolete for growth-focused accounts.
-
-**Audit Logic for Broad Match:**
-
-- **Pre-requisite Check:** Broad match should *never* be enabled without a Smart Bidding strategy (tCPA or tROAS) active. The *claude-ads* tool must flag any Broad Match keywords running on Manual CPC as a "Critical" error, as this combination leads to unrestricted spend on irrelevant queries without the safety rail of conversion probability modeling.<sup>7</sup>
-- **Negative Keyword Moats:** Because Broad Match expands reach aggressively, account-level negative keyword lists are mandatory. The tool must check for the presence of "theme-based" negative lists (e.g., "Competitor," "Cheap/Free," "Jobs") applied globally to filter low-intent traffic before it enters the auction.<sup>7</sup>
-- **Brand Guidelines:** The tool must verify that "Brand Guidelines" are configured in PMax and Search settings. This feature restricts the AI's generative copy capabilities to approved brand voice and terminology, preventing hallucinated or off-brand ad text during broad matching expansion.<sup>7</sup>
-
-### 2.2 Performance Max (PMax) Maturity
-
-Performance Max has evolved from a "black box" to a configurable "grey box" by 2026. New controls allow for campaign-level negative keywords, brand exclusions, and improved asset reporting.<sup>9</sup> The primary frustration--lack of visibility--has been partially addressed through "Share of Voice" reporting and "Search Term Insights," which allow advertisers to see where the budget is actually going.<sup>10</sup>
-
-**PMax Structure for 2026:** The prevailing best practice is to structure Asset Groups by **User Intent** rather than Product Category. For example, instead of separate groups for "Running Shoes" vs. "Basketball Shoes," the structure should target "High-Performance Athletes" (featuring technical specs and dynamic imagery) vs. "Casual Commuters" (featuring lifestyle imagery and comfort-focused copy).<sup>7</sup> This aligns the creative assets with the audience signals the AI is optimizing for.
-
-**Audit Checkpoints:**
-
-- **Asset Density:** Each Asset Group must contain the maximum allowance of headlines (15), descriptions (5), and images (20). The tool should flag groups with fewer than 5 images or missing video assets.<sup>7</sup>
-- **Video Necessity:** PMax now generates robotic, low-quality videos from static images if no video is provided. The audit must detect asset groups lacking native video assets (vertical, square, and landscape) and mark them as "High Risk" for brand safety and Ad Strength.<sup>7</sup>
-- **New Customer Acquisition (NCA):** Verify that the "Only bid for new customers" or "Bid higher for new customers" value rules are active for prospecting campaigns. Failing to distinguish new vs. returning users is a primary cause of inflated ROAS metrics that do not drive incremental growth.<sup>7</sup>
-
-### 2.3 Ad Rank and Quality Score in 2026
-
-The Ad Rank formula remains the core sorting mechanism: **Ad Rank = CPC Bid x Quality Score**. However, the weighting of Quality Score components has shifted significantly in 2026.<sup>11</sup>
-
-**The 2026 Quality Score Formula:**
-
-While the exact weights are proprietary, 2026 research indicates the following priority hierarchy:
-
-1. **Expected Click-Through Rate (CTR):** The heaviest weighted component. It signals user satisfaction and relevance to the query.
-2. **Landing Page Experience:** Critical for AI Overviews. Factors include Core Web Vitals (speed < 2s), mobile responsiveness, and semantic clarity.<sup>7</sup>
-3. **Ad Relevance:** Measures how well the ad copy answers the user's intent.
-
-**Audit Calculation:**
-
-The *claude-ads* tool should approximate Ad Rank health by pulling the 1-10 Quality Score for all keywords.
-
-- **Score < 5:** Critical Warning (Wasting budget due to high CPC penalty).
-- **Score 5-7:** Warning (Optimization opportunity).
-- **Score 8-10:** Healthy.
-- *Formula:* Actual CPC = (Ad Rank of Advertiser Below / Your Quality Score) + $0.01.<sup>11</sup> This formula demonstrates that increasing Quality Score is the only mathematically viable way to lower costs while maintaining position.
-
-### 2.4 Google Ads API v23 Integration
-
-The v23 update (January 2026) introduced critical capabilities for auditing and optimization. Developers must upgrade client libraries to utilize these features.<sup>13</sup>
-
-**Key API Features for Auditing:**
-
-- **Granular Invoice Details:** InvoiceService.ListInvoices now returns campaign-level cost breakdowns, enabling precise margin analysis at the billing level.<sup>13</sup>
-- **Share of Voice (SOV) in PMax:** New metrics for impression share lost to budget/rank in PMax are available via the API. This allows the tool to diagnose whether a campaign needs creative optimization (rank) or more money (budget).<sup>10</sup>
-- **Ad Strength Diagnostic:** The API now provides specific "Good" or "Excellent" ratings for RSA assets. The tool should enforce a policy where no ad group runs with "Poor" ad strength.<sup>14</sup>
-- **Campaign Scheduling:** New fields Campaign.start\_date\_time and Campaign.end\_date\_time allow for precise scheduling down to the minute, essential for "flash sale" automations.<sup>13</sup>
-
----
-
-## Section 3: Meta Ads: The Andromeda Engine & Advantage+
-
-### 3.1 The Andromeda Algorithm Update
-
-Meta's 2025/2026 infrastructure update, codenamed "Andromeda," has shifted the ad retrieval engine from a simple auction to a complex AI-driven matching system. Andromeda utilizes massive parallel computing to reconstruct latent user-ad interaction signals on the fly, optimizing for "creative portfolios" rather than single ads.<sup>4</sup>
-
-**Operational Shift:**
-
-- **Breathing Room:** The old rule of "3-5 ads per ad set" is obsolete. Andromeda requires larger creative volume to function effectively. It allows for higher ad counts per ad set because it can dynamically allocate budget to the specific asset that matches a user's momentary context.<sup>4</sup>
-- **Creative as Targeting:** The creative *is* the targeting. Broad targeting (no interests, no lookalikes) combined with specific creative angles allows Andromeda to find the audience based on who engages with the content.<sup>15</sup> The algorithm uses the visual and semantic data within the ad to determine who to show it to.
-
-### 3.2 Account Structure: The "3-Stage" System
-
-The *claude-ads* tool should enforce a consolidated account structure to maximize signal density for Andromeda. The traditional "testing campaign" with many ad sets is replaced by a more streamlined flow <sup>15</sup>:
-
-1. **Testing Campaign (ABO):** A single campaign for testing new concepts. It can handle multiple batches of concepts in a single ad set.
-2. **Challenger ASC (Advantage+ Shopping Campaign):** A dedicated campaign for "graduating" winners. This prevents new winners from being starved of budget by legacy winners in the core campaign. It forces the system to give the new winner a fair shot.
-3. **Core / Evergreen Campaign (CBO):** The home for proven, scalable assets that have survived the Challenger phase.
-
-**Red Flag Logic for Audits:**
-
-- **Fragmentation:** Flag accounts with >5 active campaigns targeting the same country/funnel stage. This fragments data and prevents Andromeda from learning effectively.<sup>16</sup>
-- **Audience Overlap:** Flag ad sets with high auction overlap rates, as this forces the advertiser to bid against themselves.
-
-### 3.3 Creative Signals & "Social-Native" Content
-
-Meta explicitly rewards "social-native" content--ads that look like organic user posts. The algorithm favors vertical, raw content that feels like a friend's story.<sup>15</sup>
-
-**Audit Criteria for Creative:**
-
-- **Visual Signals:** The tool should analyze asset metadata for 9:16 aspect ratios. Handheld camera movement, selfie POV, native text overlays, and "lo-fi" production values are positive signals.<sup>15</sup>
-- **Hook Rate:** The first 3 seconds are critical. The API now provides a Reels Skip Rate metric. The tool should audit videos with >50% skip rates in the first 3 seconds and flag them for creative refresh.<sup>17</sup>
-- **Organic Boosting:** The most effective strategy in 2026 is identifying top-performing organic Instagram Reels and promoting them via partnership ads. This carries over the social proof (likes/comments), which acts as a quality signal in the auction.<sup>15</sup>
-
-### 3.4 Meta Marketing API Best Practices
-
-- **Rate Limits:** Meta enforces strict rate limits calculated on a rolling 1-hour window. The tool must implement **exponential backoff** strategies when receiving error codes 613 or 80004 to avoid suspension.<sup>18</sup>
-- **Insights API:** Use the Insights endpoint to pull video\_avg\_time\_watched\_actions and outbound\_clicks to correlate engagement with conversion.<sup>17</sup>
-- **CAPI Health:** The "Event Match Quality" (EMQ) score is the north star for tracking. The tool must query the EMQ score for the Purchase event. A score below **7.0/10** indicates severe data loss and should trigger a high-priority alert.<sup>19</sup>
-
----
-
-## Section 4: TikTok Ads: Commerce & Search Integration
-
-### 4.1 TikTok as a Search Engine
-
-By 2026, TikTok has solidified its position as a primary search engine for Gen Z. The "Search Ads Toggle" in campaigns allows ads to appear in search results, capturing high-intent traffic.<sup>20</sup>
-
-**Strategy & Audit:** Advertisers must treat TikTok captions like SEO meta descriptions. High-intent keywords (e.g., "best acne cream 2026") must be integrated into the video text overlays and captions to trigger search ad placements. The tool should verify that the "Search Ads Toggle" is **ON** for all campaigns. Data suggests a 70% stronger CPA for ad groups with this toggle enabled.<sup>20</sup>
-
-### 4.2 Smart+ Campaigns & Automation
-
-TikTok's "Smart+" campaigns (similar to Meta's Advantage+) automate targeting, bidding, and creative selection. This campaign type uses machine learning to predict which user is most likely to convert.<sup>21</sup>
-
-**Optimization Logic:**
-
-- **Creative Fatigue:** Smart+ rotates creatives rapidly. The tool should monitor the "Lifespan" of ads. If a creative has been active for >7 days with declining CTR, it should be flagged for replacement.<sup>21</sup>
-- **Creative Quantity:** Best practice dictates uploading at least **6 creative assets** per ad group to allow the system to optimize effectively.<sup>21</sup>
-
-### 4.3 TikTok Shop Integration
-
-For e-commerce, TikTok Shop is the primary conversion engine. Integrating Video Shopping Ads (VSA) allows users to purchase directly without leaving the app, reducing friction.
-
-- **Audit Check:** The tool should audit whether the account is utilizing "Spark Ads" linked to creator profiles. Spark Ads typically outperform non-Spark ads because they leverage the creator's native authority and profile linkage.<sup>23</sup>
-
-### 4.4 API Rate Limits & Engineering
-
-TikTok's API is stricter than Meta's, requiring careful engineering for the CLI tool.
-
-- **Rate Limit:** 600 requests per minute for core endpoints (/v2/ad/query/).<sup>24</sup>
-- **Throttling:** The tool must respect HTTP 429 responses and implement a queueing system to manage requests across multiple client accounts. It must handle error codes like rate\_limit\_exceeded gracefully by waiting for the Retry-After duration.<sup>24</sup>
-
----
-
-## Section 5: LinkedIn Ads: The B2B Trust Engine
-
-### 5.1 Thought Leader Ads (TLA)
-
-Thought Leader Ads are the dominant format for B2B in 2026. These allow companies to sponsor posts from their executives' or employees' personal profiles, leveraging the trust of individuals over corporate brands.
-
-- **Performance:** TLAs deliver **1.7x higher CTR** and **1.6x more engagement** than standard single-image company ads.<sup>25</sup>
-- **Cost Efficiency:** They can achieve CPCs as low as **$4.14** compared to **$22+** for standard brand campaigns.<sup>25</sup>
-- **Strategy:** The *claude-ads* tool should recommend allocating 30% of the budget to TLAs for "humanizing" the brand and building trust at the top of the funnel.
-
-### 5.2 Conversation Ads vs. Message Ads
-
-- **Conversation Ads:** Interactive, "choose-your-own-path" messages. They achieve a **12% CTR** on average. These are best for complex offers where the user needs to self-qualify (e.g., "Which challenge are you facing? -> Here is a specific whitepaper").<sup>27</sup>
-- **Message Ads:** Linear, single-CTA messages. Best for direct event invites or simple announcements.
-- **Frequency Cap:** LinkedIn enforces a strict frequency cap (1 message per 30-45 days per user). The tool must track "Frequency" carefully; bidding aggressively (CPS - Cost Per Send) is recommended to win the auction for the user's limited inbox slot.<sup>27</sup>
-
-### 5.3 Benchmarks & Bidding
-
-- **CPC:** High. $13.23 for single image ads vs. $2.29 for Thought Leader Ads.<sup>25</sup>
-- **CTR:** The benchmark for Sponsored Content is **0.44% - 0.65%**. Anything above 1% is exceptional.<sup>28</sup>
-- **Ad Format ROI:** Video ads have the lowest efficiency score (1.5), while TLAs have the highest (9.5).<sup>25</sup>
-
----
-
-## Section 6: Microsoft Ads & Copilot
-
-### 6.1 Performance Max & Copilot Integration
-
-Microsoft's PMax inventory now includes Copilot chat sessions. Ads displayed in Copilot chat have shown a **63% increase in conversion rates** compared to standard search ads.<sup>29</sup> This high intent makes Microsoft Ads a critical component of a holistic strategy.
-
-- **New Customer Acquisition:** Microsoft introduced a specific goal to "Target New Customers" in PMax (Beta in 2026). The tool should check if this setting is enabled for growth-focused accounts to ensure budget isn't wasted on retargeting.<sup>10</sup>
-- **Asset Imports:** Microsoft allows direct import of PMax campaigns from Google Ads. The tool should validate that asset group settings (especially URL options) transferred correctly, as these often break during import.<sup>10</sup>
-
----
-
-## Section 7: Cross-Platform Benchmarks 2026
-
-To provide actionable "Pass/Fail" grading in the *claude-ads* tool, we must establish baseline metrics. The following table aggregates data from multiple 2026 industry reports to serve as the standard for performance auditing.
-
-| Metric | E-Commerce | B2B SaaS | Legal | Finance | Healthcare | Local Services |
-|---|---|---|---|---|---|---|
-| **Google Search CTR** | 4.13% | 4.28% | 5.20% | 4.65% | 4.90% | 5.50% |
-| **Google Search CPC** | $1.15 | $4.50 | $750+ | $900+ | $40+ | $15 - $30 |
-| **Google Search CVR** | 2.81% | 1.65% | 4.60% | 3.50% | 3.10% | 15.0% |
-| **Meta Ads CTR** | 1.38% | 0.90% | 0.85% | 0.70% | 1.10% | 1.50% |
-| **Meta Ads CPM** | $12.50 | $35.00 | $45.00 | $50.00 | $28.00 | $18.00 |
-| **LinkedIn CPC** | N/A | $13.23 | $25.00 | $35.00 | N/A | N/A |
-| **LinkedIn CTR** | N/A | 0.56% | 0.45% | 0.40% | N/A | N/A |
-| **TikTok Ads CPM** | $3.21 | $8.00 | N/A | N/A | N/A | $5.00 |
-| **ROAS Benchmark** | 4.0x - 7.5x | N/A | 3.0x | 3.5x | 2.8x | 5.0x |
-
-Data Sources: <sup>16</sup>
-
-**Analysis of Benchmarks:**
-
-- **High-Cost Verticals:** The Legal and Finance sectors have decoupled from standard PPC economics, with CPCs exceeding $750 and even $900 for high-intent terms like "Life Insurance Quotes".<sup>31</sup> For these industries, the audit must focus on **Lead Quality** and **Offline Conversion Import (OCI)** rather than CPC efficiency. A $900 click is acceptable if the case value is $50,000.
-- **E-Commerce Efficiency:** Meta Ads maintain a high ROAS potential (7.5x) for e-commerce, driven by the efficiency of Advantage+ Shopping Campaigns (ASC).<sup>16</sup>
-- **SaaS Realities:** B2B SaaS faces high LinkedIn CPCs ($13.23), meaning conversion rates must be optimized heavily at the landing page level to make the economics work.
-
----
-
-## Section 8: The Universal Ad Account Audit Framework
-
-This framework defines the logic *claude-ads* will use to score accounts. It uses a weighted scoring system (Total Score: 100) to provide a single "health score" for any ad account.
-
-### 8.1 Category A: Conversion Data Hygiene (Weight: 25%)
-
-- **Check 1:** Are "Enhanced Conversions" enabled? (Pass/Fail).<sup>6</sup>
-- **Check 2:** Is Server-Side Tracking (CAPI/OCI) active? (Pass/Fail).<sup>33</sup>
-- **Check 3:** Are "Micro-Conversions" (e.g., Add to Cart, Time on Site) separated from "Primary Conversions" in bidding goals? (Pass/Fail). *Logic: Mixing these confuses the Smart Bidding algorithm.*
-- **Check 4:** Is the "New Customer" value rule applied? (Pass/Fail).<sup>7</sup>
-
-### 8.2 Category B: Account Structure & Bidding (Weight: 20%)
-
-- **Check 1:** Is Broad Match used *only* with Smart Bidding? (Pass/Fail). *Logic: Broad + Manual CPC = Fail.*
-- **Check 2:** Is the account utilizing Portfolio Bid Strategies? (Pass/Fail).<sup>33</sup> *Logic: Portfolios share data across campaigns, accelerating the learning phase.*
-- **Check 3:** Are there >5 active campaigns per funnel stage? (Pass/Fail). *Logic: Fragmentation dilutes data. Score down if True.*
-- **Check 4:** Are "Brand" and "Non-Brand" traffic separated? (Pass/Fail). *Logic: Essential for accurate ROAS measurement.*
-
-### 8.3 Category C: Creative Diversity & Health (Weight: 25%)
-
-- **Check 1:** (Meta) Does the account have >3 distinct creative formats (Static, Video, Carousel) active? (Pass/Fail).<sup>15</sup>
-- **Check 2:** (Google) Do PMax asset groups have vertical (9:16) video assets? (Pass/Fail).<sup>7</sup>
-- **Check 3:** Ad Strength Check: What % of ads are "Poor"? *Logic: If >10% = Fail.*
-- **Check 4:** Creative Fatigue: Are any active ads showing a CTR drop of >30% over the last 14 days? (Pass/Fail).
-
-### 8.4 Category D: Targeting & Exclusions (Weight: 15%)
-
-- **Check 1:** Are Account-Level Placement Exclusions applied? (Pass/Fail). *Logic: Must exclude "Games," "Apps," and known MFA (Made-For-Advertising) sites..*<sup>34</sup>
-- **Check 2:** Are Customer Match lists uploaded and refreshed in the last 30 days? (Pass/Fail).<sup>7</sup>
-- **Check 3:** (Meta) Is Advantage+ Audience enabled? (Pass/Fail).
-
-### 8.5 Category E: Landing Page Experience (Weight: 15%)
-
-- **Check 1:** Mobile Speed Score via PageSpeed Insights API. *Logic: If >2.0s LCP = Fail.*<sup>7</sup>
-- **Check 2:** Presence of valid Schema markup (Product, FAQ). (Pass/Fail).
-- **Check 3:** Consistency Check: Does the H1 tag match the Ad Headline? (Semantic Similarity Score).
-
----
-
-## Section 9: Industry-Specific Playbooks
-
-The *claude-ads* tool should apply different optimization logic based on the user's industry.
-
-### 9.1 B2B SaaS & High-Ticket Services
-
-- **Core Strategy:** The "SME Engine." Use LinkedIn Thought Leader Ads to distribute content from the Founder/CTO to build trust.
-- **Funnel Logic:**
-    - *TOFU:* Ungated value (video snippets, frameworks) via LinkedIn/Meta Video Views.
-    - *MOFU:* Conversation Ads or Lead Forms for "High-Intent" assets (calculators, audits).
-    - *BOFU:* Direct demo request retargeting on Google Search (Brand + Competitor keywords).
-- **Key Metric:** Pipeline ROI and Lead Quality (via Offline Conversion Import), *not* CPL.
-- **Optimization:** Bid aggressively on "Job Title" targeting in LinkedIn; use broad targeting restricted by "Business Interest" in Meta.<sup>26</sup>
-
-### 9.2 E-Commerce (DTC)
-
-- **Core Strategy:** The "Four Peaks" theory. Plan quarterly "peaks" (sales/events) to reset algorithmic fatigue and inject fresh data signals.<sup>15</sup>
-- **Funnel Logic:**
-    - *Acquisition:* PMax (Google) + Advantage+ Shopping (Meta) + TikTok Shop VSA. Consolidate budget into one "Hero" campaign per platform.
-    - *Retention:* Email/SMS (Klaviyo) + Customer Match retargeting for cross-sells.
-- **Key Metric:** MER (Marketing Efficiency Ratio) and POAS (Profit on Ad Spend).
-- **Optimization:** Test creative concepts in a separate campaign; graduate winners to the ASC campaign. Use "Cost Caps" to protect margins.<sup>16</sup>
-
-### 9.3 Local Services (Lead Gen)
-
-- **Core Strategy:** Trust & Proximity. Local Service Ads (LSA) + Google Maps Ads are critical for capturing high-intent, emergency queries.
-- **Funnel Logic:**
-    - *Capture:* Google LSA (Pay-per-lead). Ensure "Google Guaranteed" badge is active.
-    - *Retargeting:* Meta/YouTube ads geographically fenced to the service area + 5 miles.
-- **Key Metric:** Cost Per Booked Appointment.
-- **Optimization:** Dispute invalid leads in LSA dashboard weekly. Sync CRM to feed "Booked" status back to Google to train Smart Bidding.<sup>7</sup>
-
-### 9.4 Info Products & Webinars
-
-- **Core Strategy:** The "Selfie-Style" Authority. Heavy reliance on founder-led video content on Meta/YouTube to build personal connection.
-- **Funnel Logic:**
-    - *Ad:* Short-form video (pain point + solution hint) ->
-    - *Opt-in:* VSL (Video Sales Letter) or Webinar Registration ->
-    - *Conversion:* Low-ticket Tripwire ($27-$97) to liquidate ad spend -> High-ticket upsell.
-- **Optimization:** Monitor "Hook Rate" (3-second view) and "Hold Rate" (ThruPlay). If Hook Rate < 30%, rewrite the script intro.<sup>15</sup>
-
----
-
-## Section 10: API Engineering & Technical Implementation Guide
-
-This section outlines the specific technical requirements for the *claude-ads* CLI to interact with ad platforms safely and effectively.
-
-### 10.1 Rate Limiting & Throttling Logic
-
-To avoid IP bans or API suspensions, the tool must implement a **Token Bucket** algorithm for rate limiting.
-
-- **Google Ads API:**
-    - *Limit:* 15,000 operations/day (Basic Access).<sup>36</sup>
-    - *Strategy:* Batch Mutate operations. Group up to 5,000 changes into a single request envelope. Use partial\_failure=true to prevent one error from failing the entire batch.<sup>36</sup>
-- **Meta Marketing API:**
-    - *Limit:* Calculated based on ad spend and user tier (Standard vs. Advanced). Rolling 1-hour window.
-    - *Strategy:* Check header X-Business-Use-Case-Usage. If usage > 75%, pause requests for 5 minutes. Implement exponential backoff for error 613 (Rate Limit Reached).<sup>18</sup>
-- **TikTok Ads API:**
-    - *Limit:* 600 requests/minute for reporting endpoints.
-    - *Strategy:* Strict strict client-side throttling. If HTTP 429 is received, wait X seconds (where X is defined in the Retry-After header).<sup>24</sup>
-
-### 10.2 Authentication Best Practices
-
-- **Token Storage:** Never store Access Tokens in plain text. Use a secure vault (e.g., system keychain or encrypted local file).
-- **Refresh Logic:**
-    - *Google:* Use the Refresh Token to generate a short-lived Access Token (1 hour). Handle invalid\_grant errors (revoked access) by prompting the user to re-authenticate.
-    - *Meta:* Exchange short-lived User Tokens for Long-Lived Tokens (60 days). The tool should check token expiration on startup and warn the user if < 7 days remain.<sup>18</sup>
-
-### 10.3 Critical Endpoints for Auditing
-
-The *claude-ads* tool should query these specific endpoints to populate the audit report:
-
-| Platform | Goal | Endpoint / Service | Field / Metric |
-|---|---|---|---|
-| **Google** | Budget Analysis | CampaignBudgetService | recommended\_budget\_amount |
-| **Google** | Quality Score | KeywordView | quality\_score |
-| **Google** | Ad Strength | AdGroupAdService | ad\_strength |
-| **Meta** | Ad Quality | Insights | quality\_ranking, engagement\_rate\_ranking |
-| **Meta** | Creative Fatigue | Insights (Time Series) | ctr (compare last 7d vs last 30d) |
-| **TikTok** | Account Health | Account Health | is\_restricted, policy\_violations |
-| **LinkedIn** | Audience Quality | AdAnalytics | demographic\_metrics (Job Title/Function) |
-
-### 10.4 Automating Optimization (Write Operations)
-
-For the "Optimize" and "Generate" commands of the tool:
-
-- **Safe Mode:** All write operations (e.g., pausing ads, changing bids) should initially be "Dry Run" or require explicit user confirmation (y/n).
-- **Change History:** Log every change made by the tool to a local claude-ads.log file with timestamps and previous values. This enables a "Rollback" feature.
-- **Generative AI Integration:** When generating ad copy, use the platform's constraints (e.g., Google Headlines: 30 chars) as strict system prompts to the LLM to prevent API rejection errors.
-
----
-
-## Conclusion
-
-The 2026 advertising landscape demands a fundamental pivot from manual granularity to strategic orchestration. The "winners" in this era are not the best keyword miners, but the best *signal architects*--those who can feed clean, high-value data into the AI engines of Google, Meta, and TikTok.
-
-For *claude-ads*, the mission is clear: automate the technical hygiene (tracking, structure, exclusions) so the human marketer can focus on the only lever that still truly matters--**creative strategy and offer development**. By adhering to the audit frameworks and API standards outlined in this report, the tool will provide defensible, high-impact value to its users.
-
-**End of Report.**
-
----
-
-## Works Cited
-
-1. Google Privacy Sandbox Is Dead: What It Means For Your Brand, accessed February 10, 2026, [https://usercentrics.com/knowledge-hub/what-is-google-privacy-sandbox/](https://usercentrics.com/knowledge-hub/what-is-google-privacy-sandbox/)
-
-2. 7 Best Marketing Mix Modeling Software Tools of 2026 - Cometly, accessed February 10, 2026, [https://www.cometly.com/post/marketing-mix-modeling-software](https://www.cometly.com/post/marketing-mix-modeling-software)
-
-3. Meta Ads Updates 2025: What Actually Changed (and What You Need to Know for 2026), accessed February 10, 2026, [https://www.reddit.com/r/FacebookAds/comments/1pjt6i8/meta_ads_updates_2025_what_actually_changed_and/](https://www.reddit.com/r/FacebookAds/comments/1pjt6i8/meta_ads_updates_2025_what_actually_changed_and/)
-
-4. Meta Ads Updates: What Really Changed - Giovanni Perilli, accessed February 10, 2026, [https://giovanniperilli.com/en/blog/meta-ads-updates-what-really-changed-in-2025-and-how-to-prepare-for-2026/](https://giovanniperilli.com/en/blog/meta-ads-updates-what-really-changed-in-2025-and-how-to-prepare-for-2026/)
-
-5. Meta Conversions API: 2026 guide - DinMo, accessed February 10, 2026, [https://www.dinmo.com/third-party-cookies/solutions/conversions-api/meta-ads/](https://www.dinmo.com/third-party-cookies/solutions/conversions-api/meta-ads/)
-
-6. What's New in Google Ads for 2026 - MentorCruise, accessed February 10, 2026, [https://mentorcruise.com/blog/whats-new-in-google-ads-for-2026-96017/](https://mentorcruise.com/blog/whats-new-in-google-ads-for-2026-96017/)
-
-7. Google Ads Best Practices Every Marketer Should Know (2026 Guide), accessed February 10, 2026, [https://twominutereports.com/blog/google-ads-best-practices](https://twominutereports.com/blog/google-ads-best-practices)
-
-8. The Future of Google Ads Keywords: 6 Experts Weigh In - WordStream, accessed February 10, 2026, [https://www.wordstream.com/blog/2025-google-ads-keywords](https://www.wordstream.com/blog/2025-google-ads-keywords)
-
-9. Key Google Ads Trends & Predictions for 2026 | WordStream, accessed February 10, 2026, [https://www.wordstream.com/blog/2026-google-ads-trends](https://www.wordstream.com/blog/2026-google-ads-trends)
-
-10. January 2026 product updates | Microsoft Advertising, accessed February 10, 2026, [https://about.ads.microsoft.com/en/blog/post/january-2026/performance-max-updates-and-other-product-news-for-january-2026](https://about.ads.microsoft.com/en/blog/post/january-2026/performance-max-updates-and-other-product-news-for-january-2026)
-
-11. Understanding AdRank and Quality Score | Website.com, accessed February 10, 2026, [https://www.website.com/website-builder-and-web-design/understanding-adrank-and-quality-score](https://www.website.com/website-builder-and-web-design/understanding-adrank-and-quality-score)
-
-12. Google Ads Quality Score: How To Use it in 2026 - Store Growers, accessed February 10, 2026, [https://www.storegrowers.com/google-ads-quality-score/](https://www.storegrowers.com/google-ads-quality-score/)
-
-13. Announcing v23 of the Google Ads API, accessed February 10, 2026, [http://ads-developers.googleblog.com/2026/01/announcing-v23-of-google-ads-api.html](http://ads-developers.googleblog.com/2026/01/announcing-v23-of-google-ads-api.html)
-
-14. About Ad strength for responsive search ads - Google Help, accessed February 10, 2026, [https://support.google.com/google-ads/answer/9921843?hl=en](https://support.google.com/google-ads/answer/9921843?hl=en)
-
-15. Meta Ads Best Practices to Follow in 2026 - Flighted, accessed February 10, 2026, [https://www.flighted.co/blog/meta-ads-best-practices](https://www.flighted.co/blog/meta-ads-best-practices)
-
-16. Meta Ads Benchmarks 2026 | Enrich Labs, accessed February 10, 2026, [https://www.enrichlabs.ai/blog/meta-ads-benchmarks-2025](https://www.enrichlabs.ai/blog/meta-ads-benchmarks-2025)
-
-17. Meta Announces Updates for the Instagram Marketing API | Social Media Today, accessed February 10, 2026, [https://www.socialmediatoday.com/news/meta-announces-updates-for-the-instagram-marketing-api/807083/](https://www.socialmediatoday.com/news/meta-announces-updates-for-the-instagram-marketing-api/807083/)
-
-18. Meta Ads API: Complete Guide for Advertisers and Developers (2025) | AdManage.ai Blog, accessed February 10, 2026, [https://admanage.ai/blog/meta-ads-api](https://admanage.ai/blog/meta-ads-api)
-
-19. Meta Event Match Quality Score Explained - Conversion Tracking Specialist, accessed February 10, 2026, [https://conversiontracking.io/blog/facebook-meta-event-match-quality-score](https://conversiontracking.io/blog/facebook-meta-event-match-quality-score)
-
-20. TikTok's 5 best practices for Search ads - The Thread - Gupta Media, accessed February 10, 2026, [https://thread.guptamedia.com/p/tiktok-5-best-practices-for-search-ads](https://thread.guptamedia.com/p/tiktok-5-best-practices-for-search-ads)
-
-21. Best practices for Smart+ Web Campaigns - TikTok For Business, accessed February 10, 2026, [https://ads.tiktok.com/help/article/best-practices-for-smart-plus-web-campaigns](https://ads.tiktok.com/help/article/best-practices-for-smart-plus-web-campaigns)
-
-22. About Smart+ Campaigns | TikTok Ads Manager, accessed February 10, 2026, [https://ads.tiktok.com/help/article/about-smart-plus-campaign?lang=en](https://ads.tiktok.com/help/article/about-smart-plus-campaign?lang=en)
-
-23. Complete TikTok Ads Guide 2026 | $37B Opportunity - ALM Corp, accessed February 10, 2026, [https://almcorp.com/blog/tiktok-ads-guide-2026-creator-economy-opportunity/](https://almcorp.com/blog/tiktok-ads-guide-2026-creator-economy-opportunity/)
-
-24. Understanding TikTok API Rate Limits - TikTok for Developers, accessed February 10, 2026, [https://developers.tiktok.com/doc/tiktok-api-v2-rate-limit?enter_method=left_navigation](https://developers.tiktok.com/doc/tiktok-api-v2-rate-limit?enter_method=left_navigation)
-
-25. LinkedIn Thought Leader Ads: The Ultimate Guide for 2026 - ZenABM, accessed February 10, 2026, [https://zenabm.com/blog/linkedin-thought-leader-ads-ultimate-guide](https://zenabm.com/blog/linkedin-thought-leader-ads-ultimate-guide)
-
-26. LinkedIn Thought Leadership Ads Strategy | B2B Marketing 2026, accessed February 10, 2026, [https://impactable.com/the-ultimate-linkedin-thought-leadership-ads-strategy-for-b2b-marketers-2025/](https://impactable.com/the-ultimate-linkedin-thought-leadership-ads-strategy-for-b2b-marketers-2025/)
-
-27. Linkedin Ad Benchmarks 2026 - An Always Up-to-date Guide ..., accessed February 10, 2026, [https://www.theb2bhouse.com/linkedin-ad-benchmarks/](https://www.theb2bhouse.com/linkedin-ad-benchmarks/)
-
-28. 12 LinkedIn ad stats you need to know for 2026 | Lever Digital, accessed February 10, 2026, [https://www.leverdigital.co.uk/post/12-linkedin-ad-stats-you-need-to-know](https://www.leverdigital.co.uk/post/12-linkedin-ad-stats-you-need-to-know)
-
-29. Performance Max updates and other updates for October - Microsoft Advertising, accessed February 10, 2026, [https://about.ads.microsoft.com/en/blog/post/october-2024/performance-max-updates-and-other-updates-for-october](https://about.ads.microsoft.com/en/blog/post/october-2024/performance-max-updates-and-other-updates-for-october)
-
-30. Google Ads benchmarks by industry in 2026 - Usermaven, accessed February 10, 2026, [https://usermaven.com/blog/google-ads-benchmarks](https://usermaven.com/blog/google-ads-benchmarks)
-
-31. 2026 PPC Benchmarks: CPL, CPC, ROAS, and More by Industry, accessed February 10, 2026, [https://www.webfx.com/blog/marketing/ppc-benchmarks-to-know/](https://www.webfx.com/blog/marketing/ppc-benchmarks-to-know/)
-
-32. Top 8 Advertising Benchmarks for SaaS in 2026 | Lever Digital, accessed February 10, 2026, [https://www.leverdigital.co.uk/post/top-10-advertising-benchmarks-for-saas](https://www.leverdigital.co.uk/post/top-10-advertising-benchmarks-for-saas)
-
-33. Google Ads 2026 Strategy & Automation for Better Performance, accessed February 10, 2026, [https://www.rebid.co/google-ads-2026-account-structure-automation/](https://www.rebid.co/google-ads-2026-account-structure-automation/)
-
-34. Google Ads Account-Level Placement Exclusions: Complete 2026 ..., accessed February 10, 2026, [https://almcorp.com/blog/google-ads-account-level-placement-exclusions-guide/](https://almcorp.com/blog/google-ads-account-level-placement-exclusions-guide/)
-
-35. The Local Service Ads Playbook: A No-Nonsense Guide to Google's Pay-Per-Lead Model (Updated for... - Medium, accessed February 10, 2026, [https://medium.com/@SEQ_Den/the-local-service-ads-playbook-a-no-nonsense-guide-to-googles-pay-per-lead-model-updated-for-beb8e431ce57](https://medium.com/@SEQ_Den/the-local-service-ads-playbook-a-no-nonsense-guide-to-googles-pay-per-lead-model-updated-for-beb8e431ce57)
-
-36. Access levels and RMF | Google Ads API | Google for Developers, accessed February 10, 2026, [https://developers.google.com/google-ads/api/docs/productionize/access-levels](https://developers.google.com/google-ads/api/docs/productionize/access-levels)

package/src/core/profiles/COMPARISON.md

@@ -1,170 +0,0 @@
-# IDE Capability Comparison Matrix
-
-Complete comparison of all supported IDEs. Profiles at `/packages/cli/src/core/profiles/`.
-
-## Core Capabilities
-
-| Capability | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **File Operations** | ✅ Native tools | ✅ read_file, edit_file | ✅ Native | ⚠️ Via skills |
-| **Shell Execution** | ✅ Bash tool | ✅ run_terminal_cmd | ✅ run_command | ⚠️ Via sandbox |
-| **File Search** | ✅ Glob, Grep | ✅ codebase_search, grep_search | ✅ search_files, search_codebase | ⚠️ Via sandbox |
-| **Interactive Input** | ✅ Structured (AskUserQuestion) | ⚠️ Conversational | ⚠️ Conversational | ⚠️ Text-only |
-| **Sub-Agents** | ✅ Task tool | ✅ Async native agents | ⚠️ Cascades + chaining | ❌ Cannot nest |
-| **Nested Sub-Agents** | ✅ Full nesting | ✅ Full nesting | ❌ Parallel only | ❌ None |
-
-## Planning & Execution
-
-| Capability | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **Plan Mode** | ✅ EnterPlanMode/ExitPlanMode | ✅ Native | ✅ Native + "megaplan" | ❌ None |
-| **Plan Editing** | ✅ User can edit | ✅ User can edit | ✅ User can edit | N/A |
-| **Persistent Plans** | ✅ Yes | ✅ Yes | ✅ ~/.windsurf/plans/ | N/A |
-
-## Lifecycle & Hooks
-
-| Hook Event | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **SessionStart** | ✅ | ❌ | ❌ | ❌ |
-| **PreToolUse** | ✅ | ❌ | ❌ | ❌ |
-| **PostToolUse** | ✅ | ❌ | ❌ | ❌ |
-| **beforeSubmitPrompt** | ❌ | ✅ | ❌ | ❌ |
-| **beforeShellExecution** | ❌ | ✅ | ❌ | ❌ |
-| **beforeMCPExecution** | ❌ | ✅ | ❌ | ❌ |
-| **beforeReadFile** | ❌ | ✅ | ❌ | ❌ |
-| **afterFileEdit** | ❌ | ✅ | ❌ | ❌ |
-| **pre_read_code** | ❌ | ❌ | ✅ | ❌ |
-| **post_read_code** | ❌ | ❌ | ✅ | ❌ |
-| **pre_write_code** | ❌ | ❌ | ✅ | ❌ |
-| **post_write_code** | ❌ | ❌ | ✅ | ❌ |
-| **pre_run_command** | ❌ | ❌ | ✅ | ❌ |
-| **post_run_command** | ❌ | ❌ | ✅ | ❌ |
-| **pre_mcp_tool_use** | ❌ | ❌ | ✅ | ❌ |
-| **post_mcp_tool_use** | ❌ | ❌ | ✅ | ❌ |
-| **pre_user_prompt** | ❌ | ❌ | ✅ | ❌ |
-| **post_cascade_response** | ❌ | ❌ | ✅ | ❌ |
-| **post_setup_worktree** | ❌ | ❌ | ✅ | ❌ |
-| **Total Hook Events** | 5 | 6 | 11 | 0 |
-
-**Status**: SessionStart, PreToolUse, PostToolUse (Claude Code); beforeSubmitPrompt, beforeShellExecution, beforeMCPExecution, beforeReadFile, afterFileEdit (Cursor); stop hook (all IDEs)
-
-## External Integration
-
-| Capability | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **Web Search** | ✅ WebSearch | ✅ web_search + @web | ✅ web_search | ❌ |
-| **Web Fetch** | ✅ WebFetch | ✅ @web + MCP | ✅ url_read, view_chunk | ❌ |
-| **MCP Support** | ✅ Full | ✅ Full | ✅ Full | ✅ Extension |
-| **MCP Tool Cap** | **0 (unlimited)** | **40** | **100** | **0 (unlimited)** |
-| **Browser** | ✅ Playwright MCP | ✅ Native browser (v2.0+) | ✅ Browser Preview | ⚠️ Limited |
-
-## Collaboration & Tracking
-
-| Capability | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **Task Tracking** | ✅ TaskCreate/Update/List | ❌ Plan checklists only | ❌ Conversation-embedded | ❌ None |
-| **Persistent Tasks** | ✅ Yes | ❌ | ❌ | ❌ |
-| **Git Worktrees** | ✅ EnterWorktree | ⚠️ Background agents use branches | ✅ Native (up to 20) | ⚠️ Manual |
-| **Parallel Execution** | ⚠️ Sequential Tasks | ✅ Async subagents | ✅ @cascade worktrees | ❌ |
-
-## Configuration Paths
-
-| Item | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **Config Dir** | `.claude/` | `.cursor/` | `.windsurf/` | `.codex/` |
-| **Commands** | `.claude/commands/agileflow/` | `.cursor/commands/` | `.windsurf/workflows/` | N/A |
-| **Agents** | `.claude/agents/agileflow/` | `.cursor/agents/` | N/A (use workflows) | N/A |
-| **Skills** | `.claude/skills/` | N/A (use agents) | `.windsurf/skills/*/` | `.codex/skills/agileflow-*/` |
-| **Rules** | N/A | `.cursor/rules/` (MDC) | `.windsurf/rules/` | N/A |
-| **Hooks Config** | `.claude/settings.json` | `.cursor/hooks.json` | `.windsurf/hooks.json` | N/A |
-| **MCP Config** | `.claude/settings.json` | `.cursor/mcp.json` | `~/.codeium/windsurf/mcp_config.json` | N/A |
-| **Instructions** | `CLAUDE.md` | `CURSOR.md` | `WINDSURF.md` | `AGENTS.md` |
-
-## Limits & Constraints
-
-| Constraint | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **Max File Size** | Unlimited | Unlimited | Unlimited | Unlimited |
-| **Max Command Length** | Unlimited | Unlimited | Unlimited | Unlimited |
-| **Workflow Size** | N/A | N/A | **12,000 chars** | N/A |
-| **MCP Tools** | 0 (unlimited) | **40** | 100 | 0 (unlimited) |
-| **Git Worktrees** | Via tool | Via branches | Up to 20 | Manual |
-| **Parallel Agents** | Sequential | Unlimited | Via @cascade | No nesting |
-
-**Key constraint**: Cursor's 40-tool MCP limit is the binding constraint for multi-IDE installations.
-
-## AgileFlow Feature Support
-
-| Feature | Claude Code | Cursor | Windsurf | Codex |
-|---|---|---|---|---|
-| **/agileflow:babysit** | ✅ Full | ⚠️ Conversational input | ⚠️ Conversational input | ❌ Limited |
-| **AskUserQuestion** | ✅ Structured menus | ❌ Fallback to text | ❌ Fallback to text | ✅ Text-only |
-| **Task delegation** | ✅ Task tool | ✅ Async agents | ⚠️ Workflow chaining | ❌ Skill suggestions |
-| **Plan mode hooks** | ✅ Full integration | ✅ Native mode | ✅ Native mode | ❌ None |
-| **Sub-agent nesting** | ✅ Full support | ✅ Full support | ⚠️ Parallel only | ❌ None |
-| **Persistent task list** | ✅ Yes | ❌ | ❌ | ❌ |
-| **Async execution** | ❌ Sequential | ✅ Native | ⚠️ @cascade | ❌ |
-
-## Implementation Notes
-
-### Claude Code
-- **Recommended target** for new AgileFlow features
-- All capabilities validated here first
-- Full support for structured user interaction
-- No tool limits for multi-IDE deployments
-
-### Cursor
-- **Fast-follower to Claude Code** (v2.5 Feb 2026)
-- Async native agents eliminate need for Task tool
-- 40-tool MCP cap is **binding constraint** for all IDEs
-- No AskUserQuestion - replace with numbered text prompts
-- Plan mode fully native (no enter/exit needed)
-
-### Windsurf
-- **Most hook events** (11 total) but most restrictive
-- **No true sub-agent spawning** - use workflow chaining or @cascade
-- **12,000 char limit per workflow** - must split large commands
-- **Global MCP config only** - no project-level customization
-- Native worktrees (up to 20)
-- Browser preview built-in to IDE
-
-### Codex
-- **Most restrictive** - use as minimum baseline
-- Skills cannot spawn other skills (no delegation)
-- No plan mode, hooks, or task tracking
-- Text-only user input
-- Best for linear workflows only
-
-## Multi-IDE Deployment Strategy
-
-**Canonical source**: Claude Code format
-**Generation**: Read IDE profile → Transform to IDE-native format
-**MCP constraint**: Cap at 40 tools (Cursor's limit) for consistency
-
-**Fallback order when feature unavailable**:
-1. Use native IDE equivalent (if exists)
-2. Replace with text-based alternative
-3. Document limitation in profile
-
-**Example - AskUserQuestion replacement**:
-```
-Claude Code:
-  AskUserQuestion(options=[{label: "Yes"}, {label: "No"}])
-
-Cursor/Windsurf:
-  Would you like to continue? (Type "Yes" or "No")
-
-Codex:
-  Please choose:
-  1. Yes
-  2. No
-```
-
-## Version Support
-
-- **Claude Code**: Latest (no version pinning)
-- **Cursor**: v2.5+ (Feb 2026)
-- **Windsurf**: Wave 13+ (native worktrees, 11 hooks)
-- **Codex**: Latest (limited feature set)
-
-Last updated: 2026-02-20 | Source: Cross-IDE Compatibility Findings