/arn-spark-stress-competitive

name: arn-spark-stress-competitive
description: >-
  This skill should be used when the user says "competitive analysis",
  "gap analysis", "competitive gap", "stress competitive", "compare competitors",
  "feature comparison", "competitive stress test", "market comparison",
  "competitor analysis", or wants to stress-test a product concept by conducting
  deep competitive gap analysis with feature comparison, gap identification, and
  positioning assessment. Produces a competitive report with a feature matrix,
  per-competitor analysis, and recommended concept updates.
version: 1.0.0

Arness Spark Stress Competitive

Stress-test a product concept through deep competitive gap analysis. This skill goes beyond surface-level feature comparison to identify where the product is uniquely strong, where competitors have real advantages, and where the market has gaps that no one is filling.

The process works in three stages: 1. **Deep research:** The market researcher agent conducts thorough competitive intelligence in deep-analysis mode, going beyond the competitors identified during discovery 2. **Gap analysis:** Features are categorized (core, differentiating, table-stakes), compared across competitors, and gaps are weighted against the product's own pillars 3. **Positioning assessment:** The product's market position is evaluated for defensibility, switching costs, and crowded vs. underserved areas

The product concept is read but never modified -- all recommendations are captured in the competitive report for later review.

Prerequisites

Configuration Check

1. Read the project's `CLAUDE.md` and check for a `## Arness` section 2. If found, extract the configured **Vision directory** and **Reports directory** paths 3. If no `## Arness` section exists or Arness Spark fields are missing, inform the user: "Arness Spark is not configured for this project yet. Run `/arn-brainstorming` to get started — it will set everything up automatically." Do not proceed without it. 4. If the Reports directory does not exist, create it with `mkdir -p <reports-dir>/stress-tests/`

Data Availability

| Artifact | Status | Location | Fallback | |----------|--------|----------|----------| | Product concept | REQUIRED | `<vision-dir>/product-concept.md` | Cannot proceed without it -- suggest running `/arn-spark-discover` | | Competitive landscape | REQUIRED | Competitive Landscape section of product concept | Fallback cascade below | | Product pillars | ENRICHES | Product Pillars section of product concept | Gap weighting is less targeted but analysis proceeds | | Core experience | ENRICHES | Core Experience section of product concept | Feature identification is less complete |

**Competitive landscape fallback cascade:**

If the product concept exists but the Competitive Landscape section is missing, contains "Not explored" sentinel, or lists zero competitors:

Ask (using `AskUserQuestion`): **"The product concept does not include a competitive landscape, which is needed to identify competitors for analysis. How would you like to proceed?"** 1. Run `/arn-spark-discover` to conduct competitive research through product discovery 2. Name 3-5 competitors now (I will research them in depth) 3. Skip the competitive stress test

If the user chooses option 2, collect competitor names and proceed to the workflow using those as the initial competitor list.

Workflow

Step 1: Load References

Load the gap analysis framework and report template: > Read `${CLAUDE_PLUGIN_ROOT}/skills/arn-spark-stress-competitive/references/gap-analysis-framework.md` > Read `${CLAUDE_PLUGIN_ROOT}/skills/arn-spark-stress-competitive/references/competitive-report-template.md`

Step 2: Read Product Concept and Extract Competitor List

Read the product concept from `<vision-dir>/product-concept.md`. Extract:

• Product vision and core experience (for feature identification)
• Product pillars (for gap weighting)
• Competitive landscape section (primary competitors + extended landscape)
• Scope boundaries (to identify planned vs. unplanned features)

Build the initial competitor list from the competitive landscape section of the product concept (look for the primary/focus competitors subsection). Include extended landscape candidates if the primary list has fewer than 3 entries.

Step 3: Deep Competitive Research

Invoke the `arn-spark-market-researcher` agent in **deep-analysis mode** via the Task tool, passing the model from `.arness/agent-models/spark.md` as the `model` parameter (see `plugins/arn-spark/skills/arn-spark-ensure-config/references/ensure-config.md` "Dispatch convention" for fallback). Context:

--- PRODUCT CONCEPT (relevant sections) --- [Extract and pass: Vision, Core Experience, Product Pillars, Competitive Landscape, Scope Boundaries, Target Platforms. Do not pass the full document — focus on sections relevant to competitive analysis.] --- END PRODUCT CONCEPT ---

--- COMPETITOR LIST --- [extracted competitor names and descriptions from product concept] --- END COMPETITOR LIST ---

--- RESEARCH TASK --- Deep-analysis mode: For each competitor, research: 1. Full feature inventory (from documentation, feature pages, changelogs, user reviews) 2. Pricing model and tiers 3. Target audience and market positioning 4. Known strengths and weaknesses (from user reviews, comparison articles, community feedback) 5. Recent developments (launches, pivots, acquisitions in the last 12 months)

Also identify any competitors NOT in the provided list that should be analyzed -- look for new entrants, adjacent products expanding into this space, and open-source alternatives. --- END RESEARCH TASK ---

Step 4: Build Feature Comparison Matrix

Using the gap analysis framework:

1. **Identify features:** Extract all features from the product concept's Core Experience. Research competitor features. Create a unified feature list by combining both sources and deduplicating any feature present across multiple products.