modern-web-browser-compatibility-baseline-awareness

id	modern-web-browser-compat
name	Modern Web Browser Compatibility + Baseline Awareness
description	新しい Web API / CSS の利用追加に対し、Baseline 状態とブラウザ互換性 / progressive enhancement の有無を suggestion で示す。
version	0.1.0
category	midstream
phase	midstream
applyTo	["src/**/*.{ts,tsx,js,jsx,html,css}","app/**/*.{ts,tsx,js,jsx,html,css}","components/**/*.{ts,tsx,js,jsx,html,css}","pages/**/*.{ts,tsx,js,jsx,html,css}","styles/**/*.css","public/**/*.html"]
tags	["community","modern-web","browser-compatibility","baseline","midstream"]
severity	minor
inputContext	["diff"]
outputKind	["findings","actions"]
modelHint	balanced

Goal / 目的

• 新しい Web API / CSS プロパティを差分で導入したときに、Baseline 状態 (Newly available / Widely available / Limited availability) とブラウザサポートを確認する起点を示す。
• progressive enhancement / feature detection / graceful degradation の有無を suggestion で問いかける。
• ブラウザサポート方針が repo に明文化されているなら、その方針との整合を優先する。

Non-goals / 扱わないこと

• 完全な caniuse データの代替（実際のサポート % は MDN / web-features を参照する起点として扱う）。
• polyfill 推奨そのもの（重い polyfill 追加は別レビュー / 別議論）。
• ブラウザサポート対象範囲のチーム合意形成（人間レビューへ）。

False-positive guards / 抑制条件

• repo に「Modern browsers only」「Evergreen browser support」等の明示があるなら、Widely available 級の API は指摘しない。
• transpiler / bundler (Babel / SWC) が target ブラウザを設定している場合、JS 構文系は対象外（CSS / Web API は別問題）。
• 既に @supports / if ('xxx' in window) / try-catch 等の feature detection が含まれている差分は指摘しない。
• progressive enhancement の fallback がコメント・docs で明示されている場合は指摘しない。

Rule / ルール

Baseline 状態の確認

• Newly available (緑、新規): 過去 30 ヶ月未満で全モダンブラウザに到達した機能。利用は OK だが、Safari 旧バージョン / IE 互換要件があれば fallback を確認。
• Widely available (青、安定): 30 ヶ月以上経過し全モダンブラウザで安定。基本的に suggestion なし。
• Limited availability (赤、未到達): 一部ブラウザで未実装 / experimental flag 越し。必ず fallback / feature detection を提案する。

JavaScript / Web API

• Object.hasOwn / Array.prototype.findLast / structuredClone / Promise.any などの比較的新しい API は MDN / Baseline status の確認を促す。
• URL.parse (static) / Set.prototype.intersection / iterator helper (map / filter on iterator) などの Limited availability 級は feature detection を提案する。
• Service Worker / Web Workers / Push API のような環境依存 API は graceful degradation を促す。

CSS

• :has() / @container / subgrid / text-wrap: balance / view-transition-name などの新 CSS は Baseline 確認を促す。
• color-mix() / oklch() / light-dark() / Anchor Positioning などの 2024 級は @supports fallback の検討を提案する。
• Container Queries は Baseline Widely available 寄りだが、初期に書いたコードが古いブラウザ起動を含むかは確認する。

HTML