executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
suede-competitorsSuede-owned comparison-page discipline for accurate, evidence-backed alternative, versus, and competitor-comparison content that wins evaluators and search intent. Use when planning or writing a public page that positions products against named alternatives from verified evidence. NOT FOR: gathering the underlying competitor evidence (use suede-competitor-p…
Independent GitHub snapshot · Automated classification · Original documentation governs
Use this Suede comparison-page playbook to serve competitive search intent while keeping every product claim current, sourced, and fair.
Check for .agents/product-marketing.md (or .claude/product-marketing.md, or the legacy product-marketing-context.md) and read it if present: your value proposition, ICP, pricing model, differentiators, and proof decide which comparisons you can win on the evidence, and they are usually already written down there.
Then work the intake list under Task-Specific Questions below; ask only what the context file did not already answer. Current competitor evidence, pricing, features, ratings, comes from suede-competitor-profiling, not from memory.
Search intent: User is actively looking to switch from a specific competitor
URL pattern: /alternatives/[competitor] or /[competitor]-alternative
Target keywords: "[Competitor] alternative", "alternative to [Competitor]", "switch from [Competitor]"
Page structure:
Search intent: User is researching options, earlier in journey
URL pattern: /alternatives/[competitor]-alternatives
Target keywords: "[Competitor] alternatives", "best [Competitor] alternatives", "tools like [Competitor]"
Page structure:
Important: Include 4-7 real alternatives. Being genuinely helpful builds trust and ranks better.
AI-answer expectations by stage: these pages can earn citations in AI answers, but whether AI recommends your brand from them also depends on offsite consensus (reviews, forums, analysts). For emerging brands, a self-ranked list may surface competitors while the brand receives only a citation. Treat that as a hypothesis and route current visibility evidence and claim validation to suede-seo-audit.
Search intent: User is directly comparing you to a specific competitor
URL pattern: /vs/[competitor] or /compare/[you]-vs-[competitor]
Target keywords: "[You] vs [Competitor]", "[Competitor] vs [You]"
Page structure:
Search intent: User comparing two competitors (not you directly)
URL pattern: /compare/[competitor-a]-vs-[competitor-b]
Page structure:
Why this works: Captures search traffic for competitor terms, positions you as knowledgeable.
A comparison page written on autopilot arrives with these already in it. Each one tells an evaluator the page is marketing, not research, refuse them by name:
For the two remaining defaults, the ✓/✗ feature table and a migration section with no real friction, use the concrete before/after in references/templates.md: "Comparison Table Best Practices" and "Migration Section".
Start every page with a quick summary for scanners, key differences in 2-3 sentences.
Go beyond tables. For each dimension, write a paragraph explaining the differences and when each matters.
For each category: describe how each handles it, cite the competitor's documented limitations with sources, and state the specific advantage your product delivers.
Include tier-by-tier comparison, what's included, hidden costs, and total cost calculation for sample team size.
Name the reader your product is built for and the outcome they get: the use case, the team, the workflow, and the result. Specific beats broad, and a sourced outcome beats an adjective.
Keep material facts in plain view where they decide the purchase: price, plan limits, platform requirements, and migration effort. State them directly in the pricing, FAQ, and migration sections rather than as caveats on the pitch.
Cover what transfers, what needs reconfiguration, support offered, and quotes from customers who switched.
For detailed templates: See references/templates.md
Create a single source of truth for each competitor with:
For data structure and examples: See references/content-architecture.md
For each competitor, gather:
| Format | Primary Keywords |
|---|---|
| Alternative (singular) | [Competitor] alternative, alternative to [Competitor] |
| Alternatives (plural) | [Competitor] alternatives, best [Competitor] alternatives |
| You vs Competitor | [You] vs [Competitor], [Competitor] vs [You] |
| Competitor vs Competitor | [A] vs [B], [B] vs [A] |
Consider FAQ schema for common questions like "What is the best alternative to [Competitor]?"
Boundaries below requires a final claim review before any comparison page ships. This is that review, run it as a second pass over the finished draft, not while drafting:
suede-seo-audit.Three deliverables, all with their schemas in the references: do not invent a shape for them:
suede-competitor-profiling.suede-customer-research.suede-programmatic-seo.suede-copy or suede-seo-audit.suede-sales-enablement.suede-competitors.