Skip to content

docs(roadmap): refresh the competitive benchmark and correct the AI-gap premise - #1284

Merged
KaelSensei merged 2 commits into
devfrom
chore/docs/competitive-benchmark-20261107
Nov 8, 2026
Merged

KaelSensei merged 2 commits into
devfrom
chore/docs/competitive-benchmark-20261107

Conversation

@KaelSensei

Copy link
Copy Markdown
Owner

Why

The competitive benchmark in docs/product/roadmap.md was dated 2026-09-19 and covered three competitors. docs/product/competitive-landscape.md still dated from March 2026 and carried the strategic premise that no platform had shipped LLM-powered Commander deckbuilding. That premise is no longer true, and the roadmap was being read against it.

Several upstream contracts we already depend on also changed during 2026 without the docs recording it.

What changed

The AI gap closed — premise corrected

Verified against the products' own pages on 2026-11-07:

Tool Ships Notable
ManaTap (manatap.ai) Collection-aware AI chat, "AI Workshop", Deck Checker, deterministic legality + colour-identity validation, budget swaps, deck compare Free tier; Pro ~$12.99/mo
Farseek (farseek.ai) Claude-backed assistant arguing why a card fits, live Scryfall lookups per recommendation, bracket + persistent budget constraints States no deterministic legality validation
MTG Master (mtgmaster.app) Bracket-aware and collection-aware 100-card generation enforcing commander legality, colour identity, singleton Free + Pro credits
ManaForge (manaforge.tools) Build-from-collection, commander swaps, live ban-list re-validation, Arena wildcard awareness From ~€9.99/mo
Long tail mtg-agents, aidecktutor, onemoredeck (Gemini), counterdeck, edhgen, krakenthemeta (live meta search) Mostly free

"AI-powered" is now table stakes with a free tier. The three claims that remain ours are already initiatives, not new bets: the LLM never decides legality (I-02), evidence the player produced themselves (I-07, I-09), and printing-level ownership and acquisition (I-06). Positioning emphasis moves from "AI builds your deck" to "AI you can check".

Checked and rejected: search results suggested EDHREC had shipped an AI deck chat. Fetching the source shows EDHREChat was an April Fools page from 2023-04-01, taken offline on 2023-04-04. It is recorded as such rather than as a competitor feature.

Upstream contract changes now recorded

  • EDHREC replaced Synergy with Lift on /commanders, /combos and /tags (2026-10-01). Lift is a ratio centred on 1, not a percentage centred on 0 — any surface treating it as a percentage or ranking by it needs rechecking (I-09).
  • Moxfield has no public API and answers programmatic requests behind Cloudflare with auth headers on its internal endpoints; other tools moved to paste/CSV. Our URL import is now documented as a brittle path needing an explicit fallback (I-10).
  • Scryfall tightened per-endpoint limits and moved bulk data to gzipped JSONL. Our client sends User-Agent/Accept and serialises behind a 100 ms mutex — fine for a 10 req/s sustained ceiling, not for a stricter per-endpoint search limit. Flagged for human confirmation because scryfall.com blocks automated fetching (I-05).
  • Commander Spellbook v0.84.0 (2026-10-20) added per-deck and per-card combo endpoints (I-09).
  • Commander Brackets remain beta, 53 Game Changers unchanged since 2026-02-09 — the list should be dated data, not code (I-03).

Competitor capabilities absorbed as scope

Eight new open scopes, mapped to existing initiatives: Lift semantics + Spellbook endpoint re-check (I-09), Moxfield import brittleness (I-10), Scryfall policy confirmation (I-05), vendor/category/price-band cost breakdown and explicit proxy state (I-06), visible validator verdict (I-02), dated Game Changers data (I-03).

Five non-goals added, including: do not follow the AI builders into tournament management, custom-card creation, Arena wildcard optimization or camera scanning; and do not compete on generation volume or free-tier generosity.

Scope discipline

Documentation only — two Markdown files, no source changes. Per CLAUDE.md this is a dedicated chore/docs PR because docs/product/roadmap.md must not be touched on a feature branch. No roadmap item was marked complete; the revision only adds scope and corrects dated claims.

docs/project/changelog.md and docs/project/progress.md are untouched.

Verification

  • npx prettier --check on both files
  • npx tsc --noEmit
  • pnpm lint
  • pnpm test

The three code gates cannot be affected by a Markdown-only diff; they are run to satisfy the mandatory pre-PR gate.

Caveats for review

Competitor rows are built from each product's own public pages. Marketing copy is a claim, not evidence — the benchmark says so explicitly, and each row should be confirmed before it justifies implementation. Sections 2, 6, 7, 8 and 9 of competitive-landscape.md still date from March 2026 and are now marked unverified rather than silently presented as current.

E2E gate

SKIP_E2E=1 was used for the push: Docker is unavailable in the environment this branch was prepared in, and the diff is Markdown only, so the Playwright suite has nothing to exercise. The three code gates were run in full.

Note for a separate PR: src/components/deck/ExternalRecommendationFreshness.test.tsx:17 and src/components/deck/AISuggestionsPanel.provenance.test.tsx:57 both assert "Observed: Nov 2, 2026, 10:30 AM" for a UTC instant, so they only pass when the machine runs in UTC. TZ=UTC pnpm test gives 3505/3505; without it, those two fail on any developer machine outside UTC. Not fixed here to keep this PR documentation-only.

🤖 Generated with Claude Code

…ap premise

The benchmark was dated 2026-09-19 and covered three competitors, while
competitive-landscape.md still carried its March 2026 premise that no
platform had shipped LLM-powered Commander deckbuilding. Several have:
ManaTap, Farseek, MTG Master, ManaForge and a long tail of smaller sites,
most with a free entry tier. The roadmap was being read against a claim
that no longer holds.

Record what is still defensible instead: the LLM never decides legality
(I-02), evidence the player produced themselves (I-07, I-09) and
printing-level ownership (I-06). Each is already an initiative, so the
delivery order does not change.

Also record four upstream contract changes that affect shipped
integrations: EDHREC replaced Synergy with Lift on 2026-10-01 (a ratio
centred on 1, not a percentage), Moxfield now answers programmatic
requests behind Cloudflare, Scryfall moved bulk data to gzipped JSONL
and tightened per-endpoint limits, and Commander Spellbook v0.84.0 added
per-deck and per-card combo endpoints.

Search results claimed EDHREC had shipped an AI deck chat. The source
shows EDHREChat was an April Fools page from 2023, offline since
2023-04-04; it is recorded as such rather than as a competitor feature.

Adds eight open scopes and five non-goals. No roadmap item is marked
complete.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 7, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
magic-ai-builder Ready Ready Preview Nov 8, 2026 11:08am UTC

@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-07T22:52:59.394396Z
We couldn’t complete this review. Comment @codex review to try again.
c2c7f36 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Nov 7, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 935e5ee0-cf9b-4835-be19-fc32ad62ab85

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

dev gained its own competitive revision (#1289) while this branch was open,
rewriting the same two documents. Rather than interleave two rewrites, the
conflicting sections are resolved in favour of dev: its benchmark table maps
each competitor to an initiative, it introduces I-14 and I-16 through I-21,
and it centralises sources and prices in competitive-landscape.md.

All eight scope items from this branch survived outside the conflict zones and
are kept. Re-added on top of dev's structure, because dev did not carry them:

- ManaTap, MTG Master and ManaForge, the three AI builders dev's section 4
  omits, with what each ships and what none of them does.
- The EDHREChat correction: it was an April Fools page from 2023, not an
  EDHREC AI product.
- The two upstream contract changes that affect shipped integrations —
  Scryfall's gzipped JSONL bulk format and tighter per-endpoint limits, and
  Commander Spellbook v0.84.0's per-deck and per-card combo endpoints.
- Two non-goals: do not follow the AI builders into tournament management,
  custom cards, Arena wildcards or scanning, and do not compete on generation
  volume or free-tier generosity.

Verified on the merged tree: tsc clean, lint clean, 3509 tests passing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@sonarqubecloud

sonarqubecloud Bot commented Nov 8, 2026

Copy link
Copy Markdown

@KaelSensei
KaelSensei merged commit 9aa27d3 into dev Nov 8, 2026
7 checks passed

This branch was successfully deployed

1 active deployment
Preview — 3d7fd91b Deployed Nov 8, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant